詳談WML Script標準函數庫

2024-09-05 20:54:48

字體：大中小

來源：轉載

供稿：網友

　這節會討論標準的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;