System.AnsiStringBase.SetLength
C++
AnsiStringBase& SetLength(int newLength, int codePage);
Eigenschaften
Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
---|---|---|---|---|
function | public | dstring.h | System | AnsiStringBase |
Beschreibung
Ändert die Länge von AnsiStringBase.
SetLength ändert die Länge des Strings in die mit newLength angegebene Länge und verkürzt den String bei Bedarf.
SetLength ordnet das zugrunde liegende Zeichen-Array, in dem der Wert von AnsiStringBase 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 AnsiStringBase-String vorhanden, wird eine EOutOfMemory-Exception ausgelöst. Nach dem Aufruf von SetLength ist AnsiStringBase keine gemeinsam genutzte Referenz.
SetLength gibt das modifizierte AnsiStringBase-Objekt (*this) zurück.