Character and string types/fr: what changed

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

Old	New		Line
1	1		Free Pascal supportes plusieurs types de[[Char/fr\|caractères]] et de [[String/fr\|chaîne de caractères]]. Il s'étendent du simple caractère ANSI aux chaînes Unicode et incluent aussi les types pointer. Les différence s'appliquent aussi aux encodages et au comptage de référence.
2	2
3		-	~~## Contents~~
4		-
5		-	* 1 AnsiChar
6		-	* 1.1 Référence
7		-	* 2 WideChar
8		-	* 2.1 Références
9		-	* 3 Tableau de Char
10		-	* 3.1 Tableau de Char statique
11		-	* 3.2 Tableau de Char dynamique
12		-	* 4 PChar
13		-	* 4.1 Référence
14		-	* 5 PWideChar
15		-	* 5.1 Référence
16		-	* 6 String
17		-	* 6.1 Référence
18		-	* 7 ShortString
19		-	* 7.1 Référence
20		-	* 8 AnsiString
21		-	* 8.1 Référence
22		-	* 9 UnicodeString
23		-	* 9.1 Référence
24		-	* 10 UTF8String
25		-	* 10.1 Référence
26		-	* 11 UTF16String
27		-	* 11.1 Référence
28		-	* 12 WideString
29		-	* 12.1 Référence
30		-	* 13 PShortString
31		-	* 13.1 Référence
32		-	* 14 PAnsiString
33		-	* 14.1 Référence
34		-	* 15 PUnicodeString
35		-	* 15.1 Référence
36		-	* 16 PWideString
37		-	* 16.1 Référence
38		-	* 17 Constantes String
39		-	* 18 Voir aussi
40		-
41	3		## AnsiChar
42	4
43	5		Une variable de type AnsiChar , aussi mentionnée comme [[Character and string types/fr\|Char]] , a une taille d'exactement un octet et contient un caractère ANSI.
44	6
45	7		a
46	8		---
47	9
48	10		#### Référence
49	11
50	12		* [Documentation FPC sur les AnsiChar](<http://www.freepascal.org/docs-html/ref/refsu7.html>)
51	13		* [[Char/fr\|Usage de Char]]
52	14
53	15		## WideChar
54	16
55	17		Une variable du type WideChar , aussi mentionnée commeUnicodeChar , est exactement d'une taille de 2 octets, et contient une partie des caractères [[LCL Unicode Support/fr\|Unicode]] dans l'encodage UTF-16. Note : il est impossible d'encodes tous les points de code Unicode dans 2 octets. En conséquence, 2 WideChars pourraient être nécessaires pour encoder un simple point de code.
56	18
57	19		\| a
58	20		---\|---
59	21
60	22		#### Références
61	23
62	24		* [Documentation FPC sur les WideChar](<http://www.freepascal.org/docs-html/ref/refsu8.html>)
63	25		* [Information sur l'UTF-16 dans Wikipedia](<https://fr.wikipedia.org/wiki/UTF-16>)
64	26		* [Documentation sur RTL UnicodeChar](<http://lazarus-ccr.sourceforge.net/docs/rtl/system/unicodechar.html> "doc:rtl/system/unicodechar.html")
65	27
66	28		## Tableau de Char
67	29
68	30		Les premières implémentations de Pascal, utilisées avant 1978, ne supportaient pas le type chaîne (exception faite des constantes chaînes). La seule possibilité pour stocker des chaînes dans des variables consistaient à utiliser des tableaux de char. Cette approche a de nombreux inconvénients et n'est plus recommandée. C'est néanmoins toujours supporté pour assurer la compatibilité descendante avec l'ancien code.
69	31
70	32		### Tableau de Char statique
71	33		```
72	34		type
73	35		TOldString4 = array[0..3] of char;
74	36		var
75	37		aOldString4: TOldString4;
76	38		begin
77	39		aOldString4[0] := 'a';
78	40		aOldString4[1] := 'b';
79	41		aOldString4[2] := 'c';
80	42		aOldString4[3] := 'd';
81	43		end;
82	44		```
83	45
84	46		Le tableau de char statique contient dorénavant:
85	47
86	48		a \| b \| c \| d
87	49		---\|---\|---\|---
88	50
89	51		![Light bulb](https://upload.wikimedia.org/wikipedia/commons/d/d8/Nuvola_apps_ktip.png) Remarque: Les chars non affectés contiennent n'importe quoi, en fonction de ce qui se trouvait en mémoire quand la mémoire pour le tableau est devenue disponible (le contenu du tableau n'est pas initialisé).
90	52
91	53		### Tableau de Char dynamique
92	54		```
93	55		var
94	56		aOldString: Array of Char; // pas de dimension!!
95	57		begin
96	58		SetLength(aOldString, 5);
97	59		aOldString[0] := 'a';
98	60		aOldString[1] := 'b';
99	61		aOldString[2] := 'c';
100	62		aOldString[3] := 'd';
101	63		end;
102	64		```
103	65
104	66		Le tableau de char dynamique contient dorénavant:
105	67
106	68		a \| b \| c \| d \| #0
107	69		---\|---\|---\|---\|---
108	70
109	71		![Light bulb](https://upload.wikimedia.org/wikipedia/commons/d/d8/Nuvola_apps_ktip.png) Remarque: Les chars non affectés dans les tableaux dynamiques contiennent des #0, parce que les positions vides de tous les tableaux dynamiques sont dès le départ initialisées avec 0 (ou #0, ou nil, ou ...)
110	72
111	73		## PChar
112	74
113	75		Une variable de type PChar est simplement un pointeur vers un type Char , mais permet des opérations supplémentaires. Les PChars peuvent être utilisé pour accéder à des [chaînes C à zéro terminal](<http://en.wikipedia.org/wiki/Null-terminated_string>), par exemple en interaction avec certaines API systèmes ou des logiciels tierce partie.
114	76
115	77		a \| b \| c \| #0
116	78		---\|---\|---\|---
117	79		^
118	80
119	81		#### Référence
120	82
121	83		* [Documentation FPC sur les PChar](<http://www.freepascal.org/docs-html/ref/refsu16.html>)
122	84		* [Fonctions associées à PChar](<http://lazarus-ccr.sourceforge.net/docs/rtl/sysutils/pcharfunctions.html> "doc:rtl/sysutils/pcharfunctions.html")
123	85
124	86		## PWideChar
125	87
126	88		Une variable de type PWideChar est un pointeur vers une variable [[Character and string types/fr\|WideChar]].
127	89
128	90		\| a \| \| b \| \| c \| #0 \| #0
129	91		---\|---\|---\|---\|---\|---\|---\|---
130	92		^
131	93
132	94		#### Référence
133	95
134	96		* [Documentation sur RTL PWideChar](<http://lazarus-ccr.sourceforge.net/docs/rtl/system/pwidechar.html> "doc:rtl/system/pwidechar.html")
135	97
136	98		## String
137	99
138		-	Le type String'_peut faire référence à_ _ShortStringouAnsiString, selon la[bascule {$H}](<http://www.freepascal.org/docs-html/prog/progsu25.html#x32-310001.2.25>). Si la bascule est off ({$H-}) alors toute déclaration string va définir une ShortString. Sa taille sera de 255 caractères, si elle n'est pas spécifiée autrement. Si la bascule est on ({$H+}) stringsans spécifier la taille va définir une AnsiString, sinon une ShortStringavec une taille spécifiée. Dans le mode delphiunicode** String_ est UnicodeString**.
	100	+	Le type String'_peut faire référence à_ _ShortStringouAnsiString, selon la[bascule {$H}](<http://www.freepascal.org/docs-html/prog/progsu25.html#x32-310001.2.25>). Si la bascule est off ({$H-}) alors toute déclaration string va définir une ShortString. Sa taille sera de 255 caractères, si elle n'est pas spécifiée autrement. Si la bascule est on ({$H+}) stringsans spécifier la taille va définir une AnsiString, sinon une ShortStringavec une taille spécifiée. Dans le mode delphiunicodeString_ est UnicodeString.
139	101
140	102		#### Référence
141	103
142	104		* [[String/fr\|Usage des String]]
143	105		* [Fonctions sur les chaînes](<http://lazarus-ccr.sourceforge.net/docs/rtl/sysutils/stringfunctions.html> "doc:rtl/sysutils/stringfunctions.html")
144	106		* [Référence sur l'unité 'strutils': Procédures et fonctions](<http://lazarus-ccr.sourceforge.net/docs/rtl/strutils/index-5.html> "doc:rtl/strutils/index-5.html")
145	107
146	108		## ShortString
147	109
148	110		Les chaînes courtes ont une taille maximale de 255 caractères avec la [[FPC Unicode support\|page de code]] CP_ACP implicite. La longueur effective de la chaîne est conservée dans le caractère à l'index 0.
149	111
150	112		#3 \| a \| b \| c
151	113		---\|---\|---\|---
152	114
153	115		#### Référence
154	116
155	117		* [Documentation FPC sur ShortString](<http://www.freepascal.org/docs-html/ref/refsu11.html#x34-370003.2.5>)
156	118
157	119		## AnsiString
158	120
159	121		Les Ansistrings ou les UTF8Strings sont des chaînes qui n'ont pas de limite de taille. Le [comptage de référence](<http://en.wikipedia.org/wiki/Reference_counting>) s'applique à elle et il est garanti qu'elles soient à [zéro terminal](<http://en.wikipedia.org/wiki/Null-terminated_string>). En interne, une variable de type AnsiString est traitée comme un pointeur: le contenu réel de la chaîne se trouve dans le tas, la mémoire nécessaire à son contenu étant allouée.
160	122
161	123		\| \| \| \| \| \| \| \| a \| b \| c \| #0
162	124		---\|---\|---\|---\|---\|---\|---\|---\|---\|---\|---\|---
163	125		RefCount \| Length
164	126
165	127		#### Référence
166	128
167	129		* [Documentation FPC sur les AnsiString](<http://www.freepascal.org/docs-html/ref/refsu12.html>)
168	130
169	131		## UnicodeString
170	132
171	133		Telles les AnsiStrings , UnicodeStrings sont sujette au comptage de référence, sont des tableau à zéro terminal, mais elles sont implémentées comme des tableaux de WideChars au lieu de Chars ordinaires.
172	134
173	135		![Light bulb](https://upload.wikimedia.org/wikipedia/commons/d/d8/Nuvola_apps_ktip.png) Remarque: L'appelation UnicodeString est un peu ambiguë mais provient sans doute de son emploi dans Delphi sur Windows, où le système d'exploitation utilise l'encodage UTF-16 ; ce n'est pas le seul type de chaîne qui permet de contenir des données Unicode (voir aussi UTF8String)...
174	136
175	137		\| \| \| \| \| \| \| \| \| a \| \| b \| \| c \| #0 \| #0
176	138		---\|---\|---\|---\|---\|---\|---\|---\|---\|---\|---\|---\|---\|---\|---\|---
177	139		RefCount \| Length
178	140
179	141		#### Référence
180	142
181	143		* [Documentation FPC sur UnicodeString](<http://www.freepascal.org/docs-html/ref/refsu13.html>)
182	144
183	145		## UTF8String
184	146
185	147		Actuellement, le type UTF8String est un alias sur le type AnsiString. Il est destiné à contenir des chaînes encodées en UTF-8 (i.e. des données Unicode) allant de 1 à 4 octets par caractère. UTF8String est le type par défaut dans Lazarus et la LCL. UTF8String est le type de chaîne par défaut dans Lazarus et la LCL.
186	148
187	149		#### Référence
188	150
189	151		* [Documentation sur RTL UTF8String](<http://lazarus-ccr.sourceforge.net/docs/rtl/system/utf8string.html> "doc:rtl/system/utf8string.html")
190	152
191	153		## UTF16String
192	154
193	155		Le type UTF16String est un alias sur le type WideString. Dans l'unité LCL _lclproc_ , c'est un alias sur UnicodeString.
194	156
195	157		#### Référence
196	158
197	159		* [Documentation sur LCL UTF16String](<http://lazarus-ccr.sourceforge.net/docs/lcl/lclproc/utf16string.html> "doc:lcl/lclproc/utf16string.html")
198	160
199	161		## WideString
200	162
201	163		Les variables du type [[Widestrings/fr\|WideString]] (utilisées pour représenter les chaînes de caractères Unicode dans les applications COM) ressemblent à celle du type UnicodeString , mais contrairement à elles, elles ne bénéficient pas du comptage de références. Dans Windows, elles sont allouées une fonction spéciale de Windows qui leur permet d'être utilisées dans OLE Automation.
202	164
203	165		Les WideStrings consistent en octets encodés UTF-16 comppatible COM sur les machines Windows (UCS2 sur Windows 2000) et elles sont encodées en UTF-16 pur sur Linux, Mac OS et iOS.
204	166
205	167		\| \| \| \| \| a \| \| b \| \| c \| #0 \| #0
206	168		---\|---\|---\|---\|---\|---\|---\|---\|---\|---\|---\|---
207	169		Length
208	170
209	171		#### Référence
210	172
211	173		* [Documentation FPC sur WideString](<http://www.freepascal.org/docs-html/ref/refsu14.html#x37-400003.2.8>)
212	174
213	175		## PShortString
214	176
215	177		Une variable du type PShortString est un pointeur qui désigne le premier octet d'une variable de type ShortString (lequel définit la longueur de la ShortString).
216	178
217	179		#3 \| a \| b \| c
218	180		---\|---\|---\|---
219	181		^
220	182
221	183		#### Référence
222	184
223	185		* [Documentation RTL sur PShortString](<http://lazarus-ccr.sourceforge.net/docs/rtl/system/pshortstring.html> "doc:rtl/system/pshortstring.html")
224	186
225	187		## PAnsiString
226	188
227	189		Les variables de type PAnsiString sont des pointeurs sur des variables de type AnsiString. Néanmoins, contrairement aux variables de type PShortString , ils ne pointent pas sur le premier octet d'un en-tête mais sur le premier char de l'AnsiString.
228	190
229	191		\| \| \| \| \| \| \| \| a \| b \| c \| #0
230	192		---\|---\|---\|---\|---\|---\|---\|---\|---\|---\|---\|---
231	193		RefCount \| Length \| ^
232	194
233	195		#### Référence
234	196
235	197		* [Documentation RTL sur PAnsiString](<http://lazarus-ccr.sourceforge.net/docs/rtl/system/pansistring.html> "doc:rtl/system/pansistring.html")
236	198
237	199		## PUnicodeString
238	200
239	201		Les variables de type PUnicodeString sont des pointeurs vers les variables de type UnicodeString.
240	202
241	203		\| \| \| \| \| \| \| \| \| a \| \| b \| \| c \| #0 \| #0
242	204		---\|---\|---\|---\|---\|---\|---\|---\|---\|---\|---\|---\|---\|---\|---\|---
243	205		RefCount \| Length \| ^
244	206
245	207		#### Référence
246	208
247	209		* [Documentation RTL sur PUnicodeString](<http://lazarus-ccr.sourceforge.net/docs/rtl/system/punicodestring.html> "doc:rtl/system/punicodestring.html")
248	210
249	211		## PWideString
250	212
251	213		Les variables du type PWideString sont des pointeurs. Elles pointent sur le premier caractère d'une variable de type WideString.
252	214
253	215		\| \| \| \| \| a \| \| b \| \| c \| #0 \| #0
254	216		---\|---\|---\|---\|---\|---\|---\|---\|---\|---\|---\|---
255	217		Length \| ^
256	218
257	219		#### Référence
258	220
259	221		* [Documentation RTL sur PWideString](<http://lazarus-ccr.sourceforge.net/docs/rtl/system/pwidestring.html> "doc:rtl/system/pwidestring.html")
260	222
261	223		## Constantes String
262	224
263	225		Si vous utilisez des constantes an Anglais, vos chaînes fonctionnent de la même façon avec tous les types, sur toutes les plateformes et toutes les versions du compilateur. Les chaînes 'non anglaises' peuvent eêtre chargées depuis des chaînes de ressource ou depuis des fichiers. Si vous utilisez des chaînes non anglaises dans votre code, vous devriez lire ce qui suit.
264	226
265	227
266	228		There are various encodings for non English strings. By default Lazarus saves Pascal files as UTF-8 without BOM. UTF-8 supports the full Unicode range. That means all string constants are stored in UTF-8. Lazarus also supports to change the encoding of a file to other encoding, for example under Windows your local codepage. The Windows codepage is limited to your current language group.
267	229
268	230		String Type, UTF-8 Source \| With or without {$codepage utf8} \| FPC 2.6.5 and below \| FPC 2.7.1 and above \| FPC 2.7.1+ with UTF8 as default CodePage
269	231		---\|---\|---\|---\|---
270	232		AnAnsiString:='ãü'; \| Without \| Needs UTF8ToAnsi in RTL/WinAPI. Ok in LCL \| Needs UTF8ToAnsi in RTL/WinAPI. Ok in LCL \| Ok in RTL/W-WinAPI/LCL. Needs UTF8ToWinCP in A-WinAPI.
271	233		AnAnsiString:='ãü'; \| With \| System cp ok in RTL/WinAPI. Needs SysToUTF8 in LCL \| Ok in RTL/WinAPI/LCL. Mixing with other strings converts to system cp \| Ok in RTL/W-WinAPI/LCL. Needs UTF8ToWinCP in A-WinAPI
272	234		AnUnicodeString:='ãü'; \| Without \| Wrong everywhere \| Wrong everywhere \| Wrong everywhere
273	235		AnUnicodeString:='ãü'; \| With \| System cp ok in RTL/WinAPI. Needs UTF8Encode in LCL \| Ok in RTL/WinAPI/LCL. Mixing with other strings converts to system cp \| Ok in RTL/W-WinAPI/LCL. Needs UTF8ToWinCP in A-WinAPI
274	236		AnUTF8String:='ãü'; \| Without \| Same as AnsiString \| Wrong everywhere \| Wrong everywhere
275	237		AnUTF8String:='ãü'; \| With \| Same as AnsiString \| Ok in RTL/WinAPI/LCL. Mixing with other strings converts to system cp \| Ok in RTL/W-WinAPI/LCL. Needs UTF8ToWinCP in A-WinAPI.
276	238
277	239		* W-WinAPI = Windows API "W" functions, UTF-16
278	240		* A-WinAPI = Windows API non "W" functions, 8bit system code page
279	241		* System CP = The 8bit system code page of the OS. For example code page [1252](<http://en.wikipedia.org/wiki/Windows-1252>).
280	242
281	243		```
282	244		const
283	245		c='ãü';
284	246		cstring: string = 'ãü'; // see AnAnsiString:='ãü';
285	247		var
286	248		s: string;
287	249		u: UnicodeString;
288	250		begin
289	251		s:=c; // same as s:='ãü';
290	252		s:=cstring; // does not change encoding
291	253		u:=c; // same as u:='ãü';
292	254		u:=cstring; // fpc 2.6.1: converts from system cp to UTF-16, fpc 2.7.1+: depends on encoding of cstring
293	255		end;
294	256		```
295	257
296	258		## Voir aussi
297	259
298	260		* [[FPC Unicode support/fr\|Support de l'Unicode par FPC]]
299	261		* [[LCL Unicode Support/fr\|Support de l'Unicode par la LCL]]
300	262		* [[TStringList-TStrings Tutorial/fr\|Tutoriel TStringList-TStrings]]
301	263		* [A Brief History of Strings](<http://www.codexterity.com/delphistrings.htm>)
302	264
303	265		---
304	266		From the Free Pascal wiki, page "Character and string types/fr", as the Internet Archive kept it on 2024-09-08, last changed on 2020-02-11. 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