System.WideString.SetLength
C++
void SetLength(int newLength);
Eigenschaften
Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
---|---|---|---|---|
function | public | wstring.h | System | WideString |
Beschreibung
Ändert die Länge von WideString.
SetLength ändert die Länge von WideString in die mit newLength angegebene Länge und verkürzt den String dabei bei Bedarf.
SetLength ordnet das zugrunde liegende Zeichen-Array, in dem der Wert des WideString gespeichert wird, neu zu. Dabei bleiben die im String vorhandenen Zeichen erhalten, jedoch ist der Inhalt des neu zugewiesenen Speicherbereichs nicht definiert. Ist nicht genug Speicher für den neu zugewiesenen WideString vorhanden, wird eine EOutOfMemory-Exception ausgelöst. Nach einem Aufruf von SetLength ist sichergestellt, dass WideString auf einen eindeutigen String verweist, dessen Referenzzähler den Wert Eins enthält.