System.WideString.SetLength

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

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.

Siehe auch