Automation Engine Script-Leitfaden > Funktionelle Gliederung > Strings > STR_SUBSTITUTE

STR_SUBSTITUTE

Script-Funktion: Ersetzt Zeichen oder Zeichenkette innerhalb einer Zeichenkette.

Syntax

STR_SUB[STITUTE] (String, [Old], [New])

Syntax	Beschreibung/Format
Zeichenkette	Alphanumerische Zeichenfolge, innerhalb der ersetzt werden soll. Format: Script-Literal oder Script-Variable
Alt	Alphanumerische Zeichenfolge, die in der Zeichenkette ersetzt werden soll. Format: Script-Literal oder Script-Variable Standardwert: ""
Neu	Alphanumerische Zeichenfolge, die Alt ersetzen soll. Format: Script-Literal oder Script-Variable Standardwert: ""

Rückgabewert
Zeichenkette, die durch die Ersetzung entstanden ist.

Kommentare

Die Script-Funktion ersetzt ein Zeichen oder eine Zeichenkette innerhalb einer Zeichenkette.

Die Parameter Alt und Neu sind optional und besitzen kein Größenlimit. Wurde Alt nicht als Parameter angegeben, wird jedes einzelne Leerzeichen durch das Zeichen bzw. die Zeichenkette von Neu ersetzt. Wurde Neu nicht als Parameter verwendet, wird Alt durch ein einziges Leerzeichen ersetzt.

Kommt Alt in der Zeichenkette nicht vor, gibt die Funktion die Zeichenkette unverändert zurück.

Die Script-Funktion kann auch dazu verwendet werden, Alt aus der Zeichenkette zu löschen. Dafür müssen als Neu zwei aufeinanderfolgende Hochkommata (ohne Leerzeichen) angegeben werden.

Beispiel

Im ersten Beispiel wird das Zeichen "A" durch das Zeichen "B" ersetzt. Das Ergebnis "BBBBB" wird im Aktivierungsprotokoll ausgegeben.

:SET &RET# = STR_SUBSTITUTE ("AAAAA", "A", "B")
:PRINT &RET#

Das zweite Beispiel ersetzt die Zeichenkette "AAAAA" durch das Zeichen "B". Das Ergebnis "B" wird im Aktivierungsprotokoll ausgegeben.

:SET &RET# = STR_SUBSTITUTE ("AAAAA", "AAAAA", "B")
:PRINT &RET#

Im dritten Beispiel wird die Zeichenkette "AA" durch die Zeichenkette "BB" ersetzt. Das Ergebnis "BBBBA" wird im Aktivierungsprotokoll ausgegeben.

:SET &STR1# = "AA"
:SET &STR2# = "BB"
:SET &RET# = STR_SUB ("AAAAA", &STR1#, &STR2#)
:PRINT &RET#

Das vierte Beispiel löscht die Leerzeichen aus der Zeichenkette. Das Ergebnis "AE“ wird im Aktivierungsprotokoll ausgegeben.

:SET &RET# = STR_SUB ("A E", " ", "")
:PRINT &RET#

Siehe auch:

Script-Sprachmittel - Strings

Allgemeines zum Script
Script-Sprachmittel - Alphabetische Auflistung
Script-Sprachmittel - Funktionelle Gliederung

Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support