System.SetString
Delphi
procedure SetString(var S: String; Buffer: PChar; Length: Integer);
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
| procedure | public | System.pas | System | System |
Description
Définit le contenu et la taille d'une chaîne donnée.
Dans le code Delphi, SetString définit le contenu et la taille d'une variable chaîne donnée avec le bloc de caractères donné par les paramètres Buffer et Length.
Pour une variable chaîne courte, SetString définit le caractère indiquant la taille (le caractère se trouvant à S[0]) avec la valeur donnée par Length. Si le paramètre Buffer est différent de nil, Length caractères de Buffer sont copiés en commençant à S[1]. Pour une variable chaîne courte, le paramètre Length doit être compris entre 0 et 255.
Pour une variable chaîne longue, SetString définit S pour référencer une chaîne nouvellement allouée ayant la taille donnée. Si le paramètre Buffer est différent de nil, SetString copie alors Length caractères de Buffer dans la chaîne ; sinon, le contenu de la nouvelle chaîne est non initialisé. S'il n'y a pas de mémoire suffisante pour créer la chaîne, une exception EOutOfMemory est provoquée. Après un appel à SetString, S est certain de référencer une chaîne unique, c'est-à-dire une chaîne avec un compteur de référence à 1.