System.Insert
Aus RAD Studio API Documentation
Delphi
procedure Insert(Substr: String; var Dest: String; Index: Integer);
Inhaltsverzeichnis |
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 Delphi-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.