System.Insert

Aus Appmethod Libraries
Wechseln zu: Navigation, Suche

Object Pascal

procedure Insert(Source: <string or dynamic array>; var Dest: <string or dynamic array>; Index: Integer);

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
procedure public System.pas System System


Beschreibung

Fügt einen Teilstring ab der angegebenen Position in einen String ein.

In Object Pascal-Code fügt Insert Substr an der Position Dest[Index] in Dest ein.

Parameter

Name Beschreibung
Substr Der String, der in Dest eingefügt werden soll (siehe unten). Wenn dieser String leer ist, wird Dest nicht verändert.
Dest Der String, der verändert wird.
Index Die Einfügeposition. Wenn dieser Wert kleiner als 1 ist, wird er auf 1 gesetzt. Wenn der Wert das Ende von Dest überschreitet, wird er auf die Länge von Dest gesetzt, und eine Append-Operation durchgeführt.

Hinweis: Dabei handelt es sich um einen Zeichen-Index (nicht um einen Byte-Index). Aber er muss um 2 erhöht werden, damit auch über Surrogatpaar iteriert werden kann (siehe die Unicode-Spezifikation). Beim Durchlaufen oder Zählen der Zeichen in einem Unicode-String werden für ein Surrogatpaar zwei Zeichen angenommen.

Insert löst eine EOutOfMemory-Exception aus, wenn nicht genügend Speicherplatz für den Rückgabe-String zugewiesen werden kann.

Siehe auch

Codebeispiele