6.5 URL函數庫名稱:URL
說明:這個函數庫包含了處理絕對的URL與相對URL的程序,一般的URL語法如下:
://
:
/
;
?
#
isValid
程序:isValid(url)
說明:如果給予的url值是正確的URL語法,則回傳ture,否則回傳false
絕對與相關URL都能支持
相關URL不會被轉成絕對URL
參數:url=字符串
回傳值:布爾值或invalid
例外狀況:無
范例:var a=URL.isValid
("http://www.acme.com/script#func()"); //a=ture
var b=URL.isValid("../common#test()"); //b=ture
var c=URL.isValid
("experimental?://www.acme.com/pub"); //c=false
getScheme
程序:getScheme(url)
說明:回傳給予url的調用方式scheme
絕對與相關URL都能支持
相關URL不會被轉成絕對URL
參數:url=字符串
回傳值:字符串或invalid
例外狀況:如果遇到不正確的URL語法,則回傳invalid
范例:var a=URL.geScheme("http://w.a.com"); //a="http"
var b=URL.getSceme("w.a.com"); //b=""
getHost
程序:getHost(url)
說明:回傳給予url的主機
絕對與相關URL都能支持
相關URL不會被轉成絕對URL
參數:url=字符串
回傳值:字符串或invalid
例外狀況:如果遇到不正確的URL語法,則回傳invalid
范例:var a=URL.geHost("http://www.acom.com/pub"); //a="www.acm.com"
var b=URL.getHost("path#fray"); //b=""
getPort
程序:getPort(url)
說明:回傳給予url的端口(port)
如果port沒有制定,則回傳空字符串
絕對與相關URL都能支持
相關URL不會被轉成絕對URL
參數:url=字符串
回傳值:字符串或invalid
例外狀況:如果遇到不正確的URL語法,則回傳invalid
范例:var a=URL.getPort("http://www.acom.80/path"); //a="80"
var b=URL.getPort("http://www.acom./path"); //b=""
getPath
程序:getPath(url)
說明:回傳給予url的路徑(path)
參數:url=字符串
回傳值:字符串或invalid
例外狀況:如果遇到不正確的URL語法,則回傳invalid
范例:var a=URL.getPath("http://w.a.com/home/sub/comp#frag"); //a="/home/sub/comp"
var b=URL.getPath("../home/sub/comp#frag"); //b="../home/sub/comp"
getParameters
程序:getParameters(url)
說明:回傳給予url的路徑(parameter)
如果沒有指定參數,則回傳空字符串
絕對與相關URL都能支持
相關URL不會被轉成絕對URL
參數:url=字符串
回傳值:字符串或invalid
例外狀況:如果遇到不正確的URL語法,則回傳invalid
范例:var a=URL.getParameters("http://w.a.c/scr;3;2?x=1&y=3"); //a="3;2"
var b=URL.getParameters("../scr3;2?x=1&y=3"); //b="../home/sub/comp"
getQuery
程序:getQuery(url)
說明:回傳給予url的詢問部分(query)
如果沒有指定的詢問部分,則回傳空字符串
絕對與相關URL都能支持
相關URL不會被轉成絕對URL
參數:url=字符串
回傳值:字符串或invalid
例外狀況:如果遇到不正確的URL語法,則回傳invalid
范例:var a=URL.getParameters("http://w.a.c/scr;3;2?x=1&y=3"); //a="3;2"
getFragment
程序:getFragment(url)
說明:回傳給予url的片斷(fragment)
如果沒有指定片斷,則回傳空字符串
絕對與相關URL都能支持
相關URL不會被轉成絕對URL
參數:url=字符串
回傳值:字符串或invalid
例外狀況:如果遇到不正確的URL語法,則回傳invalid
范例:var a=URL.getFragment("http://www.acom.com/cont#fray"); //a="fray"
getBase
程序:getBase()
說明:回傳次WML Script程序的絕對URL(沒有fragment的部分)。
參數:無
回傳值:字符串
例外狀況:無
范例:var a=URL.getBase(); //Result;
"http://www.acme.com/test.scr"
getReferer
程序:getReferer()
說明:回傳調用目前程序資源的最小相關URL(與目前程序的基本URL的相關)
內部程序調用並不會改變參照者
如果目前的程序並沒有參照者,則回傳空字符串
參數:無
回傳值:字符串
例外狀況:無
范例:var base=URL.getBase(); //base
="http://www.acme.com/current.scr"
var prferer=URL.getReferer(); //referer="app.wml"
resolve
程序:resolve(baseUrl,embeddedUrl)
說明:根據RFC2396的文件,由給予的基本base與插入embeddedUrl回傳絕對URL
參數:baseUrl=字符串
embeddedUrl=字符串
回傳值:字符串或invalid
例外狀況:如果遇到不正確的URL語法,則回傳invalid
范例:var a=URL.resolve(http://www.foo.com/,"foo.vcf"); //a="http://www.foo.com/foo.vcf"
escapeString
程序:escapeString(string)
說明:這個程序會將所給與string字符串之中的特殊字符使用十六進制逃脫序列來替代(你必須使用量為逃脫序列格式%xx),這些逃脫字符如下:
控制字符(control characters):US-ASCII編碼的字符00-1F與7F
空格(Space):US-ASCII碼編字符20十六進制
保留字(Reserved):";"|"/"|"?"|":"|"@"|"="|"+"|"$"|","
Unwise:"{"|"}"|"|"|"/"|""|"["|"]"|"`"
Delimes:"<"|">"|"#"|"%"|"<>"
給予的字符串如果已經是使用逃脫自負,則不會執行URL解析
參數:string=字符串
回傳值:字符串或invalid
例外狀況:如果字符串string含有非US-ASCII的字符,則回傳invalid
范例:var a=URL.escapeString
("http://w.a.c/dck?x=u007ef#crd");
// a="http%3a2f%2fw.a.c%2fdck%3fx%3def%23crd"
unescapeString
程序:unescapeString(string)
說明:這個程序會將所給與string字符串之中每個可能是由URL.escapeString() 程序所產生的逃脫序列使用它所代表的字符加以替代。
參數:string=字符串
回傳值:字符串或invalid
例外狀況:如果字符串string含有非US-ASCII的字符,則回傳invalid
范例:var a="http%3a2f%2fw.a.c%2fdck%3fx%3def%23crd";
var b=URL.unescapeString(a); //b
="http://w.a.c/dck?x=12#crd"
loadString
程序:loadString(url,contentType)
說明:回傳有所給予的絕對URL與contenttype所指出的內容。
如果內容格是不是下列法則所規范的話,則是錯誤的:
你只能界定一種內容格式,整個字符串必須和一種內容格式相符,而 且你不能有額外的前或後空格。
格式必須是正文,但次格式沒有限制,格式的開頭一定是"text/"。
這個程序的動作如下:
文件的內容會載入使用給予的contentType與url,其他所需的數形式有使用用戶界面的預設面。
如果載入成功而且回傳的內為格式與所給予的contentType相符,則內文會被轉換成字符串再回傳。
如果載入成功或回傳的內文格式不正確的話,則會回傳特定的錯誤碼。
參數:url=字符串
contentYype=字符串
回傳值:字符串、整數或invalid
例外狀況:如果載入失敗其回傳的錯誤碼和所使用的URL Scheme有關
如果使用HTTP或WSP架構,會回傳HTTP錯誤碼。
如果給予的contentType錯誤的話,則會回傳invalid
范例:var a="http%3a2f%2fw.a.c%2fdck%3fx%3def%23crd";
var b=URL.unescapeString(a); //b
="http://w.a.c/dck?x=12#crd"
loadString
程序:loadString(url,contentType)
說明:回傳有所給予的絕對URL與contenttype所指出的內容。
如果內容格是不是下列法則所規范的話,則是錯誤的:
你只能界定一種內容格式,整個字符串必須和一種內容格式相符,而 且你不能有額外的前或後空格。
格式必須是正文,但次格式沒有限制,格式的開頭一定是"text/"。
這個程序的動作如下:
文件的內容會載入使用給予的contentType與url,其他內文所需的數形式有使用用戶界面的預設面。
如果載入成功而且回傳的內容為格式與所給予的contentType相符,則內文會被轉換成字符串再回傳。
如果載入成功或回傳的內文格式不正確的話,則會回傳特定的錯誤碼。
參數:url=字符串
contentYype=字符串
回傳值:字符串、整數或invalid
例外狀況:如果載入失敗其回傳的錯誤碼和所使用的URL Scheme有關
如果使用HTTP或WSP架構,會回傳HTTP錯誤碼。
如果給予的contentType錯誤的話,則會回傳invalid
范例:var myUrl="http://www.acme.com/vcards/myaddr.vcf";
myCard=URL.loadString(myUrl,"text/x-vcard");
1 2 3 下一頁
6.7 Dialog函數庫名稱:對話
說明:這個函數庫包含典型的用戶界面程序。
prompt
程序:prompt(message,defaultInput)
說明:顯示給予的信息message與用戶輸入的提示符號,defaultInput參數包含了用戶輸入所需的初始內文,回傳用戶輸入。
參數:message=字符串
defaultInput=字符串
回傳值:字符串或invalid
例外狀況:無
范例:var a="09-555 3456"; var b=Dialogs.prompt("Phome number";a);
confirm
程序:confirm(message,ok,cancel)
說明:顯示所給予的信息message與兩個選項:ok與cancel,等待用戶選取其中一個,如果是ok則回傳false。
參數:message=字符串
ok=字符串
cancel=字符串
回傳值:布爾值invalid
例外狀況:無
范例:function onAbort(){return Dialogs.confirm("Are you sure?"),"Yes","No";};
alert
程序:alert(message)
說明:顯示所給予的信息message給用戶,等待用戶確定並回傳一個空字符串。
參數:message=字符串
回傳值:字符串或invalid
例外狀況:無
范例:function testValue(textElement){
if (String.length(textElement)>8) {
Dialogs.alert("Enter name <8 chars!");
};
};
上一頁 1
2 3 下一頁
6.8 函數庫總結 函數庫
函數庫名稱:
Lang
Float
String
URL
WML Browser
Dialogs
函數庫與他們的程序:
Lang函數庫
Abs
Min
Max
ParseInt
ParseFloat
IsInt
IsFloat
MaxInt
MinInt
Float
Exit
Abort
Random
Seed
CharacterSet
Float 函數庫
Int
Ploor
Ceil
Pow
Round
Sqrt
MaxFloat
MinFloat
String 函數庫
Length
IsEmpty
CharAt
SubString
Pind
Replace
Elements
ElementAt
RemoveAt
ReplaceAt
InsertAt
Squeeze
Frim
Compqre
ToString
format
URL 函數庫
IsValid
GetScheme
GetHost
GetPort
GetPath
GetParameters
GetQuer
GetFragment
GetBase
GetReferer
Resolve
EscapeString
UnescapeString
loadString
WML Browse函數庫
Get Var
SetVar
Go
Prev
NewContext
GetCurrentCard
Refresh
Dialogs函數庫
Prompt
Confirm
Alert
上一頁 1 2
3