第六章 WML Script标准函数库（上）

答案：这节会讨论标准的wml script函数库。
　　6.1 wml script规则
　　这些标准函数库提供一个扩展wml script语言的机制，这些特定的函数库必须遵循wml script的规则。
　　支持的数据格式
　　下面的wml script格式使用于程序的定义之中，这样能记录程序参数与回转值的格式。
　　boolean
　　integer
　　float
　　string
　　invalid
　　除此之外，如果整数与浮点数参数值格式都能接受的话，则能使用number来记录参数格式，如果使用的格式是所支持的格式，则能用any来记录。
　　数据格式转换
　　函数库程序发生错误的处理方式和wml script语言一样。
　　invalid程序参数会产生invalid的回传值。
　　程序的参数无法转成所需要使用参数格式，则会产生invalid的回传值。
　　与程序相关的错误得出回传一个适当的错误码，至于这个值就要看每个程序如何定义。
　　6.2 lang函数库
　　名称：lang
　　说明：这个函数库所含的程序同wml script语言的核心有很密切的关系。
　　abs
　　程序：abs（value）
　　说明：回传给予数的绝对值。
　　如果给予的数是整数，则回传整数。
　　如果给予的数是浮点数，则回传浮点数。
　　参数：value=数字。
　　回传值：数字或invalid。
　　例外状况：var a =-3;
　　var b =lang.abs(a)；//b=3
　　min 
　　范例：var a = -3
　　var b = lang.abs(a); 
　　var c = lang.min(a.b);
　　var d = lang.min(45、76.3);//d=45(ingteger)
　　var e = lang.min(45、76.3);//e=45(ingteger)
　　max
　　程序：max（value1,value2）
　　说明：回传值给予的两个数之间的较大值，回传的值于格式同所选数值的值与格式相同，其选取的方式如下：
　　wml script运算符数据格式的整数与浮点数转换法则可用来确认数据格式，以便执行比较的动作。
　　参数：value1 =数字
　　value2 =数字
　　回传值：数字或invalid
　　例外状况：无
　　范例：var a =-3;
　　var b =lang.abs(a)；//b=3
　　var c = lang.min(a.b);
　　var d = lang.min(45、76.3);//d=45(ingteger)
　　var e = lang.min(45、76.3);//e=45(float)
　　parseint
　　程序：parseint(value)
　　说明：回传由字符串value所定义的整数值，合法的整数语法由wml script数值字符串文法或是近值整数是字所界定，下列为额外的解析法则：
　　第一个字符不是由+、-或十进制数字当开头的话，解译结束。
　　结果：解析过的字符串回转换整数值。
　　范例：var i =lang.parseint("1234"); // i=1234
　　var j =lang.parseint("100 m/s"); // j=100
　　parsefloat
　　程序：parsefloat(value)
　　说明：回传由字符串value所定义的浮点数值，合法的浮点数语法由wml script数值字符串文法或是近值整数实字所界定，下列为额外的解析法则：
　　第一个字符无法解析成浮点数表达式，解析结束。
　　结束：解析过的字符串回转换成浮点数。
　　参数：value=字符串
　　回传值：浮点数或invalid
　　例外状况：解析错误则传回invalid
　　范例：var a =lang.parsefloat("123.7 hz"); // a=123.7
　　var b =lang.parsefloat("7.34e2 hz"); // b=7.34e2
　　var c =lang.parsefloat("70.0e-2 f"); // c=70.0e-2
　　var d =lang.parsefloat("-1.c"); // d=0.1
　　var e =lang.parsefloat("100"); // e=100.0
　　var f =lang.parsefloat("number:5.5"); // f=invalid
　　var g =lang.parsefloat("7.3e meters"); // g=invalid
　　var h =lang.parsefloat("7.3e- m/s"); // h=invalid
　　isint
　　程序：isint(value)
　　说明：如果各预的值value能使用parseint(value)转成整数则回传布尔值ture，否则传回false。
　　参数：value=任意值
　　回传值：布尔值或invalid
　　例外状况：无
　　范例：var a=lang.inint("-123"); //ture
　　var a =lang.minint("123.33"); //ture
　　var a =lang.minint("string"); //false
　　var a =lang.minint("#123"); //false
　　var a =lang.minint("invalid"); //invalid
　　isfloat
　　程序：isfloat(value)
　　说明：如果各预的值value能使用parseint(value)转成整数则回传布尔值ture，否则传回false。
　　参数：value=任意值
　　回传值：布尔值或invalid
　　例外状况：无
　　范例：var a=lang.inint("-123"); //ture
　　var a =lang.minint("123.33"); //ture
　　var a =lang.minint("string"); //false
　　var a =lang.minint("#123"); //false
　　var a =lang.minint("invalid"); //invalid
　　maxint
　　程序：maxint()
　　说明：传回最大的整数值。
　　参数：无
　　回传值：整数2147483647
　　例外状况：无
　　范例：var a =lang.minint（）;
　　minint
　　程序：minint()
　　说明：传回最小的整数值
　　参数：无
　　回传值：整数-2147483647
　　例外状况：无
　　范例：var a =lang.minint();
　　float
　　程序：float()
　　说明：如果有支持浮点数的话传回ture,没有的话传回false。
　　参数：无
　　回传值：布尔值
　　例外状况：无
　　范例：var floatssupported = lang.float();
　　exit
　　程序：exit(value)
　　说明：结束wml script位码的解译然后回到调用wml script解译器者的控制，并回传指定值value,你可以使用这个程序来执行由一般程序的结束，而且wml script位码的执行必须停止。
　　参数：valre=任意值
　　回传值：无，这个程序结束解译
　　例外状况：无
　　范例：lang.exit("value:" + myval);//returns a string
　　lang,exit(invalid);// returns invalid
　　abort
　　程序：abort(errordescription)
　　说明：中止wml script位码的解译然后回到调用wml script解译器者的控制，并回传errordescription,你能使用这个程序执行不正常的中止，调用程序者检测到有严重错误，wml script的执行并须中断。
　　如果errordescription的格式为invalid,字符串invalid用代替errordescription的使用。
　　参数：errordescription =字符串
　　回传值：无，这个程序结束解译
　　例外状况：无
　　范例：lang.abort("error:" + errval); // error value string
　　radndom
　　程序：random(value)
　　说明：回传一个正数的整数值，也就是说要大于或等于零，但必须要小于给定值value,回传值是由近是正常分布所随机选取的值。