Эта библиотека
содержит функции для работы с адресами URL.
Функции библиотеки URL
Функция |
Описание |
escapeString() |
Заменяет
специальные символы в URL управляющей
последовательностью |
getBase() |
|
getFragment() |
Возвращает фрагмент URL |
getHost() |
Возвращает хост, определенный в URL |
getParameters() |
Возвращает параметры в последнем сегменте
пути доступа URL |
getPath() |
Возвращает путь доступа, определенный в URL |
getPort() |
Возвращает номер порта, определенный в URL |
getQuery() |
Возвращает из URL запрос |
getReferer() |
|
getScheme() |
Возвращает из URL схему |
isValid() |
Возвращает true,
если синтаксис URL правильный, и
false в
противном случае |
loadString() |
Возвращает содержимое и тип содержимого,
указанного URL |
resolve() |
Возвращает абсолютный адрес URL на основе
базового и относительного адресов URL |
unescapeString() |
Заменяет
управляющие последовательности в URL на
символы |
Функция escapeString()
Данная функция
заменяет специальные символы в URL управляющей
последовательностью и возвращает результат.
Синтаксис:
n = URL.escapeString(url)
Параметр |
Описание |
n |
Строка,
возвращаемая функцией |
url |
Строка
|
Пример:
var x = URL.escapeString("http://www.intuit.ru/wml/");
Результат:
x =
"http%3a%2f%2fwww.intuit.ru%2fwml%2f"
Функция getFragment()
Данная функция
возвращает фрагмент url с
параметром.
Синтаксис:
n = URL.getFragment(url)
Параметр |
Описание |
n |
Строка,
возвращаемая функцией |
url |
Строка
|
Пример:
var x = URL.getFragment("http://www.intuit.ru/wml#help");
var y = URL.getFragment("http://www.intuit.ru/wml");
Результат:
x = "help"
y = ""
Функция getHost()
Данная функция
возвращает хост (адрес интернет-узла), определенный в
параметре url.
Синтаксис:
n = URL.getHost(url)
Параметр |
Описание |
n |
Строка,
возвращаемая функцией |
url |
Строка
|
Пример:
var a = URL.getHost("http://www.intuit.ru/wml");
var b = URL.getHost("/help/speciality");
Результат:
a = "www.intuit.ru"
b = ""
Функция getParameters()
Данная функция
возвращает параметры из последнего сегмента пути доступа
параметра url.
Синтаксис:
n = URL.getParameters(url)
Параметр |
Описание |
n |
Строка,
возвращаемая функцией |
url |
Строка
|
Пример:
var a =
URL.getParameters("http://www.intuit.ru/speciality;help");
var b = URL.getParameters("http://www.intuit.ru/help");
Результат:
a = "help"
b = ""
Функция WMLScript getPath()
Данная функция
возвращает путь доступа, определенный в параметре
url.
Синтаксис:
n = URL.getPath(url)
Параметр |
Описание |
n |
Строка,
возвращаемая функцией |
url |
Строка
|
Пример:
var x = URL.getPath("http://www.intuit.ru/speciality/help.htm");
var y = URL.getPath("http://www.intuit.ru");
Результат:
x = "/speciality/help.htm"
y = ""
Функция WMLScript getPort()
Данная функция
возвращает номер порта, определенный в параметре
url.
Синтаксис:
n = URL.getPort(url)
Параметр |
Описание |
n |
Строка,
возвращаемая функцией |
url |
Строка
|
Пример:
var x = URL.getPort("http://www.intuit.ru:80");
var y = URL.getPort("http://www.intuit.ru");
Результат:
x = "80"
y = ""
Функция getQuery()
Данная функция
возвращает часть URL, содержащую запрос.
Синтаксис:
n = URL.getQuery(url)
Параметр |
Описание |
n |
Строка,
возвращаемая функцией |
url |
Строка
|
Пример:
var x =URL.getQuery("http://www.intuit.ru/go.asp?name=user");
var y =URL.getQuery("http://www.intuit.ru");
Результат:
x = "user"
y = ""
Функция WMLScript getScheme()
Данная функция
возвращает схему, указанную в URL.
Синтаксис:
n = URL.getScheme(url)
Параметр |
Описание |
n |
Строка,
возвращаемая функцией |
url |
Строка
|
Пример:
var x =
URL.getScheme("www.intuit.ru");
var y = URL.getScheme("http://www.intuit.ru");
var z = URL.getScheme("ftp://www.intuit.ru");
Результат:
x = ""
y = "http"
z = "ftp"
Функция WMLScript isValid()
Данная функция
возвращает булево значение true,
если указанный URL имеет правильный синтаксис, или
значение false - в
противном случае.
Синтаксис:
n = URL.isValid(url)
Параметр |
Описание |
n |
Булево
значение, возвращаемое функцией |
url |
Строка
|
Пример:
var x = URL.isValid("http://www.intuit.ru!!!!");
var y = URL.isValid("http:www.intuit.ru");
var z = URL.isValid("http://www.yandex.ru");
Результат:
x = "false"
y = "false"
z = "true"
Фугкция resolve()
Данная функция
возвращает абсолютный адрес URL на основе указанных
базового и относительного адресов url.
Синтаксис:
n = URL.resolve(baseurl,
relativeurl)
Параметр |
Описание |
n |
Строка,
возвращаемая функцией |
baseurl |
Строка (базовый
url) |
relativeurl |
Строка (относительный
url)
|
Пример:
var x =URL.resolve("http://www.intuit.ru",
"/wml/speciality/help.wml");
Результат:
x = "http://www.intuit.ru/wml/speciality/help.wml"
Функция unescapeString()
Данная функция
заменяет управляющие последовательности в URL на
закодированные ими символы.
Синтаксис:
n = URL.unescapeString(string)
Параметр |
Описание |
n |
Строка,
возвращаемая функцией |
string |
Строка
|
Пример:
var x =URL.unescapeString("http%3a%2f%2fwww.intuit.ru%2wml");
Результат:
x = "http://www.intuit.ru/wml"
Библиотека WMLBrowser
Эта библиотека
содержит функции, которые используются для доступа к
переменным браузера.
Функция |
Описание |
getCurrentCard() |
Возвращает (относительный) адрес URL текущей
карты |
getVar() |
Возвращает значение переменной |
Go() |
Переход к
новой карте |
NewContext() |
Очищает
все переменные |
prev() |
Переход к
предыдущей карте |
refresh() |
Обновляет
текущую карту |
setvar() |
Задает
значение переменной |
Примечание
Спецификация WML
говорит, что обращения к функциям (этой? - Ред.)
библиотеки, которые не поддерживаются браузером, должны
возвращать invalid. В
связи с этим во всех приведенных выше функциях требуется
проверять возвращаемое значение и, в случае получения
invalid , предпринимать
необходимые действия.
Функция getCurrentCard()
Данная функция
возвращает относительный адрес URL текущей карты.
Синтаксис:
n = WMLBrowser.getCurrentCard()
Параметр |
Описание |
n |
Строка,
возвращаемая функцией
|
Пример:
var x =
WMLBrowser.getCurrentCard();
Результат:
x = "first#help"
Функция getVar()
Данная функция
возвращает значение, указанное переменной в контексте
браузера. Если переменная не существует, функция
возвращает пустую строку ("").
Синтаксис:
n = WMLBrowser.getVar(variable)
Параметр |
Описание |
n |
Строка,
возвращаемая функцией |
variable |
Строка |
Пример:
var x =
WMLBrowser.getVar("days");
Результат:
x = "365"
Функция go()
Данная функция
осуществляет переход к новой карте (определенной новым
URL) и возвращает пустую строку.
Синтаксис:
n = WMLBrowser.go(url)
Параметр |
Описание |
n |
Строка,
возвращаемая функцией |
url |
Строка |
Пример:
var x = WMLBrowser.go(first);
Результат:
x = ""
Функция newContext()
Данная функция
очищает все переменные контекста WML и возвращает пустую
строку.
Синтаксис:
n = WMLBrowser.newContext()
Параметр |
Описание |
n |
Пустая
строка, возвращаемая функцией
|
Пример:
var x = WMLBrowser.newContext();
Результат:
x = ""
Функция prev()
Данная функция
предписывает браузеру WML вернуться к предыдущей карте
WML и возвращает пустую строку.
Синтаксис:
n = WMLBrowser.prev()
Параметр |
Описание |
n |
Пустая
строка, возвращаемая функцией
|
Пример:
var x = WMLBrowser.prev();
Результат:
x = ""
Функция refresh()
Данная функция
обновляет текущую карту и возвращает пустую строку, если
обновление прошло успешно, - или непустую строку, если
обновление неудачно.
Синтаксис:
n = WMLBrowser.refresh()
Параметр |
Описание |
n |
Строка,
возвращаемая функцией
|
Пример:
var x =
WMLBrowser.setVar("week",25);
var y = WMLBrowser.refresh();
Результат:
x = true
y = ""
Функция WMLScript setVar()
Данная функция
задает значение указанной переменной в контексте
браузера и возвращает true,
если новое значение было успешно задано, и значение
false - в противном случае.
Синтаксис:
n = WMLBrowser.setVar(variable,
value)
Параметр |
Описание |
n |
Булево
значение, возвращаемое функцией |
Variable |
Строка
|
Value |
Строка |
Пример:
var x = WMLBrowser.setVar("day",
15);
Результат:
x = true
|