推薦：WML教程之文本框控件Input
WML教程之文本框控件Input

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"

分享：無線標記語言(WML)基礎之WMLScript 基礎
無線標記語言(WML)基礎之WMLScript 基礎