Table of topic groups > Front page of help pages > Help pages > 4. Help for TM WMLScript menu

4. Help for TM WMLScript menu

Topics

• Common
• Function keywords
• Function list
• Other help pages

Common

In this page is short explanations to WMLScript functions. I hope that someone could Help for create better explanations. TM WMLScript plugin has both the keyword list and the function list of standard libraries. WMLScript has also additional libraries like Debug and WTAPublic (WTA = Wireless Telephone Applications), which are not listed in this menu. The latter gives the possibility to create and use phone call databases and services by using the Wireless Telephone Applications Interface. You can find information about them from the Wap Forum.

In principle WMLScript can be much more flexible language than for example JavaScript 1.1, because it can use function libraries. Functions, which are marked as extern create quite the same kind of mechanism as import + extends in Java. The keyword extern create in practice public classes. Indeed unlike in Java the function library name must be used in function names (for example WMLScript - String.compare() >< compare() - Java), because WMLScript has no reference to function libraries in the import statement (if imported classes have same method names, also in Java it is necessary to use library names).

Function keywords

Don't use used or reserved names in your as names of you own variables or functions (some of the reserved names might be used in the version, which you use today).

Following words should not be used as names in own variables and functions because of forward compatible parsing:

Function list

Information types in functions are: integer, floating-point, string, boolean (true or false) and invalid. Function list with short explanations:

• The dialogs library:
  • Dialogs.alert() = create an alert message
  • Dialogs.confirm() = create a confirmation dialog
  • Dialogs.prompt() = create a prompt dialog
• The float library:
  • Float.ceil() = return equal or nearest bigger integer
  • Float.floor() = return equal or nearest smaller integer
  • Float.int() = return the integer part of the value
  • Float.maxFloat() = display the biggest possible value
  • Float.minFloat() = display the smallest possible value
  • Float.round() = return the nearest value as integer
  • Float.pow() = the first value into the potency of the second
  • Float.sqrt() = count the square root
• The lang library:
  • Lang.Abort() = end function (used in error handling)
  • Lang.Abs() = return the absolute value of the parameter
  • Lang.CharacterSet() = return the characterset
  • Lang.Exit() = exit function
  • Lang.float() = test if the device support floating numbers
  • Lang.isFloat() = test if the parameter can be parsed into floating numbers
  • Lang.isInt() = test if the parameter can be parsed into integers
  • Lang.max() = return the maximum value
  • Lang.maxInt() = return the maximum integer value
  • Lang.min() = return the minimum value
  • Lang.minInt() = return the minimum integer value
  • Lang.parseFloat() = return floating number
  • Lang.parseInt() = return integers
  • Lang.parseRandom() = return random values
  • Lang.seed() = initialize and return random values
• The String library:
  • String.charAt() = return the value of transmitted string + integer
  • String.compare() = compare two strings (first smaller = -1)
  • String.elementAt() = return the value of transmitted element + integer
  • String.elements() = return the number of elements
  • String.find() = find a string
  • String.format() = format strings according a string (d = integer, f = floating-point, s = string)
  • String.insertAt() = return a new string to a defined place (four variables)
  • String.isEmpty() = test if the string is empty
  • String.Lenght() = display the length of the string
  • String.removeAt() = remove a string from a defined place (four variables)
  • String.replace() = replace a substring with another substring (three variables)
  • String.replacetAt() = replace a string with another string with an index (four variables)
  • String.squeeze() = remove repeated strings
  • String.substring() = return a new string, which starts a defined place
  • String.toString() = ensure that parameters are handled as string
  • String.trim() = remove extra spaces before and after a string
• The URL library:
  • URL.escapeString() = encode string as URL
  • URL.getBase() = return the absolute URL
  • URL.getFragment() = get the part after #
  • URL.getHost() = get the host name
  • URL.getParameter() = get transmitted parameters
  • URL.getPath() = get the URL path
  • URL.getPort() = get the the number of the connection port
  • URL.getQuery() = get the used query string
  • URL.getReferer() = get back the shortest relative path
  • URL.getSheme() = return the used protocol
  • URL.isValid() = test if the URL format is valid
  • URL.LoadString() = return the contents of URL
  • URL.resolve() = return address, which join the base and relative address
  • URL.unescape() = return a string with unescaped characters
• The Wmlbrowser library:
  • WMLBrowser.getCurretCard() = return the address of the current card
  • WMLBrowser.getVar() = locate the setting of variables
  • WMLBrowser.go() = move to another address
  • WMLBrowser.newContext() = delete history
  • WMLBrowser.prev() = go to the previous card
  • WMLBrowser.refresh() = update the document
  • WMLBrowser.setVar() = set new values to variables

Other help pages

• Help for TM WML menu
• Help for TM WAPPush menu
• Help for TM CSS menu (An introduction to CSS with frames; In Finnish).
• Help for TM XSLT menu
• Help for HTML ALL menu
• Help for Perl menu