System.AnsiStringT.SetLength
C++
AnsiStringT& SetLength(int newLength) {
Propriétés
Type | Visibilité | Source | Unité | Parent |
---|---|---|---|---|
function | public | dstring.h | System | AnsiStringT |
Description
Change la longueur de la chaîne AnsiStringT.
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 AnsiStringT. 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 AnsiStringT, une exception EOutOfMemory est déclenchée. Après un appel à SetLength, la chaîne AnsiStringT n'est pas forcément une référence partagée.
SetLength renvoie l'objet AnsiStringT modifié (*this).