System.AnsiStringBase.SetLength

De RAD Studio API Documentation
Aller à : navigation, rechercher

C++

AnsiStringBase&  SetLength(int newLength, int codePage);

Propriétés

Type Visibilité  Source Unité  Parent
function public dstring.h System AnsiStringBase

Description

Change la longueur de la chaîne AnsiStringBase.

SetLength change la longueur de la chaîne 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 AnsiStringBase. 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 AnsiStringBase, une exception EOutOfMemory est déclenchée. Après un appel à SetLength, la chaîne AnsiStringBase n'est pas forcément une référence partagée.

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