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:
|
3 | Number | Wenn nicht der vollständige Ordnerpfad ( 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: |
2 | Number | maximale Länge der zu generierenden Zeichenfolge Standardwert: |
3 | Text | Zeichenfolge der zu nutzenden Zeichen Aus der Zeichenfolge werden zufällig Zeichen ausgewählt. Standardwert: |
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 |
3 | Bool | Wahrheitswert, ob beim Vergleich die Groß-/Kleinschreibung ignoriert wird Standardwert: |
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: |
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: |
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: |
3 | Number | Anzahl zu extrahierender Zeichen Standardwert: |
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: |
4 | Bool | Wahrheitswert, ob beim Vergleich die Groß-/Kleinschreibung ignoriert wird Standardwert: |
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: |
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: |
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: |
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: |
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: |
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 |
3 | Bool | Wahrheitswert, ob beim Vergleich die Groß-/Kleinschreibung ignoriert wird Standardwert: |
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 |
3 | Text | Trennzeichen, das für die Aneinanderreihung multipler Werte zu der Gesamtzeichenfolge genutzt wird Standardwert: |
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__".