收集的WML Script标准函数库第1/3页

                    这节会讨论标准的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,回传值是由近是正常分布所随机选取的值。
　　参数:value=整数
　　回传值:整数或invalid
　　例外状况:如果value等于0，则程序回传0
　　如果value小于0，则程序回传invalid
　　范例:var a =10;
　　var b =lang.random(5.1)*a;//b=0..50
　　var c = lang.random("string"); // c=invalid
　　reed
　　程序:seed(alue)
　　说明:初始化需随机数字顺序并回传一个空字符串
　　如果value为0或正整数，给予的value则用来初始化，反之则使用随机初始化的值。
　　如果value为浮点数，则会先使用float.int()来计算确切的整数值。
　　参数:value=整数
　　回传值:字符串或invalid]
　　例外状况:无
　　范例:var a =lang.reed(123);// a=""
　　var b =lang.random(20); // b=0..20
　　var c = lang.seed("seed"); // c=invalid (random seed //left unchanged)
　　characterset
　　程序:characterset()
　　说明:回传wml script解译器所支持的字集，回传只是个整数用来记录由iana所设定的mib enum值，这个只能表示所有的字集。
　　参数:无
　　回传值:整数
　　例外状况:无
　　范例:var charset = lang.characterset(); //charset = 4 for latinl

1