System.UnicodeString.SetLength

De RAD Studio API Documentation
Aller à : navigation, rechercher

C++

UnicodeString&  SetLength(int newLength);

Propriétés

Type Visibilité  Source Unité  Parent
function public ustring.h System UnicodeString

Description

Change la longueur en caractères de l'instance de UnicodeString.

SetLength change la longueur en caractères de la chaîne sur newLength, en la tronquant si nécessaire.

SetLength réalloue le tableau de caractères sous-jacent qui stocke la valeur de l'instance de UnicodeString. Les caractères existants dans la chaîne sont préservés, mais le contenu de l'espace nouvellement alloué n'est pas défini. Si la mémoire est insuffisante pour réallouer l'instance de UnicodeString, une exception EOutOfMemory est déclenchée. Après un appel à SetLength, l'instance de UnicodeString est garantie de ne pas être une référence partagée.

SetLength renvoie l'objet UnicodeString modifié (*this).