System.WideString.SetLength
C++
void SetLength(int newLength);
Propriétés
Type | Visibilité | Source | Unité | Parent |
---|---|---|---|---|
function | public | wstring.h | System | WideString |
Description
Change la longueur de la chaîne WideString.
SetLength change la longueur de la chaîne WideString en newLength, en la tronquant si nécessaire.
SetLength réalloue le tableau de caractères sous-jacent stockant la valeur de la chaîne WideString. 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éattribuer la chaîne WideString, une exception EOutOfMemory est déclenchée. Après un appel à SetLength, la chaîne WideString est assurée de faire référence à une chaîne unique — c'est-à-dire une chaîne avec un compteur de référence de un.