System.SetString

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

procedure SetString(var S: String; Buffer: PChar; Length: Integer);

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.

Siehe auch

Codebeispiele