Zeichenkettenfunktionen

Im Allgemeinen ändern Zeichenkettenfunktionen den Eingabeausdruck und geben eine aktualisierte Zeichenkette zurück. Der Eingabeausdruck wird immer als eine Zeichenkette aufgefasst; auch wenn er als Datum oder Zahl erscheint, wird er als Zeichenkette interpretiert.

String-Funktionen:

LCase-Funktionen

Die LCase-Funktion dient zur Formatierung in Kleinbuchstaben. Der Ausdruck wird in Kleinbuchstaben umgewandelt und als Zeichenkette ausgegeben.

Syntax:

Lcase(Ausdruck)

Beispiel:

Lcase("HALLO") gibt den Wert "hallo" zurück.

TCase-Funktion

Die TCase-Funktion dient der Formatierung im Überschriftenstil. Sie ändert den Ausdruck so, dass jedes neue Wort (beginnend nach einem Zeichen, das kein Buchstabe des Alphabets ist) mit einem Großbuchstaben beginnt, und gibt eine Zeichenkette aus.

Syntax:

Tcase(Ausdruck)

Beispiel:

Tcase(„formatierungsfunktionen") gibt den Wert „Formatierungsfunktionen" zurück.

UCase-Funktion

Die UCase-Funktion weist eine Formatierung in Großbuchstaben zu. Der Ausdruck wird in Großbuchstaben umgewandelt und als Zeichenkette ausgegeben.

Syntax:

Ucase(Ausdruck)

Beispiel:

UCase(“Das ist es”) gibt den Wert “DAS IST ES” zurück.

Length-Funktion

Die Length-Funktion gibt die Anzahl der Zeichen im Eingabeausdruck aus.

Syntax:

Length(Ausdruck)

Beispiel:

Length(“abc”) gibt den Wert 3 zurück.

IsNullOrEmpty-Funktion

Die Funktion IsNullOrEmpty legt fest, ob der Eingabeausdruck gleich NULL ist
(z. B. NULL Datenquellenfeld) oder leer (z. B. eine leere Zeichenkette).
Diese Funktion gibt true zurück, wenn die Zeichenkette NULL oder leer ist, und andernfalls false.

Syntax:

IsNullOrEmpty(Ausdruck)

Beispiel:

IsNullOrEmpty(|->[Adresse2]) gibt den Wert false aus, falls Address2 einen Wert enthält, und „true”, falls er NULL oder leer ist.

Funktion SubString

Die Funktion SubString  ruft einen Teil der Zeichenfolge von expression1 mit Zeichen von expression3, beginnend von Position expression2.

Syntax:

SubString(Ausdruck1,Ausdruck2,Ausdruck3)

Wobei:

  • expression1 wird stets als eine Zeichenkette betrachtet; auch wenn der Wert als Datum oder Zahl erscheint, wird er als Zeichenkette interpretiert.

  • expression2 gibt die Startposition der Teilzeichenkette an.

    0 steht beispielsweise für die erste Zeichenposition in expression1, 1 für die zweite Zeichenposition etc.

  • Ausdruck3 ist die Anzahl der abgefragten Zeichen.

3 beispielsweise ruft drei Zeichen ab, 0 eine leere Zeichenkette etc.

Ein Wert von -1 gibt an, dass alle Zeichen bis zum Ende von expression1 abgefragt werden sollen.

Beispiele:

SubString(“abcd”,1,2) = ”bc”

SubString(“James”2,2) = ”me”

SubString(1973,0,2) = ”19”

SubString(“James”,2,-1) = ”mes”

Funktion Trim

Die Trim-Funktion beschneidet vorangestellte und nachgestellte Leerzeichen im Ausdruck.

Syntax:

Trim(Ausdruck)

Beispiel:

Trim(" hallo WELT ") = "hallo WELT"

Funktion LTrim

Die LTrim-Funktion beschneidet vorangestellte Leerzeichen im Ausdruck.

Syntax:

LTrim(Ausdruck)

Beispiel:

LTrim(" hallo WELT ") = "hallo WELT "

Funktion RTrim

Die RTrim-Funktion beschneidet nachgestellte Leerzeichen im Ausdruck.

Syntax:

RTrim(Ausdruck)

Beispiel:

RTrim(" hallo WELT ") = " hallo WELT"

Find-Funktion

Die Find-Funktion ruft den Zeichenindex (nullbasiert) in exprssion1 ab, wobei Zeichenkette (expression2) gefunden wird. Die Suche beginnt bei Zeichenindex (expression3  – nullbasiert). Das Ergebnis ist -1, falls die Zeichenkette nicht gefunden wird.

Syntax:

Find(expression1, expression2, expression3)

Beispiel:

Find("hallo WELT", "WELT", 0) = 6

Funktion ersetzen

Die Replace-Funktion ersetzt einen Teil von expression1, beginnend mit dem Zeichenindex (expression3 – nullbasiert) der Länge (expression4) durch die Zeichenkette (expression2).

Syntax:

Replace(expression1, expression2, expression3, expression4)

Beispiel:

Replace("hallo WELT", "ERDE", 6, 5) = “hallo ERDE”

Funktion FindAndReplace

Die Funktion FindAndReplace  ersetzt alle Vorkommen der Zeichenfolge (expression2) in expression1 durch die Zeichenfolge (expression3).

Syntax:

FindAndReplace(expression1, expression2, expression3)

Beispiel:

FindAndReplace("hallo WELT", "WELT", "ERDE") = "hallo ERDE"

Funktion FindAndReplaceChars

Die Funktion FindAndReplaceChars ersetzt alle Instanzen von einem oder mehreren Zeichen in der Zeichenkette durch einen anderen Zeichensatz. Diese Funktion können Sie beispielsweise nutzen, um ungültige URL-Zeichen aus einer Zeichenkette zu entfernen.

Syntax:

FindAndReplaceChars(expression1, expression2, expression3)

  • expression1 - eine Zeichenkette, die die zu ersetzenden Zeichen enthält

  • expression2 – Liste der zu ersetzenden Zeichen

  • Ausdruck3-optional. Ersatzzeichenkette, die statt eines der in expression2 aufgeführten Zeichen verwendet werden kann. Die Zeichenkette kann leer sein oder mehrere Zeichen enthalten. Wenn die Zeichenkette ausgelassen wird, werden die Zeichen in expression2 entfernt.

Ausgabewert  - die aktualisierte Zeichenkette, die die ersetzten Zeichen enthält.

Beispiel:

Das folgende Beispiel ersetzt das Leerzeichen durch einen Unterstrich („_”):

FindAndReplaceChars("John Michael Smith", " ", "_") = "John_Michael_Smith”

Das folgende Beispiel entfernt das Leerzeichen:

FindAndReplaceChars("John Michael Smith", " ") = "JohnMichaelSmith"

Funktion FindByRegExp

Die Funktion FindByRegExp behält nur die Zeichenfolge, die mit der Definition des regulären Ausdrucks übereinstimmt.  

Die Syntax des regulären Ausdrucks ist ECMA-262-Grammatik mit Änderungen.

Syntax

FindByRegExp(exprAsString, regExpString, firstMatchOnly)

exprAsString  - Das Eingabefeld, auf das der reguläre Ausdruck angewendet wird.

regExpString - Die Regel des regulären Ausdrucks.

firstMatchOnly - Wenn der Wert "False" ist, werden alle Ergebnisse ausgegeben. Bei "True" - wird nur die erste Übereinstimmung ausgegeben.

Beispiel

FindByRegExp("1222 Duncan Avenue", "[A-Za-z]+",True) = Duncan

Funktion FindAndReplaceByRegExp

Die Funktion FindAndReplaceByRegExp findet mithilfe von regulären Ausdrücken (RegExp) Muster in Text und ersetzt diese mit einem bestimmten Wert.

Die Syntax des regulären Ausdrucks ist ECMA-262- Grammatik mit Änderungen.

Syntax

FindAndReplaceByRegExp(exprAsString, regExpString, replaceString, firstMatchOnly)

  • exprAsString - Das Eingabefeld, auf das der reguläre Ausdruck angewendet wird.

  • regExpString - Die Regel des regulären Ausdrucks.

  • replaceString - Der Wert, der den gefundenen Ausdruck ersetzten soll.

  • firstMatchOnly - Wenn der Wert „False“ ist, werden alle Ergebnisse ausgegeben. Bei „True“ wird nur die erste Übereinstimmung ausgegeben.

Beispiel

FindAndReplaceByRegExp("MyFileName.Ext","\\.[^.]*$", "",False)

Die Funktion FindAndReplaceByRegExp("MyFileName.Ext","\\,[^.]*$", "", False) verwendet den regulären Ausdruck "\\.[^.]*$" , um die Dateierweiterung zu suchen und zu ersetzen (mit einer leeren Zeichenfolge). In diesem Beispiel sucht der reguläre Ausdruck nach dem letzten Punkt (\\.) und nach allen Zeichen (mit Ausnahme von Punkt), die darauf folgen ([^.]*) und zwar bis zum Ende der Zeichenkette ($). Wenn dieses Muster gefunden wird, wird es durch eine leere Zeichenfolge ersetzt (das heißt, die Erweiterung wird gelöscht).

Funktion CleanNumber

Die Funktion CleanNumber ermöglicht es, alle Zeichen aus einer Zeichenfolge zu entfernen und nur Zahlen zu belassen. Das ist besonders nützlich, um Telefonnummern zu bereinigen.

Syntax:

CleanNumber(exprAsString)

Beispiel:

Das folgende Beispiel entfernt das Leerzeichen und die Zeichen + und - aus der Zeichenfolge:

CleanNumber("+1 888-452-1111") = 18884521111

CleanRecipientKey-Funktion

Die Funktion CleanRecipientKey  ermöglicht Ihnen die Handhabung ungültiger Zeichen beim Hinzufügen neuer Empfängerschlüssel zur Datenquelle (mit dem Ausdruck INSERT).

Diese Funktion findet alle Instanzen ungültiger URL-Zeichen (Leerzeichen, „:”, „?”, „&”, „*”, „#”, „<“, „>”, „|”, Anführungszeichen, „‘”) im Ausdruck RecipientKey  und ersetzt sie durch die Zeichenkette ReplaceInvalidWith.

Hinweis: „ReplaceInvalidWith” ist optional: wenn Sie dies nicht angeben, werden die ungültigen URL-Zeichen in „RecipientKey” entfernt.

Syntax:

CleanRecipientKey(RecipientKey, ReplaceInvalidWith)

Beispiel:

Das folgende Beispiel ersetzt das Leerzeichen durch einen Unterstrich („_”):

CleanRecipientKey("John Michael.Smith", "_") = "John_Michael.Smith"

Das folgende Beispiel entfernt das Leerzeichen:

CleanRecipientKey("John Michael.Smith") = "JohnMichael.Smith"

Funktion HexToUnicode

Mit dem Hexadezimalcode können Sie mithilfe von Hexadezimalwerten Unicode-Zeichen darstellen, die nicht durch Symbole darstellbar sind.
Die Funktion HexToUnicode ermöglicht Ihnen die Behandlung einer hexadezimalen Zeichenkette als Unicode-Zeichenkette.

Der Eingabeparameter exprAsHexString  ist eine Zeichenkette aus hexadezimalen Zeichen. Jede Sequenz aus vier hexadezimalen Zeichen wird in das passende Unicode-Zeichen konvertiert (wenn sich die Zeichenkette nicht durch vier teilen lässt, füllt die Funktion die Zeichenkette automatisch mit vorangestellten Nullen auf).

Beachten Sie, dass der Zeichenfolgenwert der Eingabe in Big-Endian erfolgt.

Syntax:

HexToUnicode(exprAsHexString)

Beispiel:

Für die Verwendung des Tabulatorzeichens können Sie dessen Hex-Wert, 9, wie folgt verwenden:

“Hallo” + HexToUnicode(“9”) + “Welt”

...würde ergeben:

Hallo<Tab>Welt

Funktion HtmlEncode

Die Funktion HtmlEncode(strToEncode) konvertiert einen Sting in einen HTML-kodierten String und gibt den kodierten Sting aus. Wird in der Regel zum Verschlüsseln einer URL verwendet, damit diese auf sichere Weise auf einem HTTP-Server gepostet werden kann (z.B. URL-Kodierung).

Syntax

HtmlEncode(strToEncode)

Beispiel:

HtmlEncode("http://my_domain/my page.html")

...würde ergeben:

"http://my_domain/my%20page.html"