WML-Tutorial
[ Inhaltsverzeichnis ]WMLScript
 String-Bibliothek
Grundlagen der String-Bibliothek
charAt(...)
compare(...)
elements(...)
elementAt(...)
find(...)
format(...)
insertAt(...)
isEmpty(...)
length(...)
removeAt(...)
replace(...)
replaceAt(...)
squeeze(...)
subString(...)
toString(...)
trim(...)

Grundlagen der String-Bibliothek

Die String-Bibliothek enthält, wie ihr Name schon sagt, viele nützliche Funktionen für den Umgang mit Zeichenketten.
Eine Zeichenkette wird als eine Aneinanderreihung von einzelnen Zeichen angesehen, wobei jedes Zeichen einen Index sprich eine bestimmte Position in der Zeichenkette hat. Das erste Zeichen in einer Zeichenkette ist an der Position 0.
Weiterhin kann der User bei mehreren Funktionen aus der String-Bibliothek ein Trennzeichen angeben, welches eine Zeichenkette in eine Liste von Elementen aufteilt.


charAt(...)

Die Funktion charAt(...) gibt eine Zeichenkette zurück, die aus dem einzelnen Zeichen an dem Index Position aus dem übergebenen String besteht. Ist die übergebene Position grösser als die Länge des Strings, so wird eine leere Zeichenkette zurückgegeben.

Funktionskopf 

 : 

 charAt(String,Position)

 

 

 

Parameter 

 : 

 String

 Zeichenkette

 Position

 numerischer Wert

 

 

 

Rückgabewert 

 : 

 Zeichenkette oder invalid

Beispiel :


var x = String.charAt("WML-Tutorial",0); // --> x = "W";
var x = String.charAt("WML-Tutorial",4); // --> x = "T";

compare(...)

Die Funktion compare(...) vergleicht die ihr übergebenen Zeichenketten String1 und String2 lexikographisch miteinandern. Ist String1 kleiner als String2, so ist der Rückgabewert -1. Sollten die beiden Zeichenketten String1 und String2 identisch sein, so wird 0 zuückgegeben. Im Falle, daß String1 grösser als String2 ist, gibt die Funktion den Wert 1 zurück.

Funktionskopf 

 : 

 compare(String1,String2)

 

 

 

Parameter 

 : 

 String1

 Zeichenkette

 String2

 Zeichenkette

 

 

 

Rückgabewert 

 : 

 integer Wert oder invalid

Beispiel :


var x = String.compare("WAP","WML"); // --> x = -1
var y = String.compare("WML","WML"); // --> y = 0
var z = String.compare("WML","WAP"); // --> z = 1


elements(...)

Die Funktion elements(...) interpretiert die ihr übergebene Zeichenkette String als eine Liste von Elementen, die durch das Trennzeichen aufgeteilt ist, und liefert als Rückgabewert die Anzahl dieser Elemente. Da die leere Zeichenkette auch als Element interpretiert wird, liefert diese Funktion immer einen Wert, der grösser oder gleich 1 ist. Sollte die Zeichenkette Trennzeichen mehr als ein Zeichen enthalten, so dient als Trennzeichen das erste Zeichen von ihr.

Funktionskopf 

 : 

 elements(String,Trennzeichen)

 

 

 

Parameter 

 : 

 String

 Zeichenkette

 Trennzeichen

 Zeichenkette

 

 

 

Rückgabewert 

 : 

 integer Wert oder invalid

Beispiel :


var x = String.elements("WML;Tutorial;WMLScript;WAP",";"); // --> x = 4
var y = String.elements("WML;Tutorial;WMLScript;WAP","#"); // --> x = 1

elementAt(...)

Die Funktion elementAt(...) liefert das Element zurück, welches sich in der Zeichenkette String, die durch das Trennzeichen in eine Liste von Elementen aufgeteilt wurde, an dem Index Position befindet. Ist der Wert von Position kleiner als 0, dann wird der das erste Element zurückgegeben. Sollte der Wert von Position grösser als die Anzahl der Elemente sein, so wird das letzte Element zurückgegeben. Die Funktion hat als Rückgabewert invalid, falls das Trennzeichen die leere Zeichenkette ist.

Funktionskopf 

 : 

 elementAt(String,Position,Trennzeichen)

 

 

 

Parameter 

 : 

 String

 Zeichenkette

 Position

 numerischer Wert

 Trennzeichen

 Zeichenkette

 

 

 

Rückgabewert 

 : 

 Zeichenkette oder invalid

Beispiel :


var x = String.elementAt("WML;Tutorial;WMLScript;WAP",1,";");  // --> x = "Tutorial"
var y = String.elementAt("WML;Tutorial;WMLScript;WAP",-1,";"); // --> y = "WML"
var z = String.elementAt("WML;Tutorial;WMLScript;WAP",10,";"); // --> z = "WAP"


find(...)

Die Funktion find(...) liefert den Index zuück, ab dem die Zeichenkette SubString in der Zeichenkette String enthalten ist. Ist die Zeichenkette SubString nicht in der Zeichenkette String> enthalten, so ist der Rückgabewert dieser Funktion -1. Ist der SubString die leere Zeichenkette, so wird invalid zurückgegeben.

Funktionskopf 

 : 

 find(String,SubString)

 

 

 

Parameter 

 : 

 String

 Zeichenkette

 SubString

 Zeichenkette

 

 

 

Rückgabewert 

 : 

 integer Wert oder invalid

Beispiel :


var x = String.find("WML-Tutorial","ria"); // --> x = 8
var y = String.find("WML-Tutorial","rpk"); // --> y = -1

format(...)

Die Funktion format(...) wandelt den ihr übergebenen Wert in eine Zeichenkette um, und formatiert die Ausgabe dieser Zeichenkette nach dem im Formatbezeichner spezifizierten Regeln. Der Formatbezeichner ist stark an den Formatbezeichner der printf-Funktion der Programmiersprache C angelehnt.

Funktionskopf 

 : 

 format(Formatbezeichner,Wert)

 

 

 

Parameter 

 : 

 Formatbezeichner

 String

 Wert

 beliebiger Wert

 

 

 

Rückgabewert 

 : 

 Zeichenkette oder invalid


insertAt(...)

Die Funktion insertAt(...) gibt eine neue Zeichenkette zurück, in der die Zeichenkette Element an dem Index Position der alten Zeichenkette String eingefügt wurde. Die Zeichenkette String wird als eine Liste von Elementen intepretiert, die durch das Trennzeichen unterteilt sind. Ist der Wert von Position kleiner oder gleich 0, so wird das die Zeichenkette Element an den Anfang der Zeichenkette String positioniert. Sollte der Wert von Position grösser als die Anzahl der Elemente in der Zeichenkette String sein, so wird die Zeichenkette Element an das Ende der Zeichenkette String gehängt. Der Rückgabewert dieser Funktion ist invalid, wenn das Trennzeichen die leere Zeichenkette ist.

Funktionskopf 

 : 

 insertAt(String,Element,Position,Trennzeichen)

 

 

 

Parameter 

 : 

 String

 Zeichenkette

 Element

 Zeichenkette

 Position

 numerischer Wert

 Trennzeichen

 Zeichenkette

 

 

 

Rückgabewert 

 : 

 Zeichenkette oder invalid

Beispiel :


var x = String.insertAt("Ralf Korte","Peter",1," "); // --> x = "Ralf Peter Korte"

isEmpty(...)

Die Funktion isEmpty(...) überprüft, ob die ihr übergebene Zeichenkette String leer ist. Ist sie leer, so ist der Rückgabewert dieser Funktion true ansonsten false.

Funktionskopf 

 : 

 isEmpty(String)

 

 

 

Parameter 

 : 

 String

 Zeichenkette

 

 

 

Rückgabewert 

 : 

 true, false oder invalid

Erklärung :

nen paar erklärende Worte ...

Beispiel :


var x = String.isEmpty("RPK"); // --> x = true;
var y = String.isEmpty("");    // --> y = false;

length(...)

Die Funktion length(...) gibt die Anzahl der Zeichen der ihr übergebenen Zeichenkette String zurück.

Funktionskopf 

 : 

 length(String)

 

 

 

Parameter 

 : 

 String

 Zeichenkette

 

 

 

Rückgabewert 

 : 

 integer Wert oder invalid

Beispiel :


var x = String.length("WML"); // --> x = 3;
var y = String.length("");    // --> y = 0;
var z = String.length(123);   // --> z = 3;

removeAt(...)

Die Funktion removeAt(...) liefert eine neue Zeichenkette zurück, in der das Element und das Trennzeichen an dem Index Position aus der ihr übergebenen Zeichenkette String entfernt wurde. Die Zeichenkette String wird als eine Liste von Elementen intepretiert, die durch das Trennzeichen unterteilt sind. Ist der Wert von Position kleiner 0, dann wird das erste Element aus der Zeichenkette String gelöscht. Sollte der Wert Position grösser als die Anzahl an Elementen in der Zeichenkette String sein, dann wird das letzte Element der Zeichenkette String entfernt. Die Funktion hat als Rückgabewert invalid, falls das Trennzeichen die leere Zeichenkette ist.

Funktionskopf 

 : 

 removeAt(String,Position,Trennzeichen)

 

 

 

Parameter 

 : 

 String

 Zeichenkette

 Position

 numerischer Wert

 Trennzeichen

 Zeichenkette

 

 

 

Rückgabewert 

 : 

 Zeichenkette oder invalid

Beispiel :


var x = String.removeAt("WML HTML WMLSCRIPT WAP",1," "); // --> x = "WML WMLSCRIPT WAP"

replace(...)

Die Funktion replace(...) gibt eine neue Zeichenkette zurück, bei der alle Vorkommen der Zeichenkette SubString durch die Zeichenkette RepString in der ihr übergebenen Zeichenkette String ersetzt wurden. Ist die Zeichenkette SubString die leere Zeichenkette, dann gibt diese Funktion invalid zurück.

Funktionskopf 

 : 

 replace(String,SubString,RepString)

 

 

 

Parameter 

 : 

 String

 Zeichenkette

 SubString

 Zeichenkette

 RepString

 Zeichenkette

 

 

 

Rückgabewert 

 : 

 Zeichenkette oder invalid

Beispiel :


var x = String.replace("HTML-Tutorial","HTML","WML"); // --> x = "WML-Tutorial"

replaceAt(...)

Die Funktion replaceAt(...) liefert eine neue Zeichenkette zurück, in der das Element an dem Index Position aus der ihr übergebenen Zeichenkette String durch das übergebene Element ersetzt wurde. Die Zeichenkette String wird als eine Liste von Elementen intepretiert, die durch das Trennzeichen unterteilt sind. Ist der Wert von Position kleiner 0, dann wird das erste Element aus der Zeichenkette String ersetzt. Sollte der Wert Position grösser als die Anzahl an Elementen in der Zeichenkette String sein, dann wird das letzte Element der Zeichenkette String ersetzt. Die Funktion hat als Rückgabewert invalid, falls das Trennzeichen die leere Zeichenkette ist.

Funktionskopf 

 : 

 replaceAt(String,Element,Position,Trennzeichen)

 

 

 

Parameter 

 : 

 String

 Zeichenkette

 Element

 Zeichenkette

 Position

 numerischer Wert

 Trennzeichen

 Zeichenkette

 

 

 

Rückgabewert 

 : 

 Zeichenkette oder invalid

Beispiel :


var x = String.replaceAt("WML HTML WAP","WMLSCRIPT",1," "); // --> x = "WML WMLSCRIPT WAP"


squeeze(...)

Die Funktion squeeze(...) gibt eine neue Zeichenkette zurück, in der alle aufeinander folgenden White-Space-Zeichen in der Zeichenkette String durch ein Leerzeichen ersetzt wurden.

Funktionskopf 

 : 

 squeeze(String)

 

 

 

Parameter 

 : 

 String

 Zeichenkette

 

 

 

Rückgabewert 

 : 

 Zeichenkette oder invalid

Beispiel :


var x = String.squeeze("WML         WMLSCRIPT     WAP    "); // --> x = "WML WMLSCRIPT WAP"

subString(...)

Die Funktion subString(...) gibt eine neue Zeichenkette zurück, die eine Teilzeichenkette der ihr übergebenen Zeichenkette String ist. Diese Teilzeichenkette beginnt bei dem Index Position und ist Länge Zeichen lang. Ist der Index Position kleiner als 0 wird als Position genau 0 angenommen. Sollte die Länge länger als die restliche Zeichenkette sein, so dient als Länge die Länge der verbleibenden Zeichenkette.

Funktionskopf 

 : 

 subString(String,Position,Länge)

 

 

 

Parameter 

 : 

 String

 Zeichenkette

 Position

 numerischer Wert

 Länge

 numerischer Wert

 

 

 

Rückgabewert 

 : 

 Zeichenkette oder invalid

Beispiel :


var x = String.subString("WML-Tutorial von Ralf Peter Korte",4,8); // --> x = "Tutorial"

toString(...)

Die Funktion toString(...) wandelt den ihr übergebenen Wert in eine Zeichenkette um. Dies geschieht eigentlich bei jeder Funktion in WMLScript, die als Parameter eine Zeichenkette erwartet. Eine Ausnahme bildet dabei aber invalid, was nicht automatisch in einen String konvertiert wird. Die Funktion toString(...) ermöglicht deshalb genau diese Konvertierung von invalid in eine Zeichenkette "invalid".

Funktionskopf 

 : 

 toString(Wert)

 

 

 

Parameter 

 : 

 Wert

 beliebiger Wert

 

 

 

Rückgabewert 

 : 

 Zeichenkette

Beispiel :


var x = String.toString(invalid); // --> x = "invalid"
var y = String.toString(1018);    // --> y = "1018"
var z = String.toString(false);   // --> z = "false"

trim(...)

Die Funktion trim(...) entfernt alle führenden und am Ende vorkommenden White-Space-Zeichen aus der ihr übergebenen Zeichenkette String.

Funktionskopf 

 : 

 trim(String)

 

 

 

Parameter 

 : 

 String

 Zeichenkette

 

 

 

Rückgabewert 

 : 

 Zeichenkette oder invalid

Beispiel :


var x = String.trim("      WML   WMLSCRIPT   WAP    "); // --> x = "WML   WMLSCRIPT   WAP"