System.AnsiStringT.SetLength
C++
AnsiStringT& SetLength(int newLength) {
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| function | public | dstring.h | System | AnsiStringT |
Beschreibung
Ändert die Länge von AnsiStringT.
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 AnsiStringT 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 AnsiStringT-String vorhanden, wird eine EOutOfMemory-Exception ausgelöst. Nach dem Aufruf von SetLength ist AnsiStringT keine gemeinsam genutzte Referenz.
SetLength gibt das modifizierte AnsiStringT-Objekt (*this) zurück.