Die Lang-Bibliothek stellt dem WMLScript-Programmierer eine Sammlung von Funktionen zur Verfügung, die bei der Programmierung sehr hilfreich sein können. Eine Zuordnung der Funktionen zu einem bestimmten Themengebiet kann bei dieser Bibliothek nicht gemacht werden.

Die Funktion abort(...) bricht die Ausführung des WMLScriptes abnormal ab.

Funktionskopf	:	abort(Fehlermeldung)
Parameter	:	Fehlermeldung  Zeichenkette
Rückgabewert	:	kein Rückgabewert

Beispiel :

Lang.abort("Fehler !");

Die Funktion abs(...) liefert den absoluten Wert des ihr übergebenen Wertes zurück.

Funktionskopf	:	abs(Wert)
Parameter	:	Wert  numerischer Wert
Rückgabewert	:	numerischer Wert oder invalid

Beispiel :

var x = Lang.abs(-5);   // --> x = 5
var x = Lang.abs(-7.4); // --> x = 7.4

Die Funktion characterSet(...) gibt den Zeichensatz zurück, der vom WML-Interpreter unterstützt wird.

Funktionskopf	:	characterSet()
Parameter	:
Rückgabewert	:	integer Wert

Beispiel :

var cs = Lang.characterSet(); // --> z.B. cs = 4 für latin1

Die Funktion exit(...) beendet die Ausführung des WMLScriptes normal, im Gegensatz zu abort(...)

Funktionskopf	:	exit(Wert)
Parameter	:	Wert  beliebiger Wert
Rückgabewert	:	kein Rückgabewert

Beispiel :

Lang.exit("Programm beendet");
Lang.exit(7);

Mit der Funktion float(...) kann überprüft werden, ob Fließkommazahlen unterstützt werden. Werden Fließkommazahlen unterstützt, so ist der Rückgabewert true ansonsten false.

Funktionskopf	:	float()
Parameter	:
Rückgabewert	:	true oder false

Beispiel :

var supft = Lang.float(); // --> supft = true oder false

Die Funktion isFloat(...) überprüft, ob der ihr übergebene Wert sich in eine Fließkommazahl konvertieren lässt. Ist eine Konvertierung möglich so wird true zurückgegeben, falls nicht, ist der Rückgabewert false. Werden Fließkommazahlen nicht unterstützt, so wird der Wert invalid zurückgegeben. Die Funktion isFloat(...) bedient sich bei der Konvertierung in eine Fließkommazahl der Funktion parseFloat(...).

Funktionskopf	:	isFloat(Wert)
Parameter	:	Wert  beliebiger Wert
Rückgabewert	:	true, false oder invalid

Beispiel :

var x = Lang.isFloat("4.7"); // -> x = true
var y = Lang.isFloat("WML"); // -> y = false

Die Funktion isInt(...) überprüft, ob der ihr übergebene Wert sich in einen integer Wert (Ganzzahl) konvertieren lässt. Ist eine Konvertierung möglich so wird true zurückgegeben, falls nicht, ist der Rückgabewert false. Die Funktion isInt(...) bedient sich bei der Konvertierung in einen integer Wert der Funktion parseInt(...).

Funktionskopf	:	isInt(Wert)
Parameter	:	Wert  beliebiger
Rückgabewert	:	true, false oder invalid

Beispiel :

var x = Lang.isInt("3");     // --> x = true
var y = Lang.isInt("3.333"); // --> y = true
var z = Lang.isInt("WML");   // --> z = false

Die Funktion max(...) ermittelt das Maximum aus den beiden ihr übergebenen Werten Wert1 und Wert2.

Funktionskopf	:	max(Wert1,Wert2)
Parameter	:	Wert1  numerischer Wert  Wert2  numerischer Wert
Rückgabewert	:	numerischer Wert oder invalid

Beispiel :

var x = Lang.max(10,18); // --> x = 18

Die Funktion maxInt(...) gibt die größte mögliche integer Zahl zurück. Diese hat nach IEEE754 den Wert 2147483647.

Funktionskopf	:	maxInt()
Parameter	:
Rückgabewert	:	integer Wert

Beispiel :

var x = Lang.maxInt(); // --> x = 2147483647

Die Funktion min(...) ermittelt das Minimum aus den beiden ihr übergebenen Werten Wert1 und Wert2.

Funktionskopf	:	min(Wert1,Wert2)
Parameter	:	Wert1  numerischer Wert  Wert2  numerischer Wert
Rückgabewert	:	numerischer Wert oder invalid

Beispiel :

var x = Lang.min(10,18); // --> x = 10

Die Funktion minInt(...) gibt die kleinste mögliche integer Zahl zurück. Diese hat nach IEEE754 den Wert -2147483648.

Funktionskopf	:	minInt()
Parameter	:
Rückgabewert	:	integer Wert

Beispiel :

var x = Lang.minInt(); // --> x = -2147483648

Die Funktion parseFloat(...) wandelt den ihr übergebenen String in eine Fließkommazahl um und gibt diese zurück. Der String wird bis zum ersten Zeichen abgearbeitet, daß nicht Bestandteil einer Fließkommazahl sein kann. Scheitert das Konvertieren zu einer Fließkommazahl, so ist der Rückgabewert invalid.

Funktionskopf	:	parseFloat(String)
Parameter	:	String  (Zahl)Zeichenkette
Rückgabewert	:	Fließkommazahl oder invalid

Beispiel :

var x = Lang.parseFloat("500.72");      // --> x = 500.72
var y = Lang.parseFloat(" +2.11e2 XY"); // --> y = 2.11e2
var z = Lang.parseFloat("WML")          // --> invalid

Die Funktion parseInt(...) wandelt den ihr übergebenen String in einen integer Wert um und gibt diesen zurück. Der String wird bis zum ersten Zeichen abgearbeitet, daß nicht Bestandteil eines integer Wertes sein kann. Scheitert das Konvertieren zu einem integer Wert, so ist der Rückgabewert invalid.

Funktionskopf	:	parseInt(String)
Parameter	:	String  (Zahl)Zeichenkette
Rückgabewert	:	integer Wert oder invalid

Beispiel :

var x = Lang.parseInt("1810");    // --> x = 1810
var y = Lang.parseInt("180 kmh"); // --> y = 180

Die Funktion random(...) gibt eine zufällig gewählten integer Wert zurück, der zwischen 0 und einschließlich dem Wert liegt, der ihr übergeben wurde.

Funktionskopf	:	random(Wert)
Parameter	:	Wert  numerischer Wert
Rückgabewert	:	integer Wert oder invalid

Beispiel :

var x = Lang.random(100); // -->  x = eine Zahl zwischen 0 und 100

Die Funktion seed(...) initialisiert den Zufallsgenerator mit dem übergebenen Wert, der für die Funktion random(...) benötigt wird. Falls der Wert einen nicht numerischen Ausdruck darstellt wird invalid zurückgegeben, ansonsten eine leere Zeichenkette.

Funktionskopf	:	seed(Wert)
Parameter	:	Wert  numerischer Wert
Rückgabewert	:	leere Zeichenkette oder invalid

Beispiel :

Lang.seed(40);