System.UnicodeString.SetLength

• Übergeordnet: UnicodeString

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.