System.UnicodeString.SetLength

Aus Appmethod Libraries
Wechseln zu: Navigation, Suche

C++

UnicodeString&  SetLength(int newLength);

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
function public ustring.h System UnicodeString

Beschreibung

Ändert die Zeichenlänge von UnicodeString.

SetLength ändert die Zeichenlänge des Strings in die in newLength angegebene Länge und verkürzt den String dabei bei Bedarf.

SetLength ordnet das zugrunde liegende Zeichen-Array, in dem der Wert der UnicodeString-Instanz 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 UnicodeString vorhanden, wird eine EOutOfMemory-Exception ausgelöst. Nach einem Aufruf von SetLength ist die UnicodeString-Instanz garantiert keine gemeinsam genutzte Referenz.

SetLength gibt das modifizierte UnicodeString-Objekt (*this) zurück.