4D Doc Center : Insert string

Home

4D v14.3

Insert string


Insert string ( Quelle ; Einfügen ; Beginn ) -> Funktionsergebnis

Parameter	Typ	Beschreibung
Quelle	String	Text, in den eingefügt wird
Einfügen	String	Einzufügender String
Beginn	Lange Ganzzahl	Beginn des Einfügens
Funktionsergebnis	String	Geänderter Text

Beschreibung

Die Funktion Insert string setzt den Text Einfügen in den Text Quelle ab dem Wert Beginn ein und gibt diesen Text zurück. Der Text Quelle bleibt dabei unverändert. Die Zeichen hinter Beginn werden an das Ende des Textes verschoben.

Ist der Text Einfügen ein leerer Text (""), gibt Insert string den ursprünglichen Text zurück.

Ist der Wert Beginn kleiner oder gleich 0, wird der Text Einfügen am Anfang des Textes Quelle eingefügt. Ist der Wert Beginn größer oder gleich der Länge des Textes Quelle, wird der Text Einfügen am Ende des Textes Quelle eingefügt.
Ist der Text Quelle ein leerer Text, wird nur der Text Einfügen zurückgegeben.

Insert string überschreibt im Gegensatz zu Change string nicht die Zeichen, sondern fügt neue ein.

Beispiel

Folgendes Beispiel zeigt die Verwendung von Insert string. Die Ergebnisse werden in der Variablen vtResult zugewiesen.

 vtResult:=Insert string("Der Baum";" grüne";4) ` vtResult ergibt "Der grüne Baum"

 vtResult:=Insert string("Hut";"a";2) ` vtResult ergibt "Haut"

 vtResult:=Insert string("Schrank";"en";8) ` vtResult ergibt "Schranken"