Skip to main content

xSuite Interface Windows Prism 5.x – Online-Hilfe

Textoperationen

Contains()

Diese Funktion prüft, ob eine Zeichenfolge in einer anderen Zeichenfolge enthalten ist.

Rückgabetyp: Bool

Parameter

Datentyp

Beschreibung

1

Text

Zeichenfolge, die durchsucht wird

2

Text

Zeichenfolge, die gesucht wird

Beispiele

Contains("ABCDEF", "cd") ergibt TRUE.

CutLeft(), CutRight()

Diese Funktionen schneiden linksseitig oder rechtseitig eine bestimmte Anzahl von Zeichen von einer Zeichenfolge ab und liefern den modifizierten Wert zurück.

Rückgabetyp: Text

Parameter

Datentyp

Beschreibung

1

Text

zu beschneidende Zeichenfolge

2

Number

Anzahl abzuschneidender Zeichen

Beispiele

CutLeft("ABCDEF", 3) ergibt "DEF".

CutLeft("ABCDEF", 10) ergibt "".

FillLeft(), FillRight()

Diese Funktionen füllen eine Zeichenfolge linksseitig oder rechtsseitig auf eine bestimmte Länge mit einem Füllzeichen auf und liefern die modifizierte Zeichenfolge zurück.

Rückgabetyp: Text

Parameter

Datentyp

Beschreibung

1*

Text

aufzufüllende Zeichenfolge

2*

Number

neue Länge der Zeichenfolge

3

Text

einzelnes Füllzeichen

Standardwert: Leerzeichen

Beispiele

FillLeft("123", 5, "0") ergibt "00123".

GetFilePart()

Diese Funktion liefert einen bestimmten Teil aus einer Zeichenfolge zurück, die einen Dateipfad darstellt.

Prinzipiell kann das auch ein Ordnerpfad sein, wobei der Name des untersten Ordners dann wie ein Dateiname behandelt wird.

Rückgabetyp: Text

Parameter

Datentyp

Beschreibung

1

Text

Dateipfad

2

Text

Teil des Dateipfades, der extrahiert wird:

  • Folder: vollständiger Ordnerpfad der Datei ohne abschließendes /-Zeichen

  • FileName: vollständiger Dateiname (Standardwert)

  • FileBaseName: Basisdateiname ohne Endung

  • FileExt: Dateiendung ohne Trennzeichen

3

Number

Wenn nicht der vollständige Ordnerpfad (Folder) gesucht wird, sondern nur der Name eines Verzeichnisses einer bestimmten Ebene, muss hier die Nummer dieser Ebene angegeben werden.

Die Zählung beginnt bei 1. Der Laufwerks- oder Freigabename zählt dabei nicht mit.

Beispiele

GetFilePart("c:/temp/files/test.txt", "FileBaseName") ergibt "test".

GetFilePart("c:/temp/files/test.txt", "Folder", 2) ergibt "files".

GetFilePart("c:/temp/files/test.txt", "Folder", 3) ergibt "files" (ersatzweise der Ordner der tiefsten Ebene, weil die dritte Ebene nicht vorhanden ist).

GetRandomText()

Diese Funktion liefert eine zufällig generierte Zeichenfolge zurück.

Rückgabetyp: Text

Parameter

Datentyp

Beschreibung

1

Number

minimale Länge der zu generierenden Zeichenfolge

Standardwert: 1

2

Number

maximale Länge der zu generierenden Zeichenfolge

Standardwert: 100

3

Text

Zeichenfolge der zu nutzenden Zeichen

Aus der Zeichenfolge werden zufällig Zeichen ausgewählt.

Standardwert: abcdefghijklmnopqrstuvwxyz-

Beispiele

GetRandomText(5, 10, "abc") ergibt eine Zeichenfolge, die 5 bis 10 Zeichen lang ist (z. B. "bccacaa").

IsText()

Diese Funktion prüft, ob ein Wert vom Datentyp "Text" ist.

Rückgabetyp: Bool

Parameter

Datentyp

Beschreibung

1*

(variabel)

zu prüfender Wert

Beispiele

IsText("abc") ergibt TRUE.

IsText(TRUE) ergibt FALSE.

KeepChars()

Diese Funktion löscht aus einer Zeichenfolge alle Zeichen, die nicht explizit beizubehalten sind und liefert die modifizierte Zeichenfolge zurück.

Rückgabetyp: Text

Parameter

Datentyp

Beschreibung

1

Text

zugrunde liegende Zeichenfolge

2

Text

Liste der beizubehaltenden, d.h. nicht zu löschenden Zeichen

Die Angabe erfolgt in Form einer zusammenhängenden Zeichenfolge dieser Zeichen. Darin können auch Bereiche der Form 0-9 oder A-Z definiert werden.

3

Bool

Wahrheitswert, ob beim Vergleich die Groß-/Kleinschreibung ignoriert wird

Standardwert: TRUE

Beispiele

KeepChars("A B-c", "ABC", FALSE) ergibt "AB".

LastPos()

Diese Funktion liefert die Startposition des letzten Auftretens einer Suchzeichenfolge innerhalb einer Zeichenfolge zurück.

Die Zählung beginnt bei 1. Bei einer nicht gefundenen Suchzeichenfolge ist das Ergebnis 0.

Rückgabetyp: Number

Parameter

Datentyp

Beschreibung

1

Text

zu durchsuchende Zeichenfolge

2*

Text

Suchzeichenfolge

3

Bool

Wahrheitswert, ob beim Vergleich die Groß-/Kleinschreibung ignoriert wird

Standardwert: TRUE

Beispiele

LastPos("ABC ABC abc", "ABC", FALSE) ergibt 5.

Left(), Right()

Diese Funktionen lesen links- oder rechtsseitig, d.h. am Anfang oder Ende, eine bestimmte Anzahl von Zeichen aus einer Zeichenfolge.

Rückgabetyp: Text

Parameter

Datentyp

Beschreibung

1

Text

zugrunde liegende Zeichenfolge

2

Number

Anzahl zu extrahierender Zeichen

Standardwert: 1

Beispiele

Left("ABCDEF", 3) ergibt "ABC".

Left("ABCDEF", 10) ergibt "ABCDEF".

Length()

Diese Funktion liefert die Länge einer Zeichenfolge zurück, d.h. die Anzahl der Zeichen.

Rückgabetyp: Number

Parameter

Datentyp

Beschreibung

1

Text

Zeichenfolge

Beispiele

Length("ABC") ergibt 3.

Mid()

Diese Funktion liest ab einer beliebigen Position eine bestimmte Anzahl von Zeichen aus einer Zeichenfolge.

Rückgabetyp: Text

Parameter

Datentyp

Beschreibung

1

Text

zugrunde liegende Zeichenfolge

2

Number

Startposition, d.h. Nummer des Zeichens

Die Zählung beginnt bei 1.

Standardwert: 1

3

Number

Anzahl zu extrahierender Zeichen

Standardwert: 1

Beispiele

Mid("ABCDEF", 3) ergibt "C".

Mid("ABCDEF", 3, 2) ergibt "CD".

Mid("ABCDEF", 3, 10) ergibt "CDEF".

Pos()

Diese Funktion liefert die Startposition des ersten Auftretens einer Suchzeichenfolge innerhalb einer Zeichenfolge zurück.

Die Zählung beginnt bei 1. Bei einer nicht gefundenen Suchzeichenfolge ist das Ergebnis 0.

Rückgabetyp: Number

Parameter

Datentyp

Beschreibung

1

Text

zu durchsuchende Zeichenfolge

2*

Text

Suchzeichenfolge

3

Number

Zeichenposition, ab der die Suche begonnen wird

Standardwert: 1

4

Bool

Wahrheitswert, ob beim Vergleich die Groß-/Kleinschreibung ignoriert wird

Standardwert: TRUE

Beispiele

Pos("ABC abc ABC", "ABC", 2, FALSE) ergibt 9.

RegExIsMatch()

Diese Funktion prüft eine Zeichenfolge auf Übereinstimmung mit einem regulären Ausdruck.

Rückgabetyp: Bool

Parameter

Datentyp

Beschreibung

1

Text

zu prüfende Zeichenfolge

2*

Text

regulärer Ausdruck

3

Bool

Wahrheitswert, ob beim Vergleich die Groß-/Kleinschreibung ignoriert wird

Standardwert: TRUE

Beispiele

RegExIsMatch("ABC", "^A.*") ergibt TRUE.

RegExMatch(), RegExLastMatch()

Diese Funktionen extrahieren aus einer Zeichenfolge den ersten Teil und den letzten Teil, der einem regulären Ausdruck entspricht.

Wenn der reguläre Ausdruck keine Gruppierungen (in runden Klammern) enthält, wird nur ein einzelner Textwert zurückgeliefert. Wenn kein Treffer gefunden wird, wird ein leerer Textwert zurückgeliefert. Anderenfalls besteht das Ergebnis aus einem Array mit den Textwerten über alle Gruppen.

Parameter

Datentyp

Beschreibung

1

Text

Zeichenfolge, auf die der reguläre Ausdruck angewendet wird

2*

Text

regulärer Ausdruck

3

Bool

Wahrheitswert, ob beim Vergleich die Groß-/Kleinschreibung ignoriert wird

Standardwert: TRUE

Beispiele

RegExMatch("ABCabc", "A..") ergibt "ABC".

RegExLastMatch("ABCabc", "A..") ergibt "abc".

RegExMatch("ABCDEF", "(A..)(D..)") ergibt ["ABC","DEF"].

RegExMatch("ABCDEF", "(U..)(X..)") ergibt "".

RegExMatches()

Diese Funktion extrahiert aus einer Zeichenfolge alle Teile, die einem regulären Ausdruck entsprechen.

Unabhängig von der Anzahl der Treffer wird immer ein Array zurückgeliefert. Wenn der Ausdruck Gruppierungen enthält (in runden Klammern), werden die Ergebniswerte aller Gruppen über alle Treffer in das Array geschrieben.

Parameter

Datentyp

Beschreibung

1

Text

Zeichenfolge, auf die der reguläre Ausdruck angewendet wird

2*

Text

regulärer Ausdruck

3

Bool

Wahrheitswert, ob beim Vergleich die Groß-/Kleinschreibung ignoriert wird

Standardwert: TRUE

Beispiele

RegExMatches("ABC DEF ghi", "[A-Z]+", FALSE) ergibt ["ABC","DEF"].

RegExMatches("ABC1 def2", "([A-Z]+)(\d+)") ergibt ["ABC","1","def","2"].

RegExMatchPos(), RegExLastMatchPos()

Diese Funktionen liefern die Startposition des ersten oder des letzten Auftretens eines Teils aus einer Zeichenfolge zurück, der einem regulären Ausdruck entspricht.

Die Zählung beginnt bei 1. Wenn kein Treffer gefunden wird, ist das Ergebnis 0. Wenn der reguläre Ausdruck Gruppierungen enthält, wird nur die Position der ersten Gruppe ermittelt.

Rückgabetyp: Number

Parameter

Datentyp

Beschreibung

1

Text

Zeichenfolge, auf die der reguläre Ausdruck angewendet wird

2*

Text

regulärer Ausdruck

3

Bool

Wahrheitswert, ob beim Vergleich die Groß-/Kleinschreibung ignoriert wird

Standardwert: TRUE

Beispiele

RegExMatchPos("ABCabc", "c") ergibt 3.

RegExLastMatchPos("ABCabc", "c") ergibt 6.

RegExReplace()

Diese Funktion ersetzt in einer Zeichenfolge alle Vorkommnisse, die einem regulären Ausdruck entsprechen.

Rückgabetyp: Text

Parameter

Datentyp

Beschreibung

1

Text

Zeichenfolge, auf die die Ersetzung angewendet wird

2*

Text

regulärer Ausdruck

3

Text

Ersetzungswert

Wenn Teile in der Zeichenfolge entfernt statt ersetzt werden sollen, kann hier auch ein leerer Wert angegeben werden.

4

Bool

Wahrheitswert, ob beim Vergleich die Groß-/Kleinschreibung ignoriert wird

Standardwert: TRUE

Beispiele

RegExReplace("A B-c", "[^A-Z]", "_") ergibt "A_B_c".

RegExReplace("A B-c", "[^A-Z]", "", FALSE) ergibt "AB".

RemoveChars()

Diese Funktion löscht aus einer Zeichenfolge alle Vorkommnisse bestimmter Zeichen und liefert die modifizierte Zeichenfolge zurück.

Rückgabetyp: Text

Parameter

Datentyp

Beschreibung

1

Text

zugrunde liegende Zeichenfolge

2

Text

Liste der zu löschenden Zeichen

Die Angabe erfolgt in Form einer zusammenhängenden Zeichenfolge dieser Zeichen. Darin können auch Bereiche der Form 0-9 oder A-Z definiert werden.

3

Bool

Wahrheitswert, ob beim Vergleich die Groß-/Kleinschreibung ignoriert wird

Standardwert: TRUE

Beispiele

RemoveChars("A1 B2 C3", " 0-2") ergibt "ABC3".

Replace()

Diese Funktion ersetzt in einer Zeichenfolge alle Vorkommnisse einer Suchzeichenfolge durch eine Ersetzungszeichenfolge und liefert die modifizierte Zeichenfolge zurück.

Rückgabetyp: Text

Parameter

Datentyp

Beschreibung

1

Text

zugrunde liegende Zeichenfolge

2

Text

Suchzeichenfolge, die ersetzt wird

3

Text

Ersetzungszeichenfolge, durch die ersetzt wird

Standardwert: leere Zeichenfolge

Beispiele

Replace("A B C", " ", "_") ergibt "A_B_C".

Replace("A-B-C", "-", "") ergibt "ABC".

ToLower(), ToUpper()

Diese Funktionen konvertieren eine Zeichenfolge in Kleinschreibung oder in Großschreibung und liefern den modifizierten Wert zurück.

Rückgabetyp: Text

Parameter

Datentyp

Beschreibung

1

Text

zugrunde liegende Zeichenfolge

Beispiele

ToLower("AbC") ergibt "abc".

ToText()

Diese Funktion konvertiert einen Einzelwert oder ein Array beliebigen Typs in eine (trennzeichenseparierte) Zeichenfolge und liefert diese zurück.

Rückgabetyp: Text

Parameter

Datentyp

Beschreibung

1

(variabel)

Einzelwert oder Array von Werten

2

Text

Formatierungsmuster für die Umwandlung typisierter Werte in eine Zeichenfolge

Dabei gilt die gleiche Syntax wie für die Übergabe textueller Werte an ein Ausgabesystem (siehe Eigenschaft OutputSystem[].Field[].OutputFormat), z. B. yyyy-MM-dd für ein Datumsformat und 0.00 für ein Zahlenformat.

3

Text

Trennzeichen, das für die Aneinanderreihung multipler Werte zu der Gesamtzeichenfolge genutzt wird

Standardwert: | (senkrechter Strich)

Beispiele

ToText(2025-12-31, "dd.MM.yyyy") ergibt "31.12.2025".

ToText([1.2, 3.4], "0.00", " ") ergibt "1.20 3.40".

ToText([1, 2]) ergibt "1|2".

Trim(), TrimLeft(), TrimRight()

Diese Funktionen schneiden beidseitig, linksseitig (am Anfang) oder rechtsseitig (am Ende) einer Zeichenfolge alle aufeinanderfolgenden Vorkommnisse eines bestimmten Zeichens ab und liefern die modifizierte Zeichenfolge zurück.

Rückgabetyp: Text

Parameter

Datentyp

Beschreibung

1

Text

zugrunde liegende Zeichenfolge

2

Text

abzuschneidendes Zeichen

Standardwert: Leerzeichen

Beispiele

Trim("  ABC  ") ergibt "ABC".

TrimLeft("__ABC__", "_") ergibt "ABC__".