4D Doc Center : Replace string

4D v13.4

Replace string


Replace string ( Quelle ; AlterString ; NeuerString {; Wieviele}{; *} ) -> Funktionsergebnis

Parameter	Typ	Beschreibung
Quelle	String	Original String
AlterString	String	Zu ersetzende Zeichen
NeuerString	String	String zum Ersetzen (ist String leer, werden alle Vorkommen gelöscht)
Wieviele	Lange Ganzzahl	Wieviele Mal soll ersetzt werden Ohne Angabe werden alle Vorkommen ersetzt
*	Operator	Mit Stern: Bewertung basiert auf Zeichen-Codes
Funktionsergebnis	String	Geänderter Text

Beschreibung

Die Funktion Replace string ersetzt im Text Quelle den Text AlterString durch den Text NeuerString. Ist NeuerString ein leerer String (""), ersetzt Replace string alle Vorkommen des Textes AlterString in Quelle. Ist der Parameter Wieviele angegeben, ersetzt der Befehl nur die angegebene Anzahl der Vorkommen von AlterString, beginnend mit dem ersten Zeichen von Quelle. Geben Sie diesen Parameter nicht an, ersetzt Replace string alle Vorkommen von AlterString.

Ist AlterString ein leerer String (""), bleibt Quelle unverändert.

Der Befehl führt standardmäßig globale Vergleiche aus, die linguistische Besonderheiten und Buchstaben, die als ein oder mehr Zeichen geschrieben werden (z.B. æ = ae) berücksichtigt. Dagegen ist er nicht diakritisch (a=A, a=á, etc.) und berücksichtigt nicht "ignorierbare" Zeichen, z.B. Zeichen mit Code < 9 (Unicode Spezifikation).

Wollen Sie diese Funktionsweise ändern, übergeben Sie * als letzten Parameter. Dann basieren Vergleiche auf Zeichen-Codes. Sie müssen * übergeben, um:

Sonderzeichen zu berücksichten, die z.B. als Begrenzer dienen: Char(1), o.ä.
Groß- und Kleinschreibung und Zeichen mit Akzenten unterschiedlich zu werten: a#A, a#à, etc. Beachten Sie, dass der Vergleich in diesem Modus keine Variation in der Schreibweise von Wörtern verwaltet.

Beispiel 1

Folgendes Beispiel zeigt die Anwendung von Replace string. Die Ergebnisse werden der Variablen vtResult zugewiesen.

 vtResult:=Replace string("Bindfaden";" ndf";"ldl") ` vtResult ergibt "Bildladen"

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

 vtResult:=Replace string(vtOtherVar;Char(Tab);",";*) ` Ersetzt alle Tabulatoren in vtOtherVar durch Kommas

Beispiel 2

Folgendes Beispiel löscht Zeilenumbrüche und Tabulatoren aus dem Text in vtResult:

vtResult:=Replace string(Replace string(vtResult;Char(Carriage return);"";*);Char(Tab);"";*)

Beispiel 3

Dieses Beispiel zeigt die Verwendung des Parameters * bei Berücksichtigung diakritischer Zeichen

 vtResult:=Replace string("Crème brûlée";"Brulee";"caramel") `Ergebnis ist "Crème caramel"

 vtResult:=Replace string("Crème brûlée";"Brulee";"caramel";*) `Ergebnis ist "Crème brûlée"