System.SetString
Delphi
procedure SetString(var S: String; Buffer: PChar; Length: Integer);
Inhaltsverzeichnis
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| procedure | public | System.pas | System | System |
Beschreibung
Setzt den Inhalt und die Länge eines Strings.
In Delphi setzt SetString den Inhalt und die Länge der angegebenen String-Variable auf den in den Parametern Buffer und Length übergebenen Zeichenblock.
Bei einem kurzen String ändert SetString das Längenbyte (das Zeichen an der Position S[0]) in den mit Length angegebenen Wert. Hat der Parameter Buffer einen Wert ungleich nil, werden anschließend beginnend mit S[1] die in Length angegebenen Zeichen von Buffer in den String kopiert. Mit Length können bei kurzen Strings Werte zwischen 0 und 255 angegeben werden.
Bei einem langen String weist SetString der Variablen S den neu reservierten String der angegebenen Länge zu. Hat der Parameter Buffer einen Wert ungleich nil, werden anschließend die in Length angegebenen Zeichen von Buffer in den String kopiert. Andernfalls wird der Inhalt des neuen Strings nicht initialisiert. Ist nicht genug Speicher für den String vorhanden, wird eine EOutOfMemory-Exception ausgelöst. Nach einem Aufruf von SetString ist sichergestellt, dass S auf einen eindeutigen String verweist, dessen Referenzzähler den Wert Eins enthält.