WMLScript Standard Libraries: The Lang Library - Part II

WMLScript Standard Libraries

The Lang Library - Part II

These are the rest of the functions in the Lang library:

`maxInt()`

This function returns the maximum integer value.

Syntax	maxInt()
Parameters	none
Returns	Integer (2147483647)
Examples:	`var a = Lang.maxInt(); // a = 2147483647`

`minInt()`

This function returns the minimum integer value.

Syntax	minInt()
Parameters	none
Returns	Integer (-2147483648)
Examples:	`var a = Lang.minInt(); // a = -2147483648`

`float()`

This function returns true if floating-point numbers are supported, and false otherwise. Note, some systems do not support floating-point numbers.

Syntax	float()
Parameters	none
Returns	Boolean
Examples:	`var a = Lang.float();`

`exit()`

This function ends the interpretation of the WMLScript bytecode and returns to its caller with a given return value. This function usually is used to perform a normal exit from a function in cases where the execution of the WMLScript bytecode should be terminated.

Syntax	exit(value)
Parameters	value = Any
Returns	value
Examples:	`Lang.exit("Script Ends with " + result); // Returns a string` `Lang.exit(invalid); // Returns invalid`

`abort()`

This function aborts the interpretation of the WMLScript bytecode and returns to its caller with a given return message. This function usually is used to perform an abnormal exit from a function in cases where the execution of the WMLScript bytecode should be terminated. invalid is returned if the parameter is not a string value.

Syntax	abort(value)
Parameters	value = String
Returns	value or `invalid` if value is not a string.
Examples:	`Lang.abort("Script aborts with " + result); // Returns a string` `Lang.abort(invalid); // Returns invalid`

`random()`

This function returns a random integer between 0 and the given parameter. If the given parameter is a floating-point number, it is first converted to an integer using Float.int().

Syntax	random(value)
Parameters	value = Number
Returns	integer, `0` if value = `0`, `invalid` if value is less than `0` or not a number.
Examples:	`a = Lang.random(8.2); // a = 0..8` `b = Lang.random("foobar"); // b = invalid`

`seed()`

This function initializes the random number generator with the given parameter, and returns an empty string. If the given parameter is a floating-point number, it is first converted to an integer using Float.int(). If the given parameter is negative or not a number, system-dependent initialization is used.

Syntax	seed(value)
Parameters	value = Number
Returns	integer or `invalid`.
Examples:	`a = Lang.seed(8.2); // a = ""` `b = Lang.seed("foobar"); // b = invalid` (random seed left unchanged)