Character and string types/ru: what changed

Revision 2 to 3. Removed lines have a minus sign; added lines have a plus sign.

Old	New		Line
1	1		Free Pascal поддерживает несколько [[Char\|символьных]] и [[String\|строковых]] типов, от одиночных символов ANSI до юникодных строк, включая указатели. Различия также касаются кодировок и подсчёта ссылок.
2	2
3	3		## AnsiChar
4	4
5	5		Переменная типа AnsiChar, называемого также [[Char]], имеет размер ровно 1 байт и содержит один символ ANSI.
6	6
7	7		\| \|
8	8		\|-----\|
9	9		\| a \|
10	10
11	11		#### Ссылки
12	12
13	13		- [AnsiChar в документации FPC](http://www.freepascal.org/docs-html/ref/refsu6.html)
14	14		- [[Char\|Использование Char]]
15	15
16	16		## WideChar
17	17
18	18		Переменная типа WideChar, называемого также UnicodeChar, имеет размер ровно 2 байта и обычно содержит одну [[LCL Unicode Support/ru\|юникодную]] кодовую точку (обычно один символ) в кодировке UTF-16. Примечание: все юникодные кодовые точки закодировать 2-я байтами невозможно. Поэтому для представления одной кодовой точки может потребоваться пара WideChar.
19	19
20	20		\| \| \|
21	21		\|-----\|-----\|
22	22		\| \| a \|
23	23
24	24		#### Ссылки
25	25
26	26		- [WideChar в документации FPC](http://www.freepascal.org/docs-html/ref/refsu7.html)
27	27		- [Сведения об UTF-16 в Wikipedia](http://ru.wikipedia.org/wiki/UTF-16)
28	28		- [[doc:rtl/system/unicodechar.html\|UnicodeChar в документации RTL]]
29	29
30	30		## Символьный массив
31	31
32	32		Ранние реализации языка Паскаль, использовавшиеся до 1978 года, не поддерживали строковый тип (за исключением строковых констант). Единственной возможностью сохранять строки в переменных было использование массивов символов. Этот подход имеет множество недостатков и более не рекомендуется. Тем не менее, он по-прежнему поддерживается для обеспечения обратной совместимости с устаревшим кодом.
33	33
34	34		### Статический символьный массив
35	35
36	36		``` pascal
37	37		type
38	38		TOldString4 = array [0..3] of Char;
39	39		var
40	40		aOldString4: TOldString4;
41	41		begin
42	42		aOldString4[0] := 'a';
43	43		aOldString4[1] := 'b';
44	44		aOldString4[2] := 'c';
45	45		aOldString4[3] := 'd';
46	46		end;
47	47		```
48	48
49	49		Статический символьный массив теперь содержит:
50	50
51	51		\| \| \| \| \|
52	52		\|-----\|-----\|-----\|-----\|
53	53		\| a \| b \| c \| d \|
54	54
55	55		> Note: Неинициализированные символы могут иметь любые значения, которые зависят от содержимого памяти при её выделении под массив.
56	56
57	57		### Динамический символьный массив
58	58
59	59		``` pascal
60	60		var
61	61		aOldString: Array of Char;
62	62		begin
63	63		SetLength(aOldString, 5);
64	64		aOldString[0] := 'a';
65	65		aOldString[1] := 'b';
66	66		aOldString[2] := 'c';
67	67		aOldString[3] := 'd';
68	68		end;
69	69		```
70	70
71	71		Динамический символьный массив теперь содержит:
72	72
73	73		\| \| \| \| \| \|
74	74		\|-----\|-----\|-----\|-----\|-----\|
75	75		\| a \| b \| c \| d \| \#0 \|
76	76
77	77		> Note: Неинициализированные символы динамического массива содержат \#0, поскольку содержимое динамического массива изначально инициализируется 0 (или \#0, или nil, или ...)
78	78
79	79		## PChar
80	80
81	81		Переменные типа [[PChar]] являются указателями на Char, а также позволяют дополнительные действия. Они могут быть использованы для доступа к [нуль-терминированным строкам](http://ru.wikipedia.org/wiki/Нуль-терминированная_строка) в стиле C, например, для взаимодействия с библиотеками ОС или сторонними программами.
82	82
83	83		\| \| \| \| \|
84	84		\|-----\|-----\|-----\|-----\|
85	85		\| a \| b \| c \| \#0 \|
86	86		\| ^ \| \| \| \|
87	87
88	88		#### Ссылки
89	89
90	90		- [PChar в документации FPC](http://www.freepascal.org/docs-html/ref/refsu12.html)
91	91		- [[doc:rtl/sysutils/pcharfunctions.html\|Функции для PChar]]
92	92
93	93		## PWideChar
94	94
95	95		Переменная типа PWideChar является указателем на WideChar.
96	96
97	97		\| \| \| \| \| \| \| \| \|
98	98		\|-----\|-----\|-----\|-----\|-----\|-----\|-----\|-----\|
99	99		\| \| a \| \| b \| \| c \| \#0 \| \#0 \|
100	100		\| ^ \| \| \| \| \| \| \| \|
101	101
102	102		#### Ссылки
103	103
104	104		- [[doc:rtl/system/pwidechar.html\|PWideChar в документации RTL]]
105	105
106	106		## String
107	107
108	108		Тип String может означать ShortString или AnsiString, в зависимости от [опции {\$H}](http://www.freepascal.org/docs-html/prog/progsu25.html#x32-310001.2.25). Когда опция выключена ({\$H-}), String означает ShortString (короткая строка). Если не указано иное, её размер 255 символов. Когда опция включена ({\$H+}), String без указания длины означает AnsiString, в противном случае -- ShortString заданной длины. В режиме {\$mode DelphiUnicode} String означает UnicodeString.
109	109
110	110		#### Ссылки
111	111
112	112		- [[String\|Использование String]]
113	113		- [[doc:rtl/sysutils/stringfunctions.html\|Строковые функции]]
114	114		- [[doc:rtl/strutils/index-5.html\|Справка по модулю 'strutils': Процедуры и функции]]
115	115
116	116		## ShortString
117	117
118	118		Максимальная длина коротких строк не превышает 255 символов в [[FPC Unicode support\|кодовой странице]] CP_ACP. Длина хранится в символе с индексом 0.
119	119
120	120		\| \| \| \| \|
121	121		\|-----\|-----\|-----\|-----\|
122	122		\| \#3 \| a \| b \| c \|
123	123
124	124		#### Ссылки
125	125
126	126		- [[doc:ref/refsu12.html\|AnsiString в документации FPC]]
127	127
128	128		## AnsiString
129	129
130	130		AnsiString является строкой без ограничения длины, с [подсчётом ссылок](http://ru.wikipedia.org/wiki/Подсчёт_ссылок) и гарантированно [нуль-терминирована](http://ru.wikipedia.org/wiki/Нуль-терминированная_строка). Переменная типа AnsiString устроена как указатель -- фактическое содержимое строки хранится в куче, памяти выделяется по объёму содержимого.
131	131
132		-	~~<tbody>~~
133		-
134		-	~~</tbody>~~
	132	+	\| \| \| \| \| \| \| \| \| a \| b \| c \| #0 \|
	133	+	\|---\|---\|---\|---\|---\|---\|---\|---\|---\|---\|---\|---\|
	134	+	\| RefCount \| \| \| \| Length \| \| \| \| \| \| \| \|
135	135
136	136		#### Ссылки
137	137
138	138		- [AnsiString в документации FPC](http://www.freepascal.org/docs-html/ref/refsu12.html)
139	139
140	140		## UnicodeString
141	141
142	142		UnicodeStrings как и AnsiStrings использует подсчет ссылок и завершение нулём, но реализованы как массивы из WideChar, а не обычных Char.
143	143
144	144		> Note: Вероятно, название UnicodeString двусмысленно из-за его применения в Delphi для Windows, использующей кодировку UTF-16; но это не единственный строковый тип, способный хранить юникодные строки (см. также UTF8String)...
145	145
146		-	~~<tbody>~~
147		-
148		-	~~</tbody>~~
	146	+	\| \| \| \| \| \| \| \| \| \| a \| \| b \| \| c \| #0 \| #0 \|
	147	+	\|---\|---\|---\|---\|---\|---\|---\|---\|---\|---\|---\|---\|---\|---\|---\|---\|
	148	+	\| RefCount \| \| \| \| Length \| \| \| \| \| \| \| \| \| \| \| \|
149	149
150	150		#### Ссылки
151	151
152	152		- [UnicodeString в документации FPC](http://www.freepascal.org/docs-html/ref/refsu13.html)
153	153
154	154		## UTF8String
155	155
156	156		В FPC 2.6.5 и ранее тип UTF8String был псевдонимом AnsiString. В FPC 2.7.1 и далее он определён как
157	157
158	158		``` pascal
159	159		UTF8String = type AnsiString(CP_UTF8);
160	160		```
161	161
162	162		Он предназначен для хранения строк в UTF-8 (в юникоде), от 1 до 4 байт на символ. Заметьте, String тоже может содержать символы в кодировке UTF-8.
163	163
164	164		#### Ссылки
165	165
166	166		- [[doc:rtl/system/utf8string.html\|UTF8String в документации RTL]]
167	167
168	168		## UTF16String
169	169
170	170		Тип UTF16String является псевдонимом типа WideString. В модуле LCL lclproc это псевдоним для UnicodeString.
171	171
172	172		#### Ссылки
173	173
174	174		- [[doc:lcl/lclproc/utf16string.html\|UTF16String в документации LCL]]
175	175
176	176		## WideString
177	177
178	178		Тип [[Widestrings\|WideString]] (используется для представления юникодных строк в приложениях COM) похож на UnicodeString, но в отличие от него не использует подсчёт ссылок. Под Windows переменные этого типа распределяются специальными функциями системы, что позволяет использовать из для автоматизации OLE.
179	179
180	180		Широкие строки под Windows состоят из совместимых с COM и закодированных в UTF-16 (UCS2 под Windows 2000) байт, под Linux, Mac OS X и iOS они кодируются в обычный UTF-16.
181	181
182		-	~~<tbody>~~
183		-
184		-	~~</tbody>~~
	182	+	\| \| \| \| \| \| a \| \| b \| \| c \| #0 \| #0 \|
	183	+	\|---\|---\|---\|---\|---\|---\|---\|---\|---\|---\|---\|---\|
	184	+	\| Length \| \| \| \| \| \| \| \| \| \| \| \|
185	185
186	186		#### Ссылки
187	187
188	188		- [WideString в документации FPC](http://www.freepascal.org/docs-html/ref/refsu14.html#x37-400003.2.8)
189	189
190	190		## PShortString
191	191
192	192		Переменная типа PShortString является указателем на первый байт переменной типа ShortString (содержащий длину строки).
193	193
194	194		\| \| \| \| \|
195	195		\|-----\|-----\|-----\|-----\|
196	196		\| \#3 \| a \| b \| c \|
197	197		\| ^ \| \| \| \|
198	198
199	199		#### Ссылки
200	200
201	201		- [[doc:rtl/system/pshortstring.html\|PShortString в документации RTL]]
202	202
203	203		## PAnsiString
204	204
205	205		Переменные типа PAnsiString являются указателями на переменные типа AnsiString. Однако, в отличие от переменных типа PShortString, они указывают не на первый байт заголовка, а на первый символ Char из AnsiString.
206	206
207		-	~~<tbody>~~
208		-
209		-	~~</tbody>~~
	207	+	\| \| \| \| \| \| \| \| \| a \| b \| c \| #0 \|
	208	+	\|---\|---\|---\|---\|---\|---\|---\|---\|---\|---\|---\|---\|
	209	+	\| RefCount \| \| \| \| Length \| \| \| \| ^ \| \| \| \|
210	210
211	211		#### Ссылки
212	212
213	213		- [[doc:rtl/system/pansistring.html\|PAnsiString в документации RTL]]
214	214
215	215		## PUnicodeString
216	216
217	217		Переменные типа PUnicodeString являются указателями на переменные типа UnicodeString.
218	218
219		-	~~<tbody>~~
220		-
221		-	~~</tbody>~~
	219	+	\| \| \| \| \| \| \| \| \| \| a \| \| b \| \| c \| #0 \| #0 \|
	220	+	\|---\|---\|---\|---\|---\|---\|---\|---\|---\|---\|---\|---\|---\|---\|---\|---\|
	221	+	\| RefCount \| \| \| \| Length \| \| \| \| ^ \| \| \| \| \| \| \| \|
222	222
223	223		#### Ссылки
224	224
225	225		- [[doc:rtl/system/punicodestring.html\|PUnicodeString в документации RTL]]
226	226
227	227		## PWideString
228	228
229	229		Переменные типа PWideString являются указателями. Они указывают на первый символ переменной типа WideString.
230	230
231		-	~~<tbody>~~
232		-
233		-	~~</tbody>~~
	231	+	\| \| \| \| \| \| a \| \| b \| \| c \| #0 \| #0 \|
	232	+	\|---\|---\|---\|---\|---\|---\|---\|---\|---\|---\|---\|---\|
	233	+	\| Length \| \| \| \| ^ \| \| \| \| \| \| \| \|
234	234
235	235		#### Ссылки
236	236
237	237		- [[doc:rtl/system/pwidestring.html\|PWideString в документации RTL]]
238	238
239	239		## Строковые константы
240	240
241	241		Если вы используете только английские константы, такие строки работают одинаково со всеми типами на всех платформах и на всех версиях компилятора. Неанглийские строки могут быть загружены как ResourceString или из файлов. Если вам нужно использовать неанглийские строки в коде, читайте ниже.
242	242
243	243		Для неанглийских строк существует множество кодировок. По умолчанию Лазарус сохраняет файлы как UTF-8 без [BOM](http://ru.wikipedia.org/wiki/Маркер_последовательности_байтов). Кодировка UTF-8 поддерживает все символы юникода. Это означает, что все строковые константы также сохранены в UTF-8. Лазарус также поддерживает смену кодировки файла, например, под Windows можно сохранить файл в локальной кодировке. Кодировки Windows ограничены вашей текущей языковой группой.
244	244
245	245		\| Строковый тип, исходник в UTF-8 \| С или без {\$codepage utf8} \| FPC 2.6.5 и ниже \| FPC 2.7.1 и выше \| FPC 2.7.1+ с кодовой страницей UTF8 \|
246	246		\|----\|----\|----\|----\|----\|
247	247		\| \\|Без \| Требует UTF8ToAnsi в RTL/WinAPI. Ок в LCL \| Требует UTF8ToAnsi в RTL/WinAPI. Ок в LCL \| Ок в RTL/W-WinAPI/LCL. Требует UTF8ToWinCP в A-WinAPI \| \|
248	248		\| \\|С \| Системная КС в RTL/WinAPI ок. Требует SysToUTF8 в LCL \| Ок в RTL/WinAPI/LCL. Смешение с другими строками преобразует в системную КС \| Ок в RTL/W-WinAPI/LCL. Требует UTF8ToWinCP в A-WinAPI \| \|
249	249		\| \\|Без \| Неверно везде \| Неверно везде \| Неверно везде \| \|
250	250		\| \\|С \| Системная КС в RTL/WinAPI ок. Требует UTF8Encode в LCL \| Ок в RTL/WinAPI/LCL. Смешение с другими строками преобразует в системную КС \| Ок в RTL/W-WinAPI/LCL. Требует UTF8ToWinCP в A-WinAPI \| \|
251	251		\| \\|Без \| Как AnsiString \| Неверно везде \| Неверно везде \| \|
252	252		\| \\|С \| Как AnsiString \| Ок в RTL/WinAPI/LCL. Смешение с другими строками преобразует в системную КС \| Ок в RTL/W-WinAPI/LCL. Требует UTF8ToWinCP в A-WinAPI \| \|
253	253
254	254		- W-WinAPI = функции Windows API с "W", UTF-16
255	255		- A-WinAPI = функции Windows API без "W", 8-битная кодовая страница
256	256		- Системная КС = 8-битная системная кодовая страница ОС. Например, [1251](http://ru.wikipedia.org/wiki/Windows-1251).
257	257
258	258		``` pascal
259	259		const
260	260		c='ãü';
261	261		cstring: string = 'ãü'; // см. AnAnsiString:='ãü';
262	262		var
263	263		s: string;
264	264		u: UnicodeString;
265	265		begin
266	266		s:=c; // то же, что s:='ãü';
267	267		s:=cstring; // не изменяет кодировку
268	268		u:=c; // то же, что u:='ãü';
269	269		u:=cstring; // fpc 2.6.1: преобразует из системной КС в UTF-16,
270	270		// fpc 2.7.1+: зависит от кодировки cstring
271	271		end;
272	272		```
273	273
274	274		## См. также
275	275
276	276		- [[FPC Unicode support/ru\|Поддержка юникода в FPC]]
277	277		- [[LCL Unicode Support/ru\|Поддержка юникода в LCL]]
278	278		- [[TStringList-TStrings Tutorial/ru\|Пособие по TStringList-TStrings]]
279	279		- [Краткая история String](http://www.codexterity.com/delphistrings.htm)
280	280
281	281		---
282	282		From the Free Pascal wiki, page "Character and string types/ru", as it stood on 2020-09-03 after a change by Zoltanleo, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).

Back to history