Библиотека URL
Библиотека URL
Библиотека URL содержит набор функций для работы как с абсолютными, так и с
относительными указателями ресурсов (URL).
В общем случае URL описывается следующей синтаксической конструкцией:
<scheme>://<host>:<port>/<path>;<params>?<query>#<fragment>
escapeString
Функция: URL. escapeString (string);
Описание: Возвращает новую строку, получаемую из вход-
ной строки string путем замены всех спецсим-
волов на ESCAPE-последовательности в формате
%хх. Если входная строка содержит символы, не
являющиеся частью набора символов US-ASCII,
функция возвращает значение invalid.
ESCAPE-последовательности заменяются сле-
дующие символы:
Управляющие символы: (шестнадцатеричные
значения ОО-lf и 7f из
набора символов USASCII)
Знак пробела: (шестнадцатеричное
значение 20 из набора
символов US-ASCII)
Зарезервированные
символы: ;/?:@& = + $,
Несмысловые символы: () |\Л[]'
Разделители:
Аргумент: string = Строка
Возвращаемое значение: Строка или значение invalid
Пример: Следующий сценарий использует функцию
URL.escapeStringO для кодирования строки
"@&#":
extern function EscapeStringTest()
{
var Argument = "@&#";
var Result = URL.escapeString(Argument);
var ResultString = "URL.escapeStringO" + "\r\r"
"escapeString(@&#) = " + Result;
Dialogs. alert (ResultString) ;
getBase
Функция: URL. getBase ();
Описание: Возвращает абсолютный URL текущего
WMLScript-файла (без фрагмента).
Возвращаемое значение: Строка
Пример: Следующий сценарий использует функцию
URL.getBase () для получения URL файла, в котором находится сценарий:
extern function GetBaseTest()
{
var Result = URL.getBase();
var ResultString = "URL.getBase()" + "\r\r" +
"getBaseO = " + Result;
Dialogs.alert(ResultString);
}
getFragment
Функция: URL.getFragment (urlString);
Описание: Возвращает фрагмент, заданный во входной
URL-строке. При обнаружении некорректного
синтаксиса URL функция возвращает значение
invalid.
Аргумент: urlString = Строка
Возвращаемое значение: Строка или значение invalid
Пример: Следующий сценарий использует функцию
getFragment () для извлечения фрагмента
из URL
extern function GetFragmentTest()
{
var Result = URL.getFragment("");
var ResultString = "URL.getFragment()" + "\r\r" +
"The fragment is " + Result;
Dialogs.alert(ResultString);
}
getHost
Функция: URL.getHost(urlString);
Описание: Возвращает имя хост-системы, указанное во
входной URL-строке. Относительные URL не
преобразуются в абсолютные URL, поэтому имя
хост-системы в относительном URL будет возвращаться пустой строкой. При обнаружении
некорректного синтаксиса URL функция воз-
вращает значение invalid.
Аргумент: urlString = Строка
Возвращаемое значение: Строка или значение invalid
Пример: Следующий сценарий использует функцию
URL.getHostO для извлечения имени хост-системы из URL
extern function GetHostTest()
{
var Result = URL.getHost("#abed");
var ResultString = "URL.getHost()" + "\r\r" +
"The host is " + Result;
Dialogs.alert(ResultString);
}
getParameters
Функция: URL. getParameters (urlString);
Описание: Возвращает параметры, заданные во входной
URL-строке. При обнаружении некорректного
синтаксиса URL функция возвращает значение
invalid.
Аргумент: ur IStr ing = Строка
Возвращаемое значение: Строка или значение invalid
Пример: ; Следующий сценарий использует функцию
URL.getParameters() для извлечения списка
параметров из URL
extern function GetParametersTest()
{
var Result = URL.getParameters(" ,-2;3");
var ResultString = "URL.getParameters()" + "\r\r" +
"The parameters are " + Result;
Dialogs.alert(ResultString);
}
getPath
Функция: URL.getPath(urlString);
Описание: Возвращает путь, указанный во входной URL-
строке. При обнаружении некорректного син-
таксиса URL функция возрращает значение
invalid.
Аргумент: ur IStr ing = Строка
Возвращаемое значение: Строка или значение invalid
Пример: Следующий сценарий использует функцию
URL . getPath () для извлечения пути из URL
;
extern function GetPathTest()
{
var Result = URL.getPath("");
var ResultString = "URL.getPath()" + "\r\r" +
"The path is " + Result;
Dialogs.alert(ResultString);
{
getPort
Функция: URL.getPort(urlString);
Описание: Возвращает порт, указанный во входной URL-
строке. Если порт не указан, функция возвращает пустую строку. При обнаружении некоррект-
ного синтаксиса URL функция возвращает значение invalid.
Аргумент: urlString = Строка
Возвращаемое значение: Строка или значение invalid
Пример: Следующий сценарий использует функцию
URL. getPort () для извлечения номера порта из
URL ;2;3:
extern function GetPortTest()
var Result = URL.getPort("");
var ResultString = "URL.getPort()" + "\r\r" +
"The port is " + Result;
Dialogs.alert(ResultString);
getQuery
Функция: URL.getQuery(urlString);
Описание: Возвращает запрос, указанный во входной URL-
строке. Если запрос не указан, функция возвра-
щает пустую строку. При обнаружении некорректного синтаксиса URL функция возвращает
значение invalid.
Аргумент: urlString = Строка
Возвращаемое значение: Строка или значение invalid
Пример: Следующий сценарий использует функцию
URL.getQuery() для извлечения строки запроса
из URL &b=2:
extern function GetQueryTest()
{
var Result =
URL.getQuery("&b=2");
var ResultString = "URL.getQuery()" + "\r\r" +
"The query is " + Result; :
Dialogs.alert(ResultString);
)
getReferer
Функция: tJRL.getReferer();
Описание: Возвращает URL ресурса, который вызвал текущий WMLScript-сценарий.
Возвращаемое значение: Строка
Пример: Следующий сценарий использует функцию
URL. getReferer () для получения имени WML-
файла, вызвавшего сценарий:
extern function GetRefererTest()
{
var Result = URL.getReferer();
var ResultString = "URL.getReferer()" + "\r\r" +
"URL.getReferer = " + Result;
Dialogs.alert(ResultString);
{
getScheme
Функция: URL. getScheme (urlString);
Описание: Возвращает название протокола передачи данных, заданного во входной URL-строке. При об-
наружении некорректного синтаксиса URL
функция возвращает значение invalid.
Аргумент: urlString = Строка
Возвращаемое значение: Строка или значение invalid
Пример: Следующий сценарий использует функцию
URL. getScheme () для извлечения названия
протокола передачи данных, используемого в
- URL 1;2;3:
extern function GetSchemeTest()
{
var Result = URL.getScheme("");
var ResultString = "URL. getScheme ()" + "\r\r" +
"The scheme is " + Result;
Dialogs. alert (ResultString) ;
{
isValid
Функция: URL. isValid (urlString);
Описание: Возвращает логическое значение true, если
синтаксис входной URL-строки корректен и
false, если синтаксис не корректен.
Аргумент: urlString = Строка
Возвращаемое значение: Логическое значение
Пример: Следующий сценарий использует функцию
URL. isValid(), чтобы установить являются ли
строки "waplib.com" и "" корректными URL-
строками:
extern function IsValidTest ()
var Argumentl = "waplib.com"; ,
var Resultl = URL.isValid(Argumentl);
var Argument2 = "";
var Result2 = URL.isValid(Arguments);
var ResultString = "URL.isValid()" + "\r\r" +
"isValid(waplib.com) = " + Resultl + "\r" +
"isValid() = " + Result2;
Dialogs.alert(ResultString);
resolve
Функция: URL.resolve(baseURL, embeddedURL);
Описание: Возвращает абсолютный URL, получаемый из
указываемого базового URL и вложенного URL.
При обнаружении некорректного синтаксиса
URL функция возвращает значение invalid.
Аргументы: baseURL = Строка
embeddedURL = Строка
Возвращаемое значение: Строка или значение invalid
Пример: Следующий сценарий использует функцию
URL.resolve{) для объединения двух аргументов в абсолютный URL:
extern function ResolveTest()
{
var Argumentl = "";
var Arguments = "Demos.wml";
var Result = URL.resolve(Argumentl, Arguments);
var ResultString = "URL.resolve()" + "\r\r" +
"The absolute URL is " + Result;
Dialogs.alert(ResultString);
}
unescapeString
Функция: URL.unescapeString(string);
Описание: Возвращает новую строку, получаемую из входной строки string путем замены всех ESCAPE-
последовательностей (таких, как те, что получаются с помощью функции URL.escapeString)
на символы, представляемые этими ESCAPE-
последовательностями. Если строка содержит
символы, которые не входят в набор знаков US-
ASCII, функция возвращает значение invalid.
Аргумент: string = Строка к
Возвращаемое значение: Строка или значение invalid
Пример: Следующий сценарий использует функцию
URL.unescapeStringO для декодирования
строки "%40%26%23":
extern function UnescapeStringTest()
{
var Argument = "%40%26%23";
var Result = URL.unescapeString(Argument);
var ResultString = "URL.unescapeStringO" + "\r\r" +
"unescapeString(%40%26%23) = " + Result;
Dialogs.alert(ResultString);
}
