[ Inhaltsverzeichnis ] | WMLScript |
String-Bibliothek |
Grundlagen der String-Bibliothek
Die String-Bibliothek enthält, wie ihr Name schon sagt, viele nützliche Funktionen für den Umgang
mit Zeichenketten. |
|||||||||||||||||||||||
Seitenanfang Inhaltsverzeichnis |
|||||||||||||||||||||||
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.
Beispiel : |
|||||||||||||||||||||||
var x = String.charAt("WML-Tutorial",0); // --> x = "W"; var x = String.charAt("WML-Tutorial",4); // --> x = "T"; |
|||||||||||||||||||||||
Seitenanfang Inhaltsverzeichnis |
|||||||||||||||||||||||
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.
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 |
|||||||||||||||||||||||
Seitenanfang Inhaltsverzeichnis |
|||||||||||||||||||||||
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.
Beispiel : |
|||||||||||||||||||||||
var x = String.elements("WML;Tutorial;WMLScript;WAP",";"); // --> x = 4 var y = String.elements("WML;Tutorial;WMLScript;WAP","#"); // --> x = 1 |
|||||||||||||||||||||||
Seitenanfang Inhaltsverzeichnis |
|||||||||||||||||||||||
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.
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" |
|||||||||||||||||||||||
Seitenanfang Inhaltsverzeichnis |
|||||||||||||||||||||||
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.
Beispiel : |
|||||||||||||||||||||||
var x = String.find("WML-Tutorial","ria"); // --> x = 8 var y = String.find("WML-Tutorial","rpk"); // --> y = -1 |
|||||||||||||||||||||||
Seitenanfang Inhaltsverzeichnis |
|||||||||||||||||||||||
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.
|
|||||||||||||||||||||||
Seitenanfang Inhaltsverzeichnis |
|||||||||||||||||||||||
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.
Beispiel : |
|||||||||||||||||||||||
var x = String.insertAt("Ralf Korte","Peter",1," "); // --> x = "Ralf Peter Korte" |
|||||||||||||||||||||||
Seitenanfang Inhaltsverzeichnis |
|||||||||||||||||||||||
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.
Erklärung :nen paar erklärende Worte ... Beispiel : |
|||||||||||||||||||||||
var x = String.isEmpty("RPK"); // --> x = true; var y = String.isEmpty(""); // --> y = false; |
|||||||||||||||||||||||
Seitenanfang Inhaltsverzeichnis |
|||||||||||||||||||||||
length(...)Die Funktion length(...) gibt die Anzahl der Zeichen der ihr übergebenen Zeichenkette String zurück.
Beispiel : |
|||||||||||||||||||||||
var x = String.length("WML"); // --> x = 3; var y = String.length(""); // --> y = 0; var z = String.length(123); // --> z = 3; |
|||||||||||||||||||||||
Seitenanfang Inhaltsverzeichnis |
|||||||||||||||||||||||
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.
Beispiel : |
|||||||||||||||||||||||
var x = String.removeAt("WML HTML WMLSCRIPT WAP",1," "); // --> x = "WML WMLSCRIPT WAP" |
|||||||||||||||||||||||
Seitenanfang Inhaltsverzeichnis |
|||||||||||||||||||||||
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.
Beispiel : |
|||||||||||||||||||||||
var x = String.replace("HTML-Tutorial","HTML","WML"); // --> x = "WML-Tutorial" |
|||||||||||||||||||||||
Seitenanfang Inhaltsverzeichnis |
|||||||||||||||||||||||
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.
Beispiel : |
|||||||||||||||||||||||
var x = String.replaceAt("WML HTML WAP","WMLSCRIPT",1," "); // --> x = "WML WMLSCRIPT WAP" |
|||||||||||||||||||||||
Seitenanfang Inhaltsverzeichnis |
|||||||||||||||||||||||
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.
Beispiel : |
|||||||||||||||||||||||
var x = String.squeeze("WML WMLSCRIPT WAP "); // --> x = "WML WMLSCRIPT WAP" |
|||||||||||||||||||||||
Seitenanfang Inhaltsverzeichnis |
|||||||||||||||||||||||
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.
Beispiel : |
|||||||||||||||||||||||
var x = String.subString("WML-Tutorial von Ralf Peter Korte",4,8); // --> x = "Tutorial" |
|||||||||||||||||||||||
Seitenanfang Inhaltsverzeichnis |
|||||||||||||||||||||||
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".
Beispiel : |
|||||||||||||||||||||||
var x = String.toString(invalid); // --> x = "invalid" var y = String.toString(1018); // --> y = "1018" var z = String.toString(false); // --> z = "false" |
|||||||||||||||||||||||
Seitenanfang Inhaltsverzeichnis |
|||||||||||||||||||||||
trim(...)Die Funktion trim(...) entfernt alle führenden und am Ende vorkommenden White-Space-Zeichen aus der ihr übergebenen Zeichenkette String.
Beispiel : |
|||||||||||||||||||||||
var x = String.trim(" WML WMLSCRIPT WAP "); // --> x = "WML WMLSCRIPT WAP" |
|||||||||||||||||||||||
Seitenanfang Inhaltsverzeichnis |
© 2001 Ralf Peter Korte |