Zeichenkettenfunktionen

Name

Zweck

Argumente

Rückgabewert

Beispiel

PrintToString

Speichert das Ergebnis eines ”Drucken” Befehls in eine Zeichenkette

Mehrere Argumente, dieselbe Syntax wie der Befehl "print"

STRING

s:=printToString ("DSP.MEASM = ", DSP.MEASM);

StringCharAt

Fragt das Zeichen einer Zeichenkette an einer spezifizierten Position ab.

1: STRING: zu bearbeitende Zeichenkette

2: INTEGER: Position (beginnend mit 1)

CHAR

c2:=stringCharAt (s, 2);

StringComp

Vergleicht zwei Zeichenketten unter Berücksichtigung von Klein- und Großschreibung

1: STRING:
2: STRING:

INTEGER:
0 wenn beide Zeichenketten identisch 

-1 wenn Zeichenkette 1 lexikalisch vor Zeichenkette 2,

1 wenn Zeichenkette 1 lexikalisch nach Zeichenkette 2

i:=stringComp ("abc","ABC");
ergibt, weil der ASCII-Code für  ”a”  > ASCII Code für ”A” ist

StringCompNoCase

Vergleicht zwei Zeichenketten ohne Berücksichtigung von Klein- und Großschreibung

1: STRING:
2: STRING:

INTEGER:
0 wenn beide Zeichenketten identisch (bis aufKlein- und Großschreibung),

-1 wenn Zeichenkette 1  lexikalisch vor Zeichenkette 2,

1 wenn Zeichenkette 1 lexikalisch nach Zeichenkette 2

i:=stringCompNoCase ("abc", "ABC");
ergibt 0

StringDelete

Löscht bestimmte Zeichen aus einer Zeichenkette

1: STRING: zu bearbeitende Zeichenkette

2: INTEGER: Position (beginnend mit 1)

3: INTEGER (optional): Anzahl der zu löschenden Zeichen (Standard ist 1)

STRING: modifizierte Zeichenkette

s:=stringDelete ("ABC", 2);
ergibt ”AC”

s:=stringDelete ("ABCDEF", 3, 2);
ergibt ”ABEF”

StringFind

Findet eine Teilzeichenkette in einer größeren Zeichenkette

1: STRING: zu bearbeitende Zeichenkette

2: STRING: zu findende Teilzeichenkette

3: INTEGER (optional): Startposition für die Suche (Standard ist 1)

INTEGER: Position, an der die Teilzeichenkette beginnt (beginnend mit 1),

0 wenn die Teilzeichenkette  nicht gefunden wird

i:=stringFind ("ABC", "C");
ergibt 3
i:=stringFind ("ABCABC", "BC", 4);
ergibt 5

StringFindOneOf

Findet das erste passende Zeichen eines Satzes

1: STRING: zu bearbeitende Zeichenkette

2: STRING: Satz von Zeichen, nach denen gesucht wird

INTEGER: Position mit dem ersten Auftreten eines Zeichens aus dem Zeichensatz,

0 wenn die Zeichenkette kein Zeichen aus dem Satz enthält

i:=stringFindOneOf ("ABC", "HFB");
ergibt 2,
i:=stringFindOneOf ("ABC", "XYZ");
ergibt  0

StringInsert

Fügt eine Teilzeichenkette an einer vorgegebenen Position innerhalb der Zeichenkette ein.

1: STRING: zu bearbeitende Zeichenkette

2: INTEGER: Position, an der die Zeichenkette eingefügt wird (beginnend mit 1)

3: STRING: einzufügende Zeichenkette

STRING: modifizierte Zeichenkette

s:=stringInsert ("ABC", 1, "XY"); ergibt  ”XYABC”

StringLeft

Extrahiert den linken Teil einer Zeichenkette

1: STRING: zu bearbeitende Zeichenkette

2: INTEGER: Anzahl der zu extrahierenden Zeichen

STRING: extrahierte Zeichenkette

s:=stringLeft ("ABC", 2);
ergibt  ”AB”

StringLen

Fragt die Länge einer Zeichenkette ab.

1: STRING: zu bearbeitende Zeichenkette

INTEGER: Länge der Zeichenkette (0 für eine leere Zeichenkette)

i:=stringLen ("ABCDEF");
ergibt  6

StringLower

Verwandelt eine Zeichenkette in Kleinbuchstaben (schließt deutsche Umlaute ein)

1: STRING: zu bearbeitende Zeichenkette

STRING: modifizierte Zeichenkette

s:=stringLower ("ABC");
ergibt  ”abc”

StringMid

Extrahiert einen spezifizierten Teil einer Zeichenkette.

1: STRING: zu bearbeitende Zeichenkette

2: INTEGER: Position, an der Extraktion beginnen soll (beginnend mit 1)

3: INTEGER (optional): Anzahl der zu extrahierenden Zeichen, wenn –1, wird der Restbestand der Zeichenkette extrahiert (Standard)

STRING: extrahierte Zeichenkette

s:=stringMid ("ABCDEF", 4);
ergibt  ”DEF”
s:=stringMid("ABCDEF", 4, 2);
ergibt  ”DE”

StringReplace

Ersetzt angezeigte Zeichen einer Zeichenkette durch die spezifizierten Zeichen.

1: STRING: zu bearbeitende Zeichenkette

2: STRING: zu ersetzende Zeichenkette

3: STRING: Ersatz

STRING: modifizierte Zeichenkette

s:=stringReplace ("ABCABC", "B", "XY");
ergibt  ”AXYCAXYC”

StringReverse

Kehrt die Reihenfolge der Zeichen in der Zeichenkette um.

1: STRING: zu bearbeitende Zeichenkette

STRING: umgekehrte Zeichenkette

s:=stringReverse ("ABC");
ergibt  ”CBA”

StringRight

Extrahiert den rechten Teil einer Zeichenkette.

1: STRING: zu bearbeitende Zeichenkette

2: INTEGER: Anzahl der zu extrahierenden Zeichen

STRING: extrahierte Zeichenkette

s:=stringRight ("ABC", 2);
ergibt  ”BC”

StringSpanExcluding

Extrahiert eine Untermenge, die nur die Zeichen enthält, die nicht in einer Menge vorhanden sind.

1: STRING: zu bearbeitende Zeichenkette

2: STRING: Menge der Zeichen, die das Ende der Extraktion anzeigen

STRING: extrahierte Zeichenkette

s:=stringSpanExcluding ("ABC.DEF", ".,;" );
ergibt  ”ABC”

StringSpanIncluding

Extrahiert eine Untermenge, die nur die Zeichen enthält, die in einer Menge vorhanden sind.

1: STRING: zu bearbeitende Zeichenkette

2: STRING: Menge der Zeichen, die in der extrahierten Zeichenkette erlaubt sind

STRING: extrahierte Zeichenkette

s:=stringSpanIncluding ("45;48;52", "0123456789" );
ergibt  ”45”

StringTrim

Entfernt Leerzeichen am Beginn und am Ende einer Zeichenkette.

1: STRING: zu bearbeitende Zeichenkette

STRING: modifizierte Zeichenkette

s:=stringTrim("  ABC  ");
ergibt  ”ABC”

StringTrimLeft

Entfernt Leerzeichen am Beginn einer Zeichenkette.

1: STRING: zu bearbeitende Zeichenkette

STRING: modifizierte Zeichenkette

s:=stringTrimLeft("  ABC  ");
ergibt  ”ABC  ”

StringTrimRight

Ordnet Entfernt Leerzeichen am Ende einer Zeichenkette.

1: STRING: zu bearbeitende Zeichenkette

STRING: modifizierte Zeichenkette

s:=stringTrimRight("  ABC  ");
ergibt  ”  ABC”

StringUpper

Verwandelt eine Zeichenkette in obere Großbuchstaben (schließt deutsche Umlaute ein, aber ”ß” bleibt unverändert).

1: STRING: zu bearbeitende Zeichenkette

STRING: modifizierte Zeichenkette

s:=stringUpper("abc");
ergibt  ”ABC”