分享
 
 
 

线标记语言(WML)之Script函数库

王朝other·作者佚名  2008-05-31
窄屏简体版  字體: |||超大  

这节会讨论标准的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

6.3 Float函数库

名称:Float

说明:这个函数库包含了典型与常用的浮点数算术程序。

int

程序:int(value)

说明:回传给予值的整数部分。

参数:value=数字

回传值:整数或invalid

例外状况:无

范例:var a =3.14;

var b =Float.in(a); //b=3

var c =Float.in(-2.8); //c=-2

floor

程序:floor(value)

说明:回传整数值,这个只要最接近给予值但不能大于它。

如果value已经是个整数,其结果就是这个值本身。

参数:value=数字

回传值:整数或invalid

例外状况:无

范例:var a =3.14;

var b =Float.in(a); //b=3

var c =Float.in(-2.8); //c=-3

ceil

程序:ceil(value)

说明:回传一个只要最接近给予值但不能小于它的整数值。

如果value已经是个整数,其结果就是这个值本身。

参数:value=数字

回传值:整数或invalid

例外状况:无

范例:var a =3.14;

var b =Float.in(a); //b=4

var c =Float.in(-2.8); //c=-2

pow

程序:pow(x,y)

说明:回传x的y次方值。

如果x是负数,则y必须为正数。

参数:x=数字

y=数字

回传值:浮点数或invlid

例外状况:如果x= =0而且 y<0,则回传invalid

如果x<0而且y不是个整数,则回传invalid

范例:var a =3

var b =Float.pow(a,2); //b=9

round

程序:round(value)

说明:传回最接近给予值的整数

若两个整数值跟value接近的程序相等,则选择比较大的数。

若value已经是个正数,其结果就是value本身。

参数:value=数字

回传值:整数或invalid

例外状况:无

范例:var a=Float.round(3.5); // a=4

var b=Float.round(-3.5); //b=-3

var c=Float.round(0.5); // c=1

var d=Float.round(-0.5); //d=0

squt

程序:sqrt(value)

说明:传回给予值value的平方根近似值。

参数:value=浮点数

回传值:浮点数或invalid

例外状况:如果value负数,则回传invlid

范例:var a=4;

var b=Float.squt(a); //b=2.0

var c=Float.squt(5); //c=2.2360679775

maxFloat

程序:maxFloat()

说明:传回IEEE 754所支持的但准浮点数格式中最大的浮点数值。

参数:无

回传值:浮点数3.40282347E+38

例外状况:无

范例:var a=Float.maxFloat();

minFloat

程序:minFloat()

说明:传回IEEE 754所支持的但准浮点数格式中最小的浮点数值。

参数:无

回传值:浮点数1.17549435E-38

例外状况:无

范例:var a=Float.minFloat();

6.4 string函数库

名称:字符串

说明:这个函数库包含了字符串程序的集合,一个字符串可以是字符数组,每个字符都有个索引,字符串的第一个字浮的索引为0,字符串的长度是字符在数组中的数目。

你能使用一些特殊的分隔符号来界定不同的字符串,这样你就能存取这些有分隔符号予元素索引所界定出的元素,字符串中第一个元素的索引值为0,每个字符串分隔符号回分隔出两个元素,但字符是不能用来做分隔符号。

一个空格的字符可能是下列字符其中之一:

TAB:水平跳格定位(horizontal tabulation)

VT:垂直跳格定位(ertival tabulation)

FF:跳页(from feed)

SP:空格(space)

LF:跳行(line feed)

CR:归位(carriage return)

length

程序:length(string)

说明:传回给予字符串的长度(字符的数目)。

参数:string=字符串

回传值:整数或invalid

例外状况:无

范例:var a="ABC";

var b=string.length(a); //b=3

var c=string.length(""); //c=0

var d=string.length(342); //d=3

is Empty

程序:is Empty(string)

说明:如果字符串长度为零则传回布尔值true,反之传回false。

参数:string=字符串

回传值:布尔值或invalid

例外状况:无

范例:var a="Hello;

var b="";

var c=sting.isEmpty(a); //c=false

var c=sting.isEmpty(b); //d=ture

var c=sting.isEmpty(ture); //e=false

charAt

程序:charAt(sting.index)

说明:回传string中index值所指定的字符。

参数:string=字符数

index=数字(回传回index所指定的字符)

回传值:字符串或invalid

例外状况:如果index的值超过字符串的范围,则回传空字符串("")

范例:var a="My name is Joe"

var b=sting.charAt(a,0); //b= "M"

var c=sting.charAt(a,100); //c= ""

var d=sting.charAt(34.0); //d="3"

var e=sting.charAt(a,"first"); //e=invalid

subString

程序:subString(string,startIndex,length)

说明:传回一个新的字符串来代替所给予的字符串, 这个新字符串给定的索引值开始,它的长度有所给予的length决定。

如果startIndex小于0,则会0来当作索引值。

如果length大于剩余字符的数目,则lenght会由剩余的字符数来代替。

如果startIndex予lenght是浮点数,则会先使用Float.int()来计算正确的整数值。

参数:string=字符数

startIndex=数字

lenght=数字

回传值:字符串或invalid

例外状况:如果startIndex大于最后的索引值,则回传会空字符串("")

如果lenght<=0,传会空字符串("")

范例:var a="ABCD";

var b=String.subString(a,1,2); //b="BC"

var c=String.subString(a,2,5); //c="CD"

var d=String.subString(1234,0,2); //d="12"

find

程序:find(string,substring)

说明:传会所要寻找的字符串substring和原始字符串string相符的第一个字符的索引值。

如果没有相符,则传会整数值-1。

两个字符传如果是相等的话,是定义为不符合。

参数:string=字符串

substring=字符串

回传值:整数或invalid

例外状况:无

范例:var a="abcde";

var b=String.find(a,"cd"); //b=2

var c=String.find(34.2,"de"); //c=-1

var d=String.find(a,"gz"); //d=-1

var e=String.find(34,"3"); //e=0

replace

程序:eplace(tring,oldSubString,newSubString)

说明:传会新字符串,这个新字符串是由和所给予字符串string相符的旧字符传oldSubString使用新字符串newSubString字符串加以代替。如果两字符串相等的话,定义为相符。

参数:string=字符串

oldSubString=字符串

newSubString=字符串

回传值:字符串或invalid

例外状况:无

范例:var a="Hello Joe.What is up Joe?";

var newName="Don";

var oldName="Joe";

var c=String.replace(a,oldName,newName); //c="Hello Don.What is up Don?"

var d=String.replace(a,oldName,newName); //c="Hello Don.What is up Don?"

element

程序:element(string,separator)

说明:回传分隔符号separator所分隔的字符串string的元素数目,空字符串("")是有效的元素,这表示了这程序永远不会回传一个小于或等于0得值。

参数:string=字符串

separator=字符串

回传值:整数或invalid

例外状况:如果separator是个空字符串,则回传invalid

范例:var a="My name is Joe;Age 50";

var b=String.elements(a,"");//b=6

var c=String.elements(a,";");//c=3

var d=String.elements("",";");//d=1

var e=String.elements("a","");//e=1

var f=String.elements(";",";");//f=2

var g=String.elements(";;,;",";,");//g=4

separator=;

elementAt

程序:elementAt(string,index,separator)

说明:寻找字符串string的第index个元素,这些元素是由分隔符号separator所加以分开,并回传相对应的元素。

如果index值小于0,则回传第一个元素。

如果index值大于元素的数目,则回传最后一个元素。

如果字符串为空字符串,则回传空字符串。

如果index值为浮点数,则须先使用Float.int()来计算出正确的索引值。

参数:string=字符串

index=数字

separator=字符串

回传值:字符串或invalid

例外状况:如果separator是个空字符串,则回传invalid

范例:var a="Hello Joe.What is up Joe?";

var b=String.elementAt(a,0,""); //b="My"

var b=String.elementAt(a,14,";"); //c=" "

var b=String.elementAt(a,1,";"); //d="Age 50"

removeAt

程序:removeAt(string,index,separator)

说明:将符合索引值index的分隔号separator与元素有字符串string中移出,并回传这个新字符串。

如果index值小于0,则回传第一个元素。

如果index值大于元素的数目,则回传最后一个元素。

如果字符串为空字符串,则回传空字符串。

如果index值为浮点数,则须先使用Float.int()来计算出正确的索引值。

参数:string=字符串

element=字符串

index=数字

separator=字符串

回传值:字符串或invalid

例外状况:如果separator是个空字符串,则回传invalid

范例:var a=" A A;B C D";

var s= "";

var c=String.removeAt(a,1,s); //b="A B C D"

var d=String.removeAt(a,0,";"); //c=" B C D"

var e=String.removeAt(a,14,";"); //d="A A"

replaceAt

程序:replaceAT(string,index,separator)

说明:在特定的index中的元素,使用所给予的元素element来代替,并回传这个新字符串。

如果index值小于0,则回传第一个元素。

如果index值大于元素的数目,则回传最后一个元素。

如果字符串为空字符串,则回传空字符串。

如果index值为浮点数,则须先使用Float.int()来计算出正确的索引值。

参数:string=字符串

element=字符串

index=数字

separator=字符串

回传值:字符串或invalid

例外状况:如果separator是个空字符串,则回传invalid

范例:var a= "B C; E";

var s="";

var d=String.replaceAT(a,"A",0,s); //b="A C;E"

var e=String.replaceAT(a,"F",5,";"); //d="B C;F"

InsertAt

程序:insertAt(string,index,separator)

说明:将元素element与相对应的分隔符号separator插入与原始字符串string,在特定的element中的元素

如果index值小于0,则0会用来当索引值。

如果index值大于元素的数目,则元素element会附加上字符串string的为端。

如果字符串string为空字符串,则回传包含所给予元素element的新字符串。

如果index值为浮点数,则需先使用Float.int()来计算出正确的索引值。

参数:string=字符串

element=字符串

index=数字

separator=字符串

回传值:字符串或invalid

例外状况:如果separator是个空字符串,则回传invalid

范例:var a= "B C; E";

var s="";

var b=String.insertAt(a,"A",0,s); //b="A B C;E"

var c=String.insertAt(a,"X",3,s); //c="B C;E X"

var d=String.insertAt(a,"D",1,";"); //d="B C;D;E"

var e=String.insertAt(a,"F",5,";"); //e="B C;E;F"

squeeze

程序:squeeze(string)

说明:将字符串string中所有连续的空格减少为一个空格。

参数:stromg=字符串

回传值:字符串或invalid

例外状况:无

范例:var a="Hello";

var b="Bye Jon.See you!";

var c=String.squeeze(a); //c="Hello"

var d=String.squeeze(b); //d="Bye Jon.See you!"

trim

程序:trim(string)

说明:将字符串string中所有开头与连续的空格删除。

参数:string=字符串

回传值:字符串或invalid

例外状况:无

范例:var a="Hello";

var b="Bye Jon.See you!";

var c=String.squeeze(a); //c="Hello"

var d=String.squeeze(b); //d="Bye Jon.See you!"

compare

程序:compare(string,string2)

说明:这个程序的回传值会指出string1与string2在语汇上关系,这个关系是基于自然字集的字符码之间,其回传值如下:

如果string1小于string2,传会-1。

如果string1等于string2,传会-1。

如果string1大于string2,传会-1。

参数:string1=字符串

string2=字符串

回传值:整数或invalid

例外状况:无

范例:var a="Hello";

var b="Hello";

var c=String.compare(a,b); //c=0

var d=String.compare("Bye","Jon"); //d=-1

var e=String.compare("Jon","Bye"); //e=1

toString

程序:toString(value)

说明:回传一个能表示所给予的值value的字符串,这个程序跟WML Script的转换是一样的,除了invlaid值会回传一个"invalid"字符串。

参数:value=任意值

回传值:字符串

例外状况:无

范例:var a=string.toString(12); // a="12"

var a=string.toString(true); // b="true"

format

程序:format(format,value)

说明:将给予的值value转换成字符串,并依照所给予的格式format提供的格式化的字符串,这个格式字符串只能由一种特定格式,并能放置于字符串的任何地方,如果超过一种以上的格式需要使用,则能会使用最左边的格式,至于其他格式则有空字符串代替,这些格式如下:

[width][.precision]type

width参数为非负的是近制整数,这个参数控制与显现字符的最小数目,如果输出的字数小于指定的宽度width,则会在字符串的左边加上空白,直到符合最小宽度的要求,width参数永远不会是值value被删减,如果输出的字数大于特定的宽度或并没指定宽度的话,value中所有的字符都会被显现。

precision参数是个非负的十进制整数,这个引号之前必须限价上(.)的符号,其目的是用来设定输入值的精确度,这个值的解议会跟给予的格式有关:

d 界定数字最小的显现数目,如果value中数字的数目超过precision的值,输入值会在其左边加上0,如果数字的数目超过precision值,value的值并不会被删减,预设的precision值为1,如果precision值设定为0,而且value页被转换成0,则结果将是一个空字符串。

f 界定十进制小数后的数字数目,如果十进制的小数点出现了,在小数点之后至少要有一位数,这个值会被四舍五入到近似的数字数值,预设的precision为6,如果precision为0或小数点(.)后没有数字,则不会显现小数点,当value值的小数点后数字数目小于precision的值,字母0为被加入直到填满栏位(如:String.format("%2.3f",1.2)会是"1.200")

s 界定字符所要显现的最大数目,预设值是显现所有的字符,当width值大于precision值,width值是可以忽略的,跟width值不同的是,precision只可能会造成浮点数值的四舍五入或输入值的删减。

type参数是唯一格式的参数,他出现在任何的格式栏为选项之后,type字符决定了所给予的value将会解译成整数,浮点数或字符串,支持的type参数如下:

d 整数:输入值的格式[-]dddd,这里的dddd是一个或以上的十进制数字。

f 浮点数:输入值的格式[-]dddd.dddd,这里的dddd是一个或以上的十进制数字,在小数点之前的数字数目和数字的大小有关,小数点之后的数字数目和精确度有关。

s 字符串:字符的显现跟精确度有关。

百分比字符(%)在格式字符串中能使用额外的百分比字符加以表示(%%)。

参数:format=字符串

value=任意值

回传值:字符串或invalid

例外状况;无效的格式会回传invalid值。

范例:var a=45;

var b=-45;

var c="now";

var d=1.2345678;

var e=String.format("e:%6d",a); //e="e:45"

var e=String.format("%6d",b); //f="-45"

var e=String.format("e:%6d",a); //g="0045"

var e=String.format("%6.4d",b); //h="-0045"

var e=String.format("Do it %s",c); //i="Do it now"

var e=String.format("%3f",d); //j="1.2345678"

var e=String.format("%10.2f%%",a); //k="1.23%."

var e=String.format("%3f %2f",a); //l="1.234567."

var e=String.format("%.0d",0); //m=""

var e=String.format("%.7d","Int"); //n="invalid"

var e=String.format("%s",ture); //o="ture"

(出处:http://www.knowsky.com)

 
 
 
免责声明:本文为网络用户发布,其观点仅代表作者个人观点,与本站无关,本站仅提供信息存储服务。文中陈述内容未经本站证实,其真实性、完整性、及时性本站不作任何保证或承诺,请读者仅作参考,并请自行核实相关内容。
2023年上半年GDP全球前十五强
 百态   2023-10-24
美众议院议长启动对拜登的弹劾调查
 百态   2023-09-13
上海、济南、武汉等多地出现不明坠落物
 探索   2023-09-06
印度或要将国名改为“巴拉特”
 百态   2023-09-06
男子为女友送行,买票不登机被捕
 百态   2023-08-20
手机地震预警功能怎么开?
 干货   2023-08-06
女子4年卖2套房花700多万做美容:不但没变美脸,面部还出现变形
 百态   2023-08-04
住户一楼被水淹 还冲来8头猪
 百态   2023-07-31
女子体内爬出大量瓜子状活虫
 百态   2023-07-25
地球连续35年收到神秘规律性信号,网友:不要回答!
 探索   2023-07-21
全球镓价格本周大涨27%
 探索   2023-07-09
钱都流向了那些不缺钱的人,苦都留给了能吃苦的人
 探索   2023-07-02
倩女手游刀客魅者强控制(强混乱强眩晕强睡眠)和对应控制抗性的关系
 百态   2020-08-20
美国5月9日最新疫情:美国确诊人数突破131万
 百态   2020-05-09
荷兰政府宣布将集体辞职
 干货   2020-04-30
倩女幽魂手游师徒任务情义春秋猜成语答案逍遥观:鹏程万里
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案神机营:射石饮羽
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案昆仑山:拔刀相助
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案天工阁:鬼斧神工
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案丝路古道:单枪匹马
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案镇郊荒野:与虎谋皮
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案镇郊荒野:李代桃僵
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案镇郊荒野:指鹿为马
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案金陵:小鸟依人
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案金陵:千金买邻
 干货   2019-11-12
 
推荐阅读
 
 
 
>>返回首頁<<
 
靜靜地坐在廢墟上,四周的荒凉一望無際,忽然覺得,淒涼也很美
© 2005- 王朝網路 版權所有