System.Insert

Delphi-Informationen

von System.pas

	procedure Insert(Substr: string; var Dest: string; Index: Integer);

Unit: System

Typ: Prozedur

Sichtbarkeit: public

Beschreibung

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

In Delphi fügt Insert Source in S an der Position S[Index] ein.

Source ist ein String-Ausdruck. S ist eine String-Variable beliebiger Länge. Index ist ein Integer-Ausdruck. Dabei handelt es sich um einen Zeichen-Index, nicht um einen Byte-Index.

Wenn Index kleiner als 1 ist, wird 1 verwendet. Wenn der Wert von Index das Ende des Strings überschreitet, wird er auf die Länge des Strings gesetzt, und eine Append-Operation durchgeführt.

Wenn der Parameter Source ein leerer String ist, führt Insert nichts aus.

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