Zeichenfolgenfunktionen im Jitterbit Integration Studio

String-Funktionen sind der Mechanismus zur Manipulation von Strings in Scripts.

CountSubString

Erklärung

int CountSubString(string str, string subStr)

Syntax

CountSubString(<str>, <subStr>)

Erforderliche Parameter

• str: Eine zu durchsuchende Zeichenfolge
• subStr: Die zu suchende Zeichenfolge

Beschreibung

Gibt zurück, wie oft eine Teilzeichenfolge in einer Zeichenfolge vorkommt.

Beispiele

CountSubString("Mississippi", "iss"); // Returns 2

DQuote

Erklärung

string DQuote(string str)

Syntax

DQuote(<str>)

Erforderliche Parameter

• str: Eine Zeichenfolge, die in doppelte Anführungszeichen gesetzt werden soll

Beschreibung

Setzt eine Zeichenfolge in Anführungszeichen und gibt das Ergebnis zurück. Eingebettete Anführungszeichen werden nicht maskiert.

Beispiele

DQuote("any str"); // Returns ""any str""

DQuote('any "text" str');
// Returns ""any "text" str"" -- note that the embedded double quotes are not escaped

Format

Erklärung

string Format(string formatStr, type de)

Syntax

Format(<formatStr>, <de>)

Erforderliche Parameter

• formatStr: Der Formatstring zur Verwendung beim Formatieren der Zeichenfolge
• de: Ein Datenelement; bei Bedarf wird es vor der Formatierung in einen String umgewandelt

Beschreibung

Gibt eine Zeichenfolge im durch eine Formatzeichenfolge angegebenen Format zurück.

Die Formatspezifikation ist dieselbe wie die in den Datums- und Uhrzeitfunktionen; siehe den Abschnitt zu Formatzeichenfolgen. Es ähnelt der Standard-C-Bibliothek printf Formatspezifikation.

Mit dieser Funktion kann das Ausgabeformat für ein Ziel festgelegt werden. Sie ist nützlich, wenn das Standardausgabeformat von Jitterbit für einen Datentyp (wie Datum oder Double) nicht den gewünschten Wert hat. Der Aufruf der Format Funktion muss der letzte Aufruf in einer Zuordnungsformel sein, damit sie der zugeordnete Wert ist.

Beispiele

Format("'%5d'", 2); // Returns "'    2'"

Index

Erklärung

int Index(string str, string subStr[, int n])

Syntax

Index(<str>, <subStr>[, <n>])

Erforderliche Parameter

• str: Eine zu durchsuchende Zeichenfolge
• subStr: Die zu suchende Zeichenfolge

Optionale Parameter

• n: Die spezifische Instanz von Interesse, wenn mehr als eine Übereinstimmung vorliegt

Beschreibung

Gibt die Position einer Teilzeichenfolge innerhalb einer Zeichenfolge zurück.

In Fällen, in denen die Teilzeichenfolge mehr als einmal in der Hauptzeichenfolge vorkommt, wird das dritte Argument (n) wird verwendet, um zu bestimmen, welche spezifische Instanz der Teilzeichenfolge von Interesse ist.

• Wenn n < 0 beginnt die Instanzzählung am Ende der Hauptzeichenfolge.
• Wenn |n| >die maximale Häufigkeit, mit der die Teilzeichenfolge in der Hauptzeichenfolge vorkommt, gibt die Funktion -1 zurück.

Andernfalls gibt die Funktion die Position des ersten Zeichens der Teilzeichenfolge innerhalb der Hauptzeichenfolge zurück (beginnend bei Position 0).

Zu berücksichtigende Sonderfälle:

• n = 0 gibt das gleiche Ergebnis zurück wie n = 1

• Wenn subStr ist eine leere Zeichenfolge (""):

  • n >= 0 gibt immer 0 zurück

  • n < 0 kehrt immer zurück Length(str)

Beispiele

Index("Mississippi", "s"); // Returns 2
// When called with only two arguments
// the optional third argument defaults to 1,
// resulting in the index of the first match being returned

Index("Mississippi", "iss", 3); // Returns -1
// Searching for the 3rd instance of "iss" within Mississippi

Index("Mississippi", "si", 2); // Returns 6
// The 2nd instance of the sub-string
// "si" starts at position 6 as the
// first letter "M" starts at position 0

Index("Mississippi", "", 1); // Returns 0
Index("Mississippi", "", -1); // Returns 11

IsValidString

Erklärung

bool IsValidString(string str)

Syntax

IsValidString(<str>)

Erforderliche Parameter

• str: Eine zu validierende Zeichenfolge

Beschreibung

Gibt „true“ zurück, wenn jedes Zeichen in einer Zeichenfolge gültig ist. Gültige Zeichen sind die ASCII-Codes 32 bis 126 einschließlich sowie alle Zeilenvorschub- (LF), Wagenrücklauf- (CR) und Tab (TAB).

Beispiele

IsValidString("An Invalid String™");
// Returns 0 (false), as the trademark symbol in this font is a code greater than 128

IsValidString("A Valid Broken
String");
// Returns 1 (true)

Left

Erklärung

string Left(string str, int n)

Syntax

Left(<str>, <n>)

Erforderliche Parameter

• str: Eine Zeichenfolge
• n: Die Anzahl der Zeichen vom linken Ende, die zurückgegeben werden sollen

Beschreibung

Rücksendungen n Zeichen einer Zeichenfolge, gezählt von links (vom Anfang) einer Zeichenfolge.

Siehe auch die Mid Und Right Funktionen.

Beispiele

Left("01234567890", 4);
// Returns "0123"

LPad

Erklärung

string LPad(string str, int n)

Syntax

LPad(<str>, <n>)

Erforderliche Parameter

• str: Eine Zeichenfolge
• n: Die Anzahl der Zeichen vom linken Ende, die zurückgegeben werden sollen

Beschreibung

Fügt links (am Anfang) einer Zeichenfolge Leerzeichen hinzu, bis die Zeichenfolge enthält n Zeichen. Zeichenfolgen mit n oder mehr Zeichen werden gekürzt auf n Zeichen.

LPad(str, -n)ist das gleiche wie RPad(str, n)Siehe die RPad Funktion.

Beispiele

LPad("01234567", 9);
// Returns " 01234567"
// Adds one space to the left side
// of the original string

LPad("1234567890", 9);
// Returns "123456789"

LPadChar

Erklärung

string LPadChar(string str, string padChar, int n)

Syntax

LPadChar(<str>, <padChar>, <n>)

Erforderliche Parameter

• str: Eine Zeichenfolge
• padChar: Eine Zeichenfolge, die zum Auffüllen von Zeichen verwendet wird; wenn mehr als ein Zeichen vorhanden ist, wird das erste Zeichen verwendet
• n: Die Anzahl der Zeichen vom linken Ende, die zurückgegeben werden sollen

Beschreibung

Fügt links (am Anfang) einer Zeichenfolge ein Füllzeichen hinzu, bis die Zeichenfolge enthält n Zeichen. Zeichenfolgen mit n oder mehr Zeichen werden gekürzt auf n Zeichen.

LPadChar(str, " ", n)ist das gleiche wie LPad(str, n)Siehe die LPad Funktion.

Beispiele

LPadChar(1234567, "0", 10);
// Returns "0001234567"
LPadChar(1234567, ".0", 10);
// Returns "...1234567"

LTrim

Erklärung

string LTrim(string str)

Syntax

LTrim(<str>)

Erforderliche Parameter

• str: Eine Zeichenfolge

Beschreibung

Entfernt Leerzeichen (Leerzeichen, Tabulatoren) links (am Anfang) einer Zeichenfolge und gibt die verbleibenden Zeichen zurück.

Beispiele

LTrim(" Hello World!  ");
// Returns "Hello World!  "

LTrim("    Hello World!");
// Removes the leading tab character
// and returns "Hello World!"

LTrimChars

Erklärung

string LTrimChars(string str, string trimChars)

Syntax

LTrimChars(<str>, <trimChars>)

Erforderliche Parameter

• str: Eine Zeichenfolge, die von links (dem Anfang) abgeschnitten werden soll**
  
• trimChars: Eine Zeichenfolge mit abzugleichenden Trimmzeichen; die Reihenfolge spielt keine Rolle

Beschreibung

Entfernt alle führenden Zeichen in einer Zeichenfolge von links (dem Anfang), die mit denen in den Trimmzeichen übereinstimmen, und gibt die verbleibenden Zeichen zurück.

Diese Funktion prüft jedes führende Zeichen einer Zeichenfolge, beginnend am linken Rand, und prüft, ob es in den Trimmzeichen gefunden wird. Wenn dies der Fall ist, wird es entfernt und der Vorgang wiederholt, bis keine Übereinstimmung mehr vorliegt.

Dies kann verwendet werden, um andere Zeichen als die standardmäßigen Leerzeichen zu trimmen, z. B. führende Doppelpunkte.

Siehe auch die RTrimChars Und TrimChars Funktionen.

Beispiele

LTrimChars("::StartMsg :: Hello :: EndMsg::", ":");
// Returns "StartMsg :: Hello :: EndMsg::"

LTrimChars("// This is a comment", " /");
// Returns "This is a comment"

LTrimChars("// This is a comment", "/ ");
// Returns "This is a comment"

LTrimChars("// This is a comment", "/");
// Returns " This is a comment"

LTrimChars("// This is a comment", " ");
// Returns "// This is a comment"
// Returns the string unchanged as a space
// was not a leading character

Mid

Erklärung

string Mid(string str, int m, int n)

Syntax

Mid(<str>, <m>, <n>)

Erforderliche Parameter

• str: Eine Zeichenfolge, aus der eine Teilzeichenfolge extrahiert werden soll

• m: Die nullbasierte Startzeichenposition, um mit dem Extrahieren der Teilzeichenfolge zu beginnen

• n: Die Länge (Anzahl der Zeichen) der zu extrahierenden Teilzeichenfolge

Beschreibung

Gibt einen Teil einer Zeichenfolge zurück, beginnend mit dem Zeichen an Position m für eine Länge von n Zeichen.

Siehe auch die Left Und Right Funktionen.

Beispiele

Mid("Jitterbit", 2, 3);
// Returns "tte"

Mid("01234567890", 7, 3);
// Returns "789"

// Passing the same string as an
// integer with a leading zero
// returns a different result
Mid(01234567890, 7, 3);
// Returns "890"

ParseURL

Erklärung

array ParseURL(string url)

Syntax

ParseURL(<url>)

Erforderliche Parameter

• url: Ein String, der eine URL zum Parsen enthält

Beschreibung

Analysiert eine URL Zeichenfolge und gibt ein Array dekodierter Werte zurück. Die Werte sind markiert, sodass sie entweder nach Index oder nach Feldnamen abgerufen werden können.

Beim Abrufen von Werten aus dem Ergebnis wird die Groß-/Kleinschreibung eines Feldnamens ignoriert. Siehe auch URLDecode Und URLEncode Funktionen.

Beispiele

url = "http://hostname/user?email=john1990%40example.com&name=John%20Smith";
arr = ParseURL(url);

email = arr[0];
// "email" will be john1990@example.com
email = arr["email"];
// same as previous

name = arr["name"];
// "name" will be "John Smith"
name = arr["Name"];
// Same as previous;
// case is ignored for field names

Quote

Erklärung

string Quote(string str)

Syntax

Quote(<str>)

Erforderliche Parameter

• str: Eine Zeichenfolge, die in einfache Anführungszeichen gesetzt werden soll

Beschreibung

Setzt eine Zeichenfolge in einfache Anführungszeichen und gibt das Ergebnis zurück. Eingebettete einfache Anführungszeichen werden nicht maskiert.

Beispiele

Quote("Any string");
// Returns "'Any string'"

Quote("Ain't escaped");
// Returns "'Ain't escaped'" -- note that the embedded quote is not escaped.

RegExMatch

Erklärung

int RegExMatch(string str, string exp[, type var1,... type varN])

Syntax

RegExMatch(<str>, <exp>[, <var1>,... <varN>])

Erforderliche Parameter

• str: Eine Zeichenfolge, mit der abgeglichen werden soll

• exp: Ein regulärer Ausdruck, der aus Gruppen besteht

Optionale Parameter

• var1...varN: Ein oder mehrere Variablennamen, die den markierten Unterausdrücken des Ausdrucks zugeordnet werden sollen

Beschreibung

Gleicht einen regulären Ausdruck mit einer Eingabezeichenfolge ab, speichert die markierten Unterausdrücke in Variablen und gibt die Anzahl der Übereinstimmungen zurück.

Gibt die Gesamtzahl der markierten Unterausdrücke zurück (die höher oder niedriger als die tatsächlich angegebene Anzahl von Variablen sein kann). Alle zusätzlichen Übereinstimmungen, die die angegebene Anzahl von Variablen überschreiten, werden verworfen. Wenn keine Übereinstimmungen vorhanden sind, -1 wird zurückgegeben.

Der reguläre Ausdruck folgt der Boost-Syntax der regulären Ausdrücke. Es handelt sich um eine Variante der Perl-Syntax für reguläre Ausdrücke.

Unicode-Zeichen, einschließlich Symbole wie Emoji, müssen mit ihren Literalzeichen und nicht mit Unicode-Escape-Sequenzen abgeglichen werden. Beispielsweise der Bereich "[😀-🤯]" (U+1F600 bis U+1F92F) erfasst erfolgreich das dazwischenliegende Symbol 🤔 (U+1F914).

Siehe auch die RegExReplace Funktion.

Beispiele

result = RegExMatch("[abc]", "(\\[)(.*)(\\])", "dummy", "value");
// Sets the global variable "$dummy" to "[".
// Sets the global variable "$value" to "abc".
// Returns 3 because the character "]" also matched the last sub-expression.
// However, as there are only two variable names, the last match is not saved to a variable.

RegExReplace

Erklärung

string RegExReplace(string str, string exp, string format)

Syntax

RegExReplace(<str>, <exp>, <format>)

Erforderliche Parameter

• str: Eine zu durchsuchende Zeichenfolge, bei der alle übereinstimmenden Teilzeichenfolgen ersetzt werden

• exp: Der reguläre Ausdruck in der Syntax der Boost-Bibliothek für reguläre Ausdrücke zur Suche nach Teilzeichenfolgen der Zeichenfolge

• format: Ein Formatstring in der Boost-Extended Format String Syntax

Beschreibung

Ersetzt alle Teilzeichenfolgen in einer Zeichenfolge, die einem Ausdruck entsprechen, und verwendet dabei ein angegebenes Format zum Ersetzen jeder Teilzeichenfolge. Alle Abschnitte der Zeichenfolge, die nicht mit dem Ausdruck übereinstimmen, werden unverändert an die zurückgegebene Zeichenfolge weitergegeben.

Der reguläre Ausdruck folgt der Syntax der Boost-Bibliothek für reguläre Ausdrücke. Es handelt sich um eine Variante der Perl-Syntax für reguläre Ausdrücke.

Unicode-Zeichen, einschließlich Symbole wie Emoji, müssen mit ihren Literalzeichen und nicht mit Unicode-Escape-Sequenzen abgeglichen werden. Beispielsweise der Bereich "[😀-🤯]" (U+1F600 bis U+1F92F) erfasst erfolgreich das dazwischenliegende Symbol 🤔 (U+1F914).

Die Formatzeichenfolge folgt der [Boost-Extended Format String Syntax(http://www.boost.org/doc/libs/1_66_0/libs/regex/doc/html/boost_regex/format/boost_format_syntax.html). Wenn die Formatzeichenfolge eine leere Zeichenfolge ist ("") dann ergibt eine Übereinstimmung kein Ergebnis für diese Teilzeichenfolge.

Siehe auch die RegExMatch Funktion.

Beispiele

// To remove any whitespace from a string:
RegExReplace(" t e st ss s", "\\s", "");
// Returns "testsss"

// To swap the order of sub-strings:
RegExReplace("abc(first)123(second)xyz",
             "(.*)(\\(.*\\))(.*)(\\(.*\\))(.*)",
             "\\1aaa\\4\\2\\3\\5");
// Returns "abcaaa(second)(first)123xyz"

// To pass backslashes in matches, multiple instances may be required.
// In the "r" example, three backslashes are used and then doubled.
// The first two backslashes convert into a single backslash,
// which then escapes the next backslash.
// All three backslashes are then doubled for Jitterbit script.
s = "test\\ing";  // "test\ing";
t = RegExReplace(s, "\\\\", "!");  // "test\ing" -> "test!ing"
r = RegExReplace(t, "!", "\\\\\\");  // "test!ing" ->  "test\\ing"

Replace

Erklärung

string Replace(string str, string old, string new)

Syntax

Replace(<str>, <old>, <new>)

Erforderliche Parameter

• str: Eine zu durchsuchende Zeichenfolge und deren passende Teilzeichenfolgen ersetzt werden sollen

• old: Eine Zeichenfolge, die für die Übereinstimmung verwendet werden soll

• new: Eine Zeichenfolge, die als Ersatz für alle gefundenen Übereinstimmungen verwendet werden soll

Beschreibung

Durchsucht eine Zeichenfolge nach Teilzeichenfolgen, die dem „alten“ Argument entsprechen, und ersetzt eine übereinstimmende Teilzeichenfolge durch das „neue“ Argument.

Komplexere Such- und Ersetzungsvorgänge finden Sie im RegExReplace Funktion.

Beispiele

Replace("Monday Tuesday", "day", "day night,");
// Returns "Monday night, Tuesday night,"

Right

Erklärung

string Right(string str, int n)

Syntax

Right(<str>, <n>)

Erforderliche Parameter

• str: Eine Zeichenfolge

• n: Die Anzahl der Zeichen vom rechten Ende, die zurückgegeben werden sollen

Beschreibung

Rücksendungen n Zeichen einer Zeichenfolge, gezählt von rechts (vom Ende) einer Zeichenfolge.

Siehe auch die Left Und Mid Funktionen.

Beispiele

Right("01234567890",4);
// Returns "7890"

RPad

Erklärung

string RPad(string s, int n)

Syntax

string RPad(string s, int n)

Erforderliche Parameter

• str: Eine Zeichenfolge

• n: Die Anzahl der Zeichen vom rechten Ende, die zurückgegeben werden sollen

Beschreibung

Fügt rechts (am Ende) einer Zeichenfolge Leerzeichen hinzu, bis die Zeichenfolge enthält n Zeichen. Zeichenfolgen mit n oder mehr Zeichen werden gekürzt auf n Zeichen.

RPad(str, -n)ist das gleiche wie LPad(str, n)Siehe die LPad Funktion.

Beispiele

RPad("01234567",9);
// Returns "01234567 "

RPadChar

Erklärung

string RPadChar(string str, string padChar, int n)

Syntax

RPadChar(<str>, <padChar>, <n>)

Erforderliche Parameter

• str: Eine Zeichenfolge
• padChar: Eine Zeichenfolge, die zum Auffüllen von Zeichen verwendet wird; wenn mehr als ein Zeichen vorhanden ist, wird das erste Zeichen verwendet
• n: Die Anzahl der Zeichen vom rechten Ende, die zurückgegeben werden sollen

Beschreibung

Fügt rechts (am Ende) einer Zeichenfolge ein Füllzeichen hinzu, bis die Zeichenfolge enthält n Zeichen. Zeichenfolgen mit n oder mehr Zeichen werden gekürzt auf n Zeichen.

RPadChar(str, " ", n)ist das gleiche wie RPad(str, n)Siehe die RPad Funktion.

Beispiele

RPadChar(1234567, "0", 10);
// Returns "1234567000"

RTrim

Erklärung

string RTrim(string str)

Syntax

RTrim(<str>)

Erforderliche Parameter

• str: Eine Zeichenfolge

Beschreibung

Entfernt Leerzeichen (Leerzeichen, Tabulatoren) rechts (am Ende) einer Zeichenfolge und gibt die verbleibenden Zeichen zurück.

Beispiele

RTrim(" Hello World!  ");
// Returns " Hello World!"

RTrim("Hello World!    ");
// Removes the trailing tab character
// and returns "Hello World!"

RTrimChars

Erklärung

string RTrimChars(string str, string trimChars)

Syntax

RTrimChars(<str>, <trimChars>)

Erforderliche Parameter

• str: Eine Zeichenfolge, die von rechts (dem Ende) abgeschnitten werden soll**
  
• trimChars:** Eine Zeichenfolge mit abzugleichenden Trimmzeichen; die Reihenfolge spielt keine Rolle

Beschreibung

Entfernt alle nachfolgenden Zeichen in einer Zeichenfolge vom Ende, die mit denen in den Trimmzeichen übereinstimmen, und gibt die verbleibenden Zeichen zurück.

Diese Funktion prüft jedes nachfolgende Zeichen einer Zeichenfolge, beginnend am rechten Rand, und prüft, ob es in den Trimmzeichen gefunden wird. Wenn dies der Fall ist, wird es entfernt und der Vorgang wiederholt, bis keine Übereinstimmung mehr vorliegt.

Dies kann verwendet werden, um andere Zeichen als die standardmäßigen Leerzeichen zu trimmen, z. B. das Trimmen nachfolgender Doppelpunkte.

Siehe auch die LTrimChars Und TrimChars Funktionen.

Beispiele

RTrimChars("::StartMsg :: Hello :: EndMsg::", ":");
// Returns "::StartMsg :: Hello :: EndMsg"

RTrimChars("// This is a comment //", " /");
// Returns "// This is a comment"

RTrimChars("// This is a comment //", "/");
// Returns "// This is a comment "

RTrimChars("// This is a comment //", " ");
// Returns "// This is a comment //"
// Returns the string unchanged as a space
// was not a trailing character

Split

Erklärung

array Split(string str, string delimiter)

Syntax

Split(<str>, <delimiter>)

Erforderliche Parameter

• str: Ein zu teilender String
• delimiter: Eine Zeichenfolge, die als Aufteilung zwischen den einzelnen Array-Elementen abgeglichen werden soll

Beschreibung

Teilt eine Zeichenfolge mithilfe einer Trennzeichenfolge auf und gibt das Ergebnis als Array zurück.

Gibt das Ergebnis in einem Array zurück, dessen Größe der Anzahl der Trennzeichen plus eins entspricht. Wenn der Ausdruck mit dem Trennzeichen endet, entspricht die Arraygröße der Anzahl der Trennzeichen (der letzte leere Wert wird ignoriert). Wenn die Zeichenfolge keine Trennzeichen enthält, wird ein Array der Größe eins zurückgegeben, das die ursprüngliche Zeichenfolge enthält.

Beispiele

arr = Split("Donald,Minnie,Goofy", ",");
donald = arr[0];
minnie = arr[1];
goofy = arr[2];

Split("Donald.,Minnie.,Goofy.,", ".,");
// Returns the array {Donald, Minnie, Goofy}

Dieses Beispiel konvertiert eine IP-Adresse ("10.6.10.1") in eine einzelne Ganzzahl (168167937):

// Logic: (first octet * 16777216) + (second octet * 65536) +
//   (third octet * 256) + (fourth octet)
ip = "10.6.10.1";
ipList = Split(ip, ".");
(Int(ipList[0]) * 16777216) + (Int(ipList[1]) * 65536) +
    (Int(ipList[2]) * 256) + (Int(ipList[3]));

SplitCSV

Erklärung

array Split(string str[, string delimiter, int qualifier])

Syntax

Split(<str>[, <delimiter>, <qualifier>])

Erforderliche Parameter

• str: Ein zu teilender String

Optionale Parameter

• delimiter: Eine Zeichenfolge, die als Aufteilung zwischen den einzelnen Array-Elementen abgeglichen werden soll
• qualifier: Eine Zeichenfolge, die als Aufteilung zwischen den einzelnen Array-Elementen abgeglichen werden soll

Beschreibung

Teilt einen CSV-formatierten String auf und gibt ein Array mit den einzelnen Spaltenwerten zurück.

Standardmäßig ist das Trennzeichen ein Komma (,) und der String-Qualifizierer ein doppeltes Anführungszeichen ("). Dies kann durch Angabe des optionalen zweiten bzw. dritten Arguments geändert werden.

Beispiele

arr = SplitCSV('"Donald","Minnie ""The Mouse""", Goofy');
donald = arr[0];
// Returns "Donald"
minnie = arr[1];
// Returns "Minnie ""The Mouse"""
goofy = arr[2];
// Returns "Goofy"

StringLength

Erklärung

int StringLength(string str)

array StringLength(array arr)

Syntax

StringLength(string str)

StringLength(array arr)

Erforderliche Parameter

• str: (Erste Form) Eine Zeichenfolge

• arr: (Zweite Form) Ein Array

Beschreibung

Gibt die Länge einer Zeichenfolge zurück.

Die Funktion gibt ein Array zurück, wenn das Argument ein Array ist, wobei jedes Element des zurückgegebenen Arrays die Länge des entsprechenden Elements des Argument-Arrays hat. Die Length Funktion gibt die Länge eines Arrays zurück, nicht die Länge der einzelnen Elemente.

Beispiele

arr = {a="abcd", b="e"};

StringLength(arr);
// Returns the array {4,1}

Length(arr);
// Returns 2

ToLower

Erklärung

string ToLower(string str)

Syntax

ToLower(<str>)

Erforderliche Parameter

• str: Eine Zeichenfolge

Beschreibung

Konvertiert alle ASCII-Großbuchstaben (A bis Z, ASCII 65 bis 90) in einer Zeichenfolge in Kleinbuchstaben.

Beispiele

ToLower("Hello World!");
// Returns "hello world!"

ToProper

Erklärung

string ToProper(string str)

Syntax

ToProper(<str>)

Erforderliche Parameter

• str: Eine Zeichenfolge

Beschreibung

Konvertiert eine Zeichenfolge in Groß- und Kleinschreibung (der erste Buchstabe jedes Worts wird groß geschrieben). Dies unterscheidet sich von der Groß- und Kleinschreibung von Titeln, bei der nur ausgewählte und längere Wörter in einer Zeichenfolge groß geschrieben werden.

s = "mccartney, paul";
s = Right( ToProper( " " + s), Length(s));

Beispiele

ToProper("bob dylan");
// Returns "Bob Dylan"
ToProper("arthur c. Clarke");
// Returns "Arthur C. Clarke"
ToProper("Peter o'toole");
// Returns "Peter O'Toole"

ToUpper

Erklärung

string ToUpper(string <str>)

Syntax

ToUpper(<str>)

Erforderliche Parameter

• str: Eine Zeichenfolge

Beschreibung

Konvertiert alle ASCII-Kleinbuchstaben (a bis z, ASCII 97 bis 122) in einer Zeichenfolge in Großbuchstaben.

Beispiele

ToUpper("Hello World!");
// Returns "HELLO WORLD!"

Trim

Erklärung

string Trim(string str)

Syntax

Trim(<str>)

Erforderliche Parameter

• str: Eine Zeichenfolge

Beschreibung

Entfernt Leerzeichen am Anfang und Ende einer Zeichenfolge und gibt die verbleibenden Zeichen zurück.

Beispiele

Trim(" Hello World! ");
// Returns "Hello World!"

TrimChars

Erklärung

string TrimChars(string str, string trimChars)

Syntax

TrimChars(<str>, <trimChars>)

Erforderliche Parameter

• str: Eine zu kürzende Zeichenfolge
• trimChars: Eine Zeichenfolge mit abzugleichenden Trimmzeichen; die Reihenfolge spielt keine Rolle

Beschreibung

Entfernt alle führenden oder nachfolgenden Zeichen in einer Zeichenfolge, die mit denen in den Trimmzeichen übereinstimmen, und gibt die verbleibenden Zeichen zurück.

Diese Funktion prüft jedes führende und nachfolgende Zeichen einer Zeichenfolge und prüft, ob es in den Trimmzeichen gefunden wird. Wenn dies der Fall ist, wird es entfernt und der Vorgang wiederholt, bis keine Übereinstimmungen mehr vorliegen.

Dies kann verwendet werden, um andere Zeichen als die standardmäßigen Leerzeichen zu trimmen, z. B. das Trimmen von Doppelpunkten.

Siehe auch die LTrimChars Und RTrimChars Funktionen.

Beispiele

TrimChars("::StartMsg :: Hello :: EndMsg::", ":");
// Returns "StartMsg :: Hello :: EndMsg"

TrimChars("/* This is a comment */", " /*");
// Returns "This is a comment"

Truncate

Erklärung

string Truncate(string str, int firstChars, int lastChars)

Syntax

Truncate(<str>, <firstChars>, <lastChars>)

Erforderliche Parameter

• str: Eine Zeichenfolge
• firstChars: Die Anzahl der Zeichen, die links (am Anfang) der Zeichenfolge gelöscht werden sollen
• lastChars: Die Anzahl der Zeichen, die rechts (vom Ende) der Zeichenfolge gelöscht werden sollen

Beschreibung

Löschungen firstChar Zeichen von links (dem Anfang) und lastChars Zeichen von rechts (vom Ende) einer Zeichenfolge und gibt die verbleibende Zeichenfolge zurück.

Siehe auch die Left Und Right Funktionen.

Beispiele

Truncate("a,b,c,", 2, 1);
// Returns "b,c"

URLDecode

Erklärung

string URLDecode(string url, string paramName)

Syntax

URLDecode(<url>, <paramName>)

Erforderliche Parameter

• url: Eine Zeichenfolge, die eine URL enthält
• paramName: Der Name eines Parameters in der URL, dessen Wert zurückgegeben werden soll

Beschreibung

Analysiert eine URL Zeichenfolge und gibt den dekodierten Wert des URL Parameters mit dem angegebenen Namen zurück. Die Groß-/Kleinschreibung des Namens wird ignoriert. Wenn der Name nicht in den Parametern der URL gefunden wird, wird eine leere Zeichenfolge ("") wird zurückgegeben.

Siehe auch die ParseURL Und URLEncode Funktionen.

Beispiele

url = "http://hostname/user?email=john1990%40gmail.com&name=John%20Smith";
URLDecode(url, "name");
// Returns "John Smith"

URLEncode

Erklärung

string URLEncode(string str[, int encodingOption])

Syntax

URLEncode(<str>[, <encodingOption>])

Erforderliche Parameter

• url: Eine Zeichenfolge, die einen Wert enthält, der nach den Regeln von RFC 1738 kodiert werden soll

Optionale Parameter

• encodingOption: Eine Ganzzahl (0 - 3), die die zu verwendende Kodierung angibt. Der Standardwert ist 0. Siehe die Liste unten.

Beschreibung

Kodiert eine Zeichenfolge gemäß RFC 1738.

Gültige Werte für die optionale Kodierungsoption sind:

• 0: Standard URL Kodierung. Kodiert ASCII-Steuerzeichen, Nicht-ASCII-Zeichen, „reservierte“ Zeichen und „unsichere“ Zeichen. Dies ist die Standardkodierung, wenn die Option weggelassen wird.
• 1: Kodieren Sie keine „unsicheren“ Zeichen: „\< ;> ; # % { } | \ ^ \~ [ ] ` and the space character
• 2: Don't encode "reserved" characters: ; / ? : @ & =
• 3: Don't encode "unsafe" characters and "reserved" characters

These characters are considered "safe" and are never encoded: $ - _. + ! * ' ( ) ,

See also the URL analysieren and URLDecode-Funktionen.

Beispiele

value1 = "FIRST#"; value2 = "<LAST>";
url = "http://hostname/get_doc?" +
    "name1=" + URLEncode(value1) +
    "&name2=" + URLEncode(value2);
// Returns
// http://hostname/get_doc?name1=FIRST%23&name2=%3CLAST%3E