Пособие по написанию WAP сайтов



Пособие по написанию WAP сайтов

         

Арифметические операции



Арифметические операции

В языке WMLScript реализованы следующие базовые бинарные арифметические
операции:



Оператор

Операция

+

сложение чисел или объединение символьных строк

-

вычитание

*

умножение

/

деление


div

целочисленное деление

Кроме того, язык WMLScript поддерживает следующий набор более сложных бинарных арифметических операций:

Оператор

Операция

%

остаток от деления (знак результата совпадает со знаком
делимого)

«

поразрядное смещение влево

»


поразрядное смещение вправо

>>>

поразрядное смещение вправо с заполнением нулями

&

поразрядная операция «И» (AND)

1

поразрядная операция «ИЛИ» (OR)

/\

поразрядная операция «исключающее ИЛИ» (XOR)



Библиотека Console



Библиотека Console

Библиотека Console содержит набор функций, которые могут быть полезными
при отладке программ.

Print
Функция: Console.print(value);

Описание: Преобразует заданное значение в строку и выводит ее в информационное окно инструментального программного пакета (SDK) Phone.
Аргумент: value = Любое значение

Пример: Следующий сценарий использует функцию

Console.print(), чтобы в отладочных целях

вывести три имени в одну строку в информаци-

онном окне инструментального программного

пакета Phone:
extern function PrintTestO

{
var Namel = "Matt";

var Name2 = "Krissy";
var Name3 = "Tommy";

Console.print (Namel);
Console.print (Name2);
Console.print (Name3);
}

Println

Функция: Console.println(value);

Описание: Преобразует заданное значение в строку, выводит ее в информационное окно SDK Phone и перемещает курсор на следующую строку.
Аргумент: value = Любое значение

Пример: Следующий сценарий использует функцию

Console.println(), чтобы в отладочных целях
вывести три имени на три разные строки в ин формациошюм окне инструментального пакета

Phone:

extern function PrintLnTest()

var Namel = "Matt";

var Name2 = "Krissy";

var NameS = "Tommy";

Console.println (Namel);

Console.println (Name2);

Console.println (NameS);




Библиотека Dialogs



Библиотека Dialogs

Библиотека Dialogs предоставляет набор функций пользовательского интерфейса.

alert

Функция: Dialogs.alert(message);

Описание: Отображает заданное сообщение, ожидает под-
. тверждения со стороны пользователя и возвра-
щает пустую строку.

Аргумент: message = Строка

Возвращаемое значение: Строка или значение invalid

Пример: Следующий сценарий использует функцию

Dialogs. alert () для вывода на экран сообщения:

extern function AlertTestO
{

var ResultString = "Dialogs .alert () " + »\r\r"
"This is an alert!

Dialogs .alert (ResultString) ; .
}

confirm

Функция: Dialogs.confirm(message, OKPrompt, Cancel-
Prompt) ;

Описание: Отображает заданное сообщение и предоставляет пользователю возможность выбора из двух

ответов. Возвращает логическое значение true,

если выбран ответ ок и false, если выбран ответ Cancel.

Аргументы: message = Строка

, OKPrompt = Строка

CancelPrompt = Строка

Возвращаемое значение: Строка

Пример: Следующий сценарий использует функцию

Dialogs. confirm () для отображения приглашения пользователю на взаимодействие с приложением, причем приглашение включает экранные кнопки Yes и No:

extern function ConfirmTest()
{

var Message = "Dialogs.confirm()" + "\r\r" + "Are you sure?";
var OK = "Yes";
var Cancel = "No";

Dialogs.confirm(Massage, OK, Cancel);

}

prompt

Функция: Dialogs.prompt(message, default);

Описание: Отображает указываемое сообщение message в

качестве приглашения пользователю на взаимодействие с приложением и возвращает вводимые пользователем данные. Используемое по
умолчанию значение default определяет начальное содержимое переменной, которой присваиваются вводимые пользователем данные.

Аргументы: message = Строка

default = Строка
Возвращаемое значение: Строка

Пример: Следующий сценарий использует функцию

Dialogs. prompt () для вывода приглашения

пользователю на ввод номера телефона. По

умолчанию пользователю для редактирования
предлагается значение 555-1212:

extern function PromptTestO

var Message = "Dialogs.prompt()" + "\r\r" + "Phone Number:";
var PhoneNo = "555-1212";

Dialogs.prompt(Message, PhoneNo);




Библиотека Float



Библиотека Float

Библиотека Float содержит набор функций для работы с числами в формате с
плавающей запятой. Наличие данных функций носит необязательный характер.
Если устройство не поддерживает операции над числами с плавающей запятой,
все функции данной библиотеки будут возвращать значение invalid.

Ceil

Функция: Float, ceil (value);

Описание: Возвращает наименьшее целое число, которое

превышает входное значение аргумента или
равно ему. Если входное значение аргумента -
целое число, функция возвращает это число.

Аргумент: value = Число

Возвращаемое значение: Целое число или значение invalid

Пример: Следующий сценарий использует функцию
Float, ceil () для нахождения наименьших целых чисел, одно из которых не меньше положи тельного числа с плавающей запятой, а другое -
не меньше отрицательного числа с плавающей
запятой:

extern function CeilTestO
{

var Argumentl = 10.5;
var Resultl = Float.ceil(Argumentl);

var Argument2 = -5.5;
var Result2 = Float.ceil(Argument2);

var ResultString = "Float.ceil()" + "\r\r" +

"ceil(10.5) = " + Resultl + "\r" +
"ceil(-5.5) = " + Result2;


Dialogs.alert(ResultString);

}

floor

Функция: Float, floor (value);

Описание: Возвращает наибольшее целое число, которое

меньше входного значения аргумента или равно
ему. Если входное значение аргумента - целое
число, функция возвращает это число.

Аргумент: value = Число
Возвращаемое значение: Целое число или значение invalid

Пример: Следующий сценарий использует функцию

Float.floor() трижды: для нахождения наибольших целых чисел, одно из которых должно
быть не больше положительного числа с плавающей запятой, другое - не больше отрицательного числа с плавающей запятой и третье -
не больше целого числа:

extern function FloorTestO

{ .
var Argumentl = 10.5;

, var Resultl = Float.floor(Argumentl);

var Argument2 = -5.5;

var Result2 = Float, floor (Argument2) ;

var Arguments = 300;
var Results = Float.floor(Arguments);

var ResultString = "Float.floor()" + "\r\r" +
"floor(10.5) = " + Resultl + "\r" +
"floor(-5.5) = " + Result2 + "\r" +
"floor(SOO) = " + Results;

Dialogs.alert(ResultString);
}

int

Функция: Float, int (value);

Описание: Возвращает целую часть входного значения аргумента.

Аргумент: value = Число

Возвращаемое значение: Целое число или значение invalid

Пример: Следующий сценарий использует функцию

Float. int () для извлечения целой части как у
положительных, так и у отрицательных чисел с
плавающей запятой:

extern function IntTestQ
{

var Argumentl = 10.5;

var Resultl = Float.int(Argumentl);

var Argument2 =-5.5;
var Result2 = Float, int (Arguments) ;

var ResultString = "Float.int()" + "\r\r" +

"int(10.5) = " + Resultl + "\r" +
"int(-5.5) = " + Result2;

Dialogs.alert(ResultString) ;

}

maxFloat

Функция: Float. maxFloat ();

Описание: Возвращает наибольшее число с плавающей запятой, поддерживаемое интерпретатором.

Возвращаемое значение: Число с плавающей запятой

Пример: Следующий сценарий использует функцию

Float. maxFloat () для определения наибольшего числа с плавающей запятой, которое поддерживает интерпретатор:

extern function maxFloatTest ()

{

var Result = Float. maxFloat О;

var ResultString = "Float.maxFloat() " + "\zr\r" + Result;
Dialogs.alert(ResultString);

}

minFloat

Функция: Float. minFloat ();

Описание: Возвращает наименьшее число с плавающей запятой, поддерживаемое интерпретатором.

Возвращаемое значение: Число с плавающей запятой

Пример: Следующий сценарий использует функцию

Float.minFloat () для определения наименьшего числа с плавающей запятой, работу с которым поддерживает интерпретатор:

extern function minFloatTestO

{

var Result = Float.minFloat();

var ResultString = "Float.minFloat()" + "\r\r" + Result;

Dialogs.alert(ResultString);

pow

Функция: Float, pow (valuel, value2);

Описание: Возвращает результат возведения первого аргумента (valuel) в степень, равную второму аргументу (value2). Если значение первого аргумента (valuel) является отрицательным числом, то
значение второго аргумента (valua2) должно

быть целочисленным.

Аргументы: valuel = Число

value2 = Число

Возвращаемое значение: Число с плавающей запятой или значение

invalid

Пример: Следующий сценарий использует функцию

Float. pow () для вычисления результата возведения 3 в степень 2 и корня квадратного из 16:

extern function PowTestO
<
var Argumentl = 3;
var Arguments = 2;
var Resultl = Float.pow(Argumentl, Argument2);

var Arguments = 16; var Argument4 = .5;

var Result2 = Float.pow(Arguments, Argument4);

var ResultString = "Float.pow()" + "\r\r" +
"pow(3, 2) = " + Resultl + "\r" +
"pow(16, .5) = » + Result2;

Dialogs.alert(ResultString);

}

round
Функция: Float.round(value);

Описание: Возвращает целое число, ближайшее к входному
значению. Если два целых числа одинаково
близки к входному значению, функция возвращает большее из этих чисел.

Аргумент: value = Число
Возвращаемое значение: Целое число или значение invalid

Пример: Следующий сценарий использует функцию

Float.roundO для округления чисел 5.4, 5.5 и

5.6 до ближайшего целого числа:

extern function RoundTest()

{

var Argument! = 5.4;

var Resultl = Float.round(Argumentl);

var Argument2 = 5.5;

var Result2 = Float.round(Argument2);

var Arguments = 5.6;
var Results = Float.round(Arguments);

var ResultString = "Float.round()" + "\r\r" +

"round(5.4) = " + Resultl + "\r"

"round(5.5) = " + Result2 + "\r" +

"round(5.6) = " + Results,-

Dialogs.alert(ResultString);

}

sqrt
Функция: Float, sqrt (value);

Описание: Возвращает корень квадратный из входного

значения. Если входное значение отрицательно,

функция возвращает значение invalid.

Аргумент: value = Число

Возвращаемое значение: Число с плавающей запятой или значение

invalid

Пример: Следующий сценарий использует функцию
Float.sqrt() для вычисления корней квадратных из 2 и-9:

extern function SqrtTest() ,

{

var Argumentl = 2;

var Resultl = Float, sqrt (Argumentl) ; vis.

var Argument2 = -9;
var Result2 = Float. sqrt (Argument2);

var ResultString = "Float.sqrt()" + "\r\r" +

"sqrt(2) = » + String.toString(Resultl) +
"sqrt(-9) = " + String.toString(Result2);

Dialogs.alert(ResultString);

}



Библиотека Lang



Библиотека Lang

Библиотека Lang содержит набор функций, предназначенных для работы с элементами языка WMLscript.


Функция: Lang.abort(errorMessage);

Описание: Прерывает работу интерпретатора WMLScript и

возвращает управление WML-странице.

Аргумент: errorMessage = Строка
Возвращаемое значение: Нет

Пример: Следующий сценарий демонстрирует использо-
вание функции Lang.abort() для прекращения
работы сценария:

extern function AbortTestO


{


var Argument = 0;
BadFun(Argument);

Dialogs.alert("This will never display");

function BadFun (Argument)

Lang.abort("Error:");

Dialogs, alert ("Neither will this,

}


Функция: ; bang, abs (number);

Описание: К, Возвращает абсолютное значение числа. Если

число имеет тип integer (целое число), возвращается целочисленное значение. Если число

имеет тип floating-point (число с плавающей
запятой), возвращается число с плавающей запятой.

Аргумент: number = Число

Возвращаемое значение: Число или значение invalid

Пример: Следующий сценарий использует функцию

Lang.abs() дважды: первый раз, чтобы возвратить абсолютное значение отрицательного целого числа, второй раз, чтобы возвратить абсо лютное значение отрицательного числа с плавающей запятой:

extern function AbsTestO
<

var Argumentl = -5;

var Resultl = Lang.abs(Argumentl);

var Arguments = -7 . ;

var Result2 = bang.abs(Arguments); ,

var ResultString = "Lang.abs()" + "\r\r" +

"abs(-5) = " + Resultl + "\r" +

"abs(-7.) = " + Result2; :,n

Dialogs. alert (ResultString) ; ;- >

}

characterSet

Функция: Lang. characterSet О;

Описание: Возвращает целочисленное значение, которое

указывает на набор символов, поддерживаемых
интерпретатором.

Возвращаемое значение: Целое число

Пример: Следующий сценарий использует функцию

Lang.characterSet() для определения набора
символов, поддерживаемых интерпретатором.

extern function CharSetTest() м

{
var Result = Lang.characterSet();

var ResultString = "Lang.characterSet () " + "\r\r" + Result/-
Dialogs .alert(ResultString);

>

exit

Функция: Lang. exit (value);

Описание: Останавливает выполнение WMLScript-сценария

и возвращает управление WML-странице.

Аргумент: value = Любое значение
Возвращаемое значение: Нет

Пример: Следующий сценарий демонстрирует использование функции Lang.exit() для прекращения
выполнения сценария.

extern function ExitTestO
{

var Argument = 0;
BadFun(Argument);
Dialogs.alert("This will never display");

function BadFun (Argument) :

Lang.exit ("Error:");
Dialogs.alert("Neither will this");

}


Функция: Lang.floatO ;

Описание: Возвращает логическое значение true, если

числа с плавающей запятой поддерживаются

интерпретатором и false, если числа с плавающей запятой не поддерживаются интерпретатором

Возвращаемое значение: Логическое значение

Пример: Следующий сценарий использует функцию

Lang. float (), чтобы определить поддерживаются интерпретатором числа с плавающей запя той или нет:

extern function FloatTestO


var Result = Lang.floatO ;
var ResultString = "Lang.floatO" + "\r\r" + Result;

Dialogs.alert(ResultString);
}

isFloat

Функция: Lang.isFloat(value);

Описание: Возвращает значение true, если аргумент функ-

ции может быть конвертирован в число с плавающей запятой и возвращает значение false,
если аргумент функции не может быть конвертирован в число с плавающей запятой. Если система не поддерживает операции над числами с

плавающей запятой или аргумент имеет недопустимое значение, функция возвращает значение invalid.


Аргумент: value = Любое значение
Возвращаемое значение: Логическое значение или значение invalid

Пример: Следующий сценарий использует функцию

bang. isFloat (), чтобы определить, могут ли

значения "5.0", "7" и "String" быть конвертированы в числа с плавающей запятой:

extern function isFloatTest() :
{

var Argumentl = "5.0"; "*'"'

var Resultl = Lang.isFloat(Argumentl) ;


var Argument2 = "7";

var Result2 = Lang.isFloat(Argument2);

var Arguments = "String";

var Results = Lang.isFloat(Arguments);

var ResultString = "Lang.isFloat ()" + "\r\r" 4-

"isFloat(5.0) = " + Resultl + "\r" +
"isFloat(7) = " + Result2 + "\r" +
"isFloat (String) = " + Results,-

Dialogs.alert(ResultString);

}

Функция: Lang.islnt (value);

Описание: Возвращает логическое значение true, если

аргумент функции может быть конвертирован в

целое число и возвращает логическое значение

false, если аргумент функции не может быть

конвертирован в целое число. Если аргумент

имеет недопустимое значение, возвращается

значение invalid.

Аргумент: value = Любое значение

Возвращаемое значение: Логическое значение или invalid

Пример: Следующий сценарий использует функцию
Lang.isIntO, чтобы определить могут ли значения "5.0", "7" и "String" быть конвертированы в целые числа:

extern function is!ntTest() ;;

{
var Argumentl = "5.0";
var Resultl = Lang.islnt(Argumenfel);

var Argument2 = "7";
var Result2 = Lang. islnt (Argument2) ;

var Arguments = "String";
var Results = Lang.islnt(Arguments);

var ResultString = "Lang.isIntO" + "\r\r" +

"islnt(5.0) = " + Resultl + "\r" +
"islnt(7) = " + Result2 + "\r" +

"islnt (String) = " + Results;

Dialogs.alert(ResultString);
}

max

Функция: Lang.max(valuel, value2);

Описание: Возвращает большее из двух значений.

Возвращаемое функцией значение и его тип
совпадают со значением и типом возвращаемого
аргумента. Если значения равны, возвращается
первый аргумент.

Аргументы: valuel = Число

value2 = Число
Возвращаемое значение: Число или значение invalid

Пример: Следующий сценарий использует функцию

Lang.maxO трижды: для определения большего

положительных чисел, двух отрицательных чисел, а также символьной строки и числа:

extern function MaxTestO

var Argumentl = 5.0;

var Argument2 = 500;

var Resultl = Lang.max(Argumentl, Argument2);

var Arguments = -7;

var Argument4 = -10.0;

var Result2 = Lang.max(Arguments, Argument4);

var Arguments = "String";
var Arguments = 0.0;
var Results = Lang.max(Arguments, Arguments);

var ResultString = "Lang.maxO" + "\r\r" +

"max(5.0, 500) = " +

String.toString(Resultl) + "\r" +
"max(-7, -10.0) = " +

String.toString(Result2) + "\r" +
"max(String, 0.0) ="+ I
String.toString(Results);


Dialogs.alert(ResultString);


maxlnt

Функция: Lang.maxlnt();


Описание: Возвращает значение максимального целого

числа, поддерживаемого интерпретатором.

Возвращаемое значение: Целое число

Пример: Следующий сценарий использует функцию

Lang.maxlnt() для определения максимального
целого числа, поддерживаемого интерпретато-

ром:

extern function maxIntTestO

{
var Result = Lang.maxlnt();

var ResultString = "Lang.maxlnt()" + "\r\r" + Result;
Dialogs.alert(ResultString) ;


mm

Функция: Lang.min(valuel, value2);

Описание: Возвращает меньшее из двух значений.

Возвращаемое функцией значение и его тип

совпадают со значением и типом возвращаемого

аргумента. Если значения равны, возвращается
первый аргумент.


Аргументы: valuel = Число

value2= Число
Возвращаемое значение: Число или значение invalid

Пример: Следующий сценарий использует функцию

Lang.minQ трижды: для определения меньшего
из двух положительных чисел, двух отрицатель-
ных чисел, а также символьной строки и числа:

extern function MinTestO


var Argumentl = 5.0;

var Argument2 = 500;

var Resultl = Lang.min(Argumentl, Argument2);

var Arguments = -7;

var Argument4 = -10.0;

var Result2 = Lang.min(Arguments, Argument-!) ;

var Arguments = "String";

var Arguments =0.0;

var Result3 = Lang.min(Arguments, Arguments);

var ResultString = "Lang.minO" + "\r\r" +
"min(5.0, 500) = " +

String.toString(Resultl) + "\r" +
"min(-7, -10.0) = " +

String.toString(Result2) + "\r" +
"min(String, 0.0) = " +

String.toString(Results);

Dialogs . alert (ResultString) ;

>

minlnt

Функция: 'Lang. minlnt ();

Описание: Возвращает значение минимального целого

числа, поддерживаемого интерпретатором.

Возвращаемое значение: Целое число

Пример: Следующий сценарий использует функцию

bang. minlnt () для определения минимального

целого числа, поддерживаемого интерпретато-
ром:

extern function minlntTestO


var Result = Lang.minlnt();

var ResultString = "Lang.minlnt()" + "\r\r" + Result;
Dialogs.alert(ResultString) ;

parserloat

Функция: Lang.parseFloat (stringValue);

Описание: Возвращает значение в формате числа с плавающей запятой, которое определяется входной
символьной строкой. Если при анализе строки
выдается ошибка, функция возвращает значение

invalid. Анализ прекращается при встрече первого символа, который не является частью кор-

ректного числа с плавающей запятой.

Аргумент: stringValue = Символьная строка

Возвращаемое значение: Число с плавающей запятой или значение

invalid

Пример: Следующий сценарий использует функцию

Lang.parseFloat () для преобразования

СИМВОЛЬНЫХ строк "5.0", "15 sq. in." И "А = 5"
в числа с плавающей запятой:
extern function ParseFloatTest()
var Argumentl = "5.0";

var Resultl = Lang.parseFloat(Argumentl);

var Argument2 = "15 sq. in.";

var Resuit2 = Lang.parseFloat(Argument2);

var Arguments = "A = 5"; t ч
var Results = Lang.parseFloat(Arguments);

var ResultString = "Lang.parseFloat()" + "\r\r" +

"parseFloat(5.0) = " +
: "-'''!""!' String. toString(Resultl) + "\r" +

"parseFloat(15 sq. in.) = " +

'- ,''*''" '< -' - String. toString (Result2) + "\r" +
"parseFloat(A = 5) = " +
String.toString(Results);

Dialogs, alert (ResultString) ;

}

parselnt

Функция: Lang.parselnt(stringValue); Описание: Возвращает целочисленное значение, которое

определяется входной символьной строкой. Еc
ли при анализе строки выдается ошибка, функвозвращает значение invalid. Анализ прекращается при встрече первого символа, который не является начальным знаком "+" или
или десятичной цифрой.

Аргумент: stringValue = Символьная строка
Возвращаемое значение: Целое число или значение invalid

Пример: Следующий сценарий использует функцию
bang.parselnt() для преобразования символьных

строк "5. О", "15 sq. in." и "А = 5" в целые числа:

extern function ParselntTest()

{
var Argumentl = "5";
var Resultl = Lang.parselnt (Argumentl) ;

var Arg\iment2 = "15 sq. in."; ,
var Result2 = Lang.parselnt(Argument2);

var Arguments = "A = 5"; t

var Results = Lang.parselnt(Arguments);

var ResultString = "Lang.parselnt()" + "\r\r" +

"parselnt(5) = " +

String. toString (Resultl) + "\r" +
"parselnt(15 sq. in.) = " +
String.toString(Result2) + "\r" +
"parselnt (A = 5) = " +

String.toString(Results);

Dialogs .alert (ResultString)

random

Функция: bang, random (value);

Описание: Возвращает псевдослучайное целое число, коорсе больше или равно нулю и при этом меньше или равно входному значению аргумента

функции. Если входное значение равно нулю,

функция возвращает нуль. Если входное значение отрицательно или не является числом

(строка или недопустимое значение), то функ ция возвращает значение invalid.

Аргумент: value = Целое число
Возвращаемое значение: Целое число или значение invalid

Пример: Следующий сценарий использует функцию

bang. random () дважды: для выдачи одного

псевдослучайного числа в диапазоне между 0 и

10, а другого псевдослучайного числа - между О

и-10:

extern function RandomTestO

{

var Argumentl =10;

var Resultl = Lang.random(Argumentl);

var Argument2 = -10;

var Result2 = Lang. random (Argument2);

var ResultString = "Lang.randomO" + "\r\r" +

"random(10) = " + String.toString(Resultl) +

"random(-lO) = " + String.toString(Result2);

Dialogs.alert(Resultstring);
}

seed

Функция: bang, seed (value);

Описание: Инициализирует процесс генерации псевдослу чайных чисел и возвращает пустую строку. Если

входное значение больше или равно нулю, то оно

используется в качестве инициализирующего

значения; в противном случае используется системно-зависимое значение. Если входное значение аргумента функции не является числом,

функция возвращает значение invalid.

Аргумент: value = Целое число
Возвращаемое значение: Символьная строка или значение invalid

Пример: Следующий сценарий использует функцию

Lang. seed () для инициализации генератора

псевдослучайных чисел:

extern function SeedTestO

{

var Argumentl = 10;

var Resultl = Lang. seed (Argumentl);

var Argument2 = 5;
var Result2 = Lang.random(Argument2) ;

var ResultString = "Lang.seed()" + "\r\r" +

л "seed(10) = " + String.toString(Resultl) ;

Dialogs.alert(ResultString); ;

}



Библиотека String



Библиотека String

Библиотека String содержит набор функций для работы с символьными строками.
Строка представляет собой массив символов. Позиция каждого символа в строке
задается его индексом. Индекс первого символа в строке равен нулю. Строка может также рассматриваться как массив элементов, разделяемых с помощью разделительного символа. Позиция каждого элемента в строке задается его индексом. Индекс первого элемента в строке равен нулю.

char At

Функция: String.charAt(string, offset);

Описание: Возвращает строку, состоящую из одного знака,

который совпадает с символом входной строки

и, в позиции, указываемой аргументом функции.

Первый символ во входной строке находится по
нулевому адресу.

Аргументы: string = Символьная строка

off set = Число
Возвращаемое значение: Символьная строка или значение invalid

Пример: Следующий сценарий использует функцию

String, char At () для извлечения из строки
"Phil" второго и третьего символов:

extern function charAtTestO

{
var Argumentl = "Phil";
var Argument2 =1;
var Resultl = String.charAt(Argumentl, Argument2);

var Arguments = 2;

var Result2 = String.charAt(Argumentl, Arguments);

var ResultString = "String.charAt()" + "\r\r" +

,, "String, char At (Phil, 2) = " 4- ; в

Resultl + "\r" +
"String.charAt(Phil, 3) = " + Result2;

Dialogs, alert (Resul tString) ;
}

compare

Функция: String, compare (stringl, string2);

Описание: Сравнивает две строки и возвращает значение

«-1», если первая строка (stringl) меньше, чем
вторая строка (string2); возвращает значение
«О», если строки одинаковы; и возвращает значение «+1», если первая строка (stringl) больше, чем вторая строка (string2).

Аргументы: stringl = Строка

string2 = Строка
Возвращаемое значение: Целое число или значение invalid

Пример: Следующий сценарий использует функцию

String, compare () для сравнения строк "а" и "А":

extern function CompareTest()

{
var Argumentl = "a";
var Argument2 = "A";

var Resultl = String.compare(Argumentl, Argument2);
var Result2 = String.compare(Argument2, Argumentl);

var ResultString = "String.compare()" + "\r\r" +

"String.compare(a, A) = " + Resultl + "\r" +

"String.compare(A, a) = " + Result2;

Dialogs.alert{ResultString);
}

elementAt

Функция: String.elementAt(string, index, separator);

Описание: Сканирует строку string с элементами, разделяемыми символом-разделителем separator и
возвращает элемент, расположенный в позиции,

определяемой аргументом index. Eсли значение
index меньше нуля, функция возвращает пер-

вый элемент. Если значение index больше количества элементов, функция возвращает послед-
ний элемент. Если входная строка пустая, возвращается пустая строка. Если символ-
разделитель является пустой строкой, функция
возвращает значение invalid.

Аргументы: string = Строка

index = Число

separator = Строка (используется только пер-
вый символ строки)

Возвращаемое значение: Строка или значение invalid

Пример: Следующий сценарий использует функцию
String.elementAt() для извлечения из списка
третьего имени:

extern function elementAtTest ()

{

var Argument = "Matt Tommy Krissy Rosey" ;
var Index=2;
var Separator = " ";
var Result = String.elementAt(Argument, Index, Separator);

var ResultString = "String.elementAt()" + "\r\r" +
"Third element is " + Result;

Dialogs.alert(ResultString);

}

корректным элементом, поэтому в любой строке

будет, по крайней мере, один элемент. Если сим-

вол-разделитель является пустой строкой, функция возвращает значение invalid.

Аргументы: string = Строка

separator = Строка (используется только первый символ строки)

Возвращаемое значение: Строка или значение invalid

Пример: Следующий сценарий использует функцию

String.elements () для подсчета количества
имен в списке:

extern function elementsTest ()

{
var Argument = "Matt Tommy Krissy Rosey";

var Separator = " ";
var Result = String.elements(Argument, Separator);

var ResultString = "String.elements()" + "\r\r" +'

"The number of elements is " + Result;

Dialogs.alert(ResultString);

}

find

Функция: String.find(string, substring);

Описание: Возвращает индекс (отсчитываемый от нуля)

первого символа, с которого во входной строке

(string) начинается подстрока, совпадающая с

указываемой подстрокой (substring). Функция

возвращает «-1», если во входной строке не об-

наружено совпадения с указываемой подстро кой. Две строки совпадают только тогда, когда

они полностью одинаковы, включая регистры

всех символов.

Аргументы: string = Строка

substring = Строка
Возвращаемое значение: Целое число

Пример: Следующий сценарий использует функцию

string.find() для определения в строке

"аЬсАВС123" позиции подстроки "АВ":

extern function FindTestO

<

var Argument = "abcABC123";
var LookFor = "AB";
var Result = String.find(Argument, LookFor);

var ResultString = "String, find ()" + "\r\r" +
"The Index of AB is " + Result;

Dialogs.alert(ResultString) ; .

}

format

Функция: String, format (format, value);

Описание: Преобразует значение аргумента value в символьную строку в соответствии со значением
аргумента format. Аргумент format определяется следующим образом:

[width][.precision]type

Параметр width (Ширина) указывает мини-
мальное число печатаемых символов. Если на
выходе число символов меньше, чем значение,
определяемое параметром width, выходная
строка дополняется слева пробелами так, чтобы
получилось минимальное число символов. По
умолчанию минимальное число символов, опре деляемое параметром width, равно единице.

Интерпретация параметра precision (Точность) зависит от значения параметра type
(Тип). Для типа d (целые числа) точность определяет минимальное число разрядов в выходной
строке. Если число разрядов в выходной строке
меньше значения, определяемого точностью,
выходная строка дополняется слева нулями. Для
типа f (числа с плавающей запятой) точность
определяет число разрядов в выходной строке
после десятичной точки (во всех случаях до десятичной точки должен существовать хотя бы
один разряд). По умолчанию число разрядов
равно шести. Для типа s (строковые перемен-

ные) точность определяет число символов в вы ходной строке. По умолчанию в выходную стро ку будут выводиться все символы входного значения аргумента value.

Параметр type (Тип) определяет, как будет интерпретироваться результат, возвращаемый
функцией: как целое число (d), как число с плавающей запятой (f) или как строка (s).

Аргументы: format = Строка

value = Любое значение
Возвращаемое значение: Строка или значение invalid

Пример: Следующий сценарий использует функцию

String, format () для вывода значения 10.25 в
виде шестиразрядного числа с плавающей запятой, у которого после десятичной точки нахо-

дится всего один разряд:

extern function FormatTestO

{

var Format = "%6.1f";
var Argument =10.25;
var Result = String.format(Format, Argument);

var ResultString = "String.format()" + "\r\r" +,
"The result is: " + Result;

Dialogs .alert (ResultString) ;

}

insertAt

Функция: String.insertAt(string, element, index,

separator);

Описание: Возвращает строку с новым элементом (и, если
необходимо, с разделителем), вставленным в

исходную строку в позицию, определяемую арументом index. Если значение index меньше

или равно нулю, элемент вставляется в начало
строки. Если значение index больше количества
элементов в строке, элемент вставляется в конец строки. Если разделительный символ представляет собой пустую строку, функция возвра щает значение invalid.

Аргументы: format = Строка

element = Строка

index = ЧИСЛО

separator = Строка (используется только пер-
вый символ)

Возвращаемое значение: Строка или значение invalid

Пример: Следующий сценарий использует функцию
String.insertAt() для вставки в список между
именами Matt и Tommy имени Krissy:

extern function InsertAtTest ()

{
var List = "Matt Tommy";
var tolnsert = "Krissy";
var Index = 1;
var Separator = " ";

var Result = String.insertAt(List, tolnsert, Index, Separator);

var ResultString = "String.insertAt()" + "\r\r" +

"The new string is: " + Result;

Dialogs.alert(ResultString);
}

ISEmpty

Функция: String. isEmpty( string);

Описание: Возвращает логическое значение true, если

строка имеет нулевую длину и значение false,
если длина строки ненулевая.

Аргумент: string = Строка
Возвращаемое значение: Логическое значение

Пример: Следующий сценарий использует функцию

String. isEmpty (), чтобы установить являются
ли строки "Matt" и " " пустыми:

extern function IsEmptyTest()

{
var Argumentl = "Matt";
var Resultl = String.isEmpty(Argumentl);

var Argument2 = "";

var Results = String. isEmpty (Arguments) ;

var ResultString = "String.isEmpty()" + "\r\r" +

"isEmpty (\"Matt\") = " 4- Resultl + "\r",
"isEmpty(\"\") = " + Result2;

Dialogs.alert(ResultString) ;

}

length

Функция: String.length(string);

Описание: Возвращает длину (количество символов) строки.

Аргумент: string = Строка

Возвращаемое значение: Целое число

Пример: Следующий сценарий использует функцию

String, length () для подсчета количества
символов в строке "Champion Matt":

extern function Lengthiest()
{

var Argument = "Champion Matt";

var Result = String.length(Argument);

var ResultString = "String.length()" + "\r\r" +
"length(\"Champion Matt\") = " + Result;

Dialogs.alert(ResultString);
)

removeAt

Функция: String. removeAt (string, index, separator);

Описание: Возвращает новую строку, получаемую из исходной строки путем удаления элемента (и, если
необходимо, разделителя), который находится в
позиции, определяемой значением index. Если
значение index меньше или равно нулю, удаля ется первый элемент. Если значение index
больше, чем количество элементов в строке,
удаляется последний элемент. Если аргумент
string пустой, функция возвращает пустую
строку. Если символ разделителя представляет
собой пустую строку, функция возвращает значение invalid.

Аргументы: string = Строка

index = ЧИСЛО

separator = строка (используется только первый символ)

Возвращаемое значение: Строка или значение invalid

Пример: Следующий сценарий использует функцию
String.removeAt () для удаления из списка имени Krissy:

extern function RemoveAtTest ()
{

var List = "Matt Krissy Tommy";
var Index = 1;
var Separator = " ";

var Result = String.removeAt(List, Index, Separator);

var ResultString = "String.removeAt()" + "\r\r" +
"The new string is: " + Result;

Dialogs . alert (ResultString) ;

}

вода строки, перевода страницы, вертикальной

табуляции) до одного, первого непечатаемого

символа.

Аргумент: string = Строка
Возвращаемое значение: Строка или значение invalid

Пример: Следующий сценарий использует функцию

String, squeeze () для удаления между именами
"Matt" и "Tommy" всех лишних пробелов, кроме
одного:

extern function SqueezeTest()

{

var List = "Matt Tommy";
var Result = String.squeeze(List);

var ResultString = "String.squeeze()" + "\r\r" +

"The new string is: " + Result;

Dialogs.alert(ResultString);

}

substring

Функция: String.substring(string, index, length);

Описание: Возвращает новую строку, которая представляет
собой подстроку исходной строки. Новая строка

начинается с символа входной строки string,
расположенного в позиции index, и содержит
количество символов, определяемое аргументом
length.

Аргументы: string = Строка

index = Число


length = ЧИСЛО

Возвращаемое значение: Строка или значение invalid

Пример: Следующий сценарий использует функцию

String.substring() для извлечения из списка
имени "Krissy":

extern function SubStringTest()

{
var List = "Matt Krissy Tommy";
var startChar = 5;
var Length = 6;

var Result = String.substring(List, startChar, Length);

var ResultString = "String.substring()" + "\r\r" +

"The substring is: " + Result/
Dialogs .alert (ResultString) ;

}

extern function ToStringTest()

var Argument! =3.14;
var Resultl = String.toString(Argumentl);

var Argument2 = 1/0;

var Result2 = String. toString(Argument2);

var Arguments = true;

var Results = String.toString(Arguments);

var ResultString = "String.toString()" + "\r\r" +

"toString(3.14) = " + Resultl + "\r" +
"toString(1/0) = " + Result2 + "\r" +
"toString (true) = " + Results,-

Dialogs.alert(ResultString);

}

!l trim

Функция: String.trim(string);

Описание: Возвращает новую строку, получаемую из входной строки string, путем удаления всех непечатаемых символов в начале и в конце исходной

СТРОКИ.

Аргумент: string = Строка
Возвращаемое значение: Строка или значение invalid

Пример: Следующий сценарий использует функцию
String.trim() для удаления всех пробелов с
обоих концов строки - аргумента функции:

extern function TrimTestO

{
var Argument = " Matt " ;

var Result = String.trim(Argument);

var ResultString = "String.trim()" + "\r\r" +

"The new string is: " + Result;

Dialogs.alert(ResultString);
}



Библиотека 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 http://waplib.com/testSabcd:

extern function GetFragmentTest()
{

var Result = URL.getFragment("http://waplib.com/testtabcd");

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 http://waplib.com/testtfabcd:

extern function GetHostTest()

{

var Result = URL.getHost("http://waplib.com/test#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 http://waplib.com/test;1;2;3:

extern function GetParametersTest()
{

var Result = URL.getParameters("http://waplib.com/test;! ,-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

; http://waplib.com/test;1;2;3:

extern function GetPathTest()
{

var Result = URL.getPath("http://waplib.com/test;l;2;3");
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 http://waplib.com:8080/test;1 ;2;3:

extern function GetPortTest()

var Result = URL.getPort("http://waplib.com:8080/test;l;2;3");

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 http://waplib.com:8080/test;1;2;3?a=1&b=2:

extern function GetQueryTest()
{

var Result =
URL.getQuery("http://waplib.com:8080/test;l;2;3?a=l&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 http://waplib.com/test; 1;2;3:

extern function GetSchemeTest()

{

var Result = URL.getScheme("http://waplib.com/test;l;2;3");

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 = "http://waplib.com";
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);

}



Библиотека WMLBrowser



Библиотека WMLBrowser

Библиотека WMLBrowser содержит набор функций, предназначенных для доступа
к составляющим информационного наполнения устройства (device context).

getCurrentCard

Функция: WMLBrowser. getCurrentCard ();

Описание: Возвращает URL карты, выполняемой в текущий

момент времени.

Возвращаемое значение: Строка

/ Пример: Следующий сценарий использует функцию

WMLBrowser.getCurrentCard() для получения
URL карты, выполняемой в текущий момент
времени:

extern function GetCurrentCardTest()

{
var Result = WMLBrowser.getCurrentCard();

var ResultString = "WMLBrowser.getCurrentCard()" + "\r\r"
"The current card is " + Result;

Dialogs.alert(ResultString); ....

}

getVar

Функция: WMLBrowser. getVar (name);

Описание: Возвращает значение переменной с указанным
именем. Если переменная не определена, функция возвращает пустую строку. Если синтаксис
имени переменной некорректен, функция возвращает значение invalid.

Аргумент: name = Строка

Возвращаемое значение: Строка или значение invalid

Пример: Следующий сценарий использует функцию

WMLBrowser. getVar () для получения значения

переменной name, которая была определена в
WML-файле, вызвавшем сценарий:

extern function GetVarTestO
{
var Argument = "Name";^'
var Result = WMLBrowser.getVar(Argument);

var ResultString = "WMLBrowser.getVar()" + "\r\r" +

"The name is " + Result;

Dialogs.alert(ResultString);


Go

Функция: WMLBrowser.go(url);
Описание: Указывает, что должна загружаться и выполняться WML-страница по указанному URL WML-
страница не загружается до тех пор, пока не за-

кончится работа сценария. Функция возвращает

Пустую строку

Функции WMLBrowser. go О и WMLBrowser .prev()
замещают друг друга. Прежде чем сценарий
закончит свою работу, каждая из функций может
вызываться по нескольку раз. Однако сценарий
выполняет только последний вызов. Если по-
слeдний вызов устанавливает URL на пустую
строку, все запросы отменяются, и загрузка но вой карты или WML-страницы не выполняется.
Аргумент: url = Строка
Возвращаемое значение: Строка или значение invalid

Пример: Следующий сценарий использует функцию

WMLBrowser. go () для запуска WML-страницы
getvar.wml:

extern function GoTest()

{

var Argument = "getvar.wml";

var Result = WMLBrowser.go(Argument);

var ResultString = "WMLBrowser.go()" + "\r\r" +
"Ready to start " + "\r" +
"getvar.wml ";

Dialogs.alert(ResultString);
}

prev

Функция: WMLBrowser. prev ();

Описание: Указывает, что должна загружаться и выпол няться предыдущая карта. Карта не загружается

ДО тех пор, пока сценарий не завершит свою

работу. Функция возвращает пустую строку.

Функции WMLBrowser. go () и WMLBrowser. prev ()

замещают друг друга. Прежде чем сценарий

закончит свою работу, каждая из функций может

вызываться по нескольку раз. Выполняется

только последний вызов. Если последний вызов

устанавливает URL на пустую строку, все запросы

отменяются, и загрузка новой карты или WML-

страницы не выполняется.

Возвращаемое значение: Строка

Пример: Следующий сценарий использует функцию

WMLBrowser.prev() для,возврата на предыдущую

WML-страницу, которая в данном случае

представляет собой WML-страницу из примера
для функции WMLBrowser. go:

extern function PrevTestO

{

var Result = WMLBrowser.prev();

var ResultString = "WMLBrowser.prev()" + "\r\r" +
"Ready to go back one deck ";

Dialogs.alert(ResultString);

}

setVar

Функция: WMLBrowser.setVar(name, value);

Описание: Присваивает задаваемое значение value переменной с указываемым именем name и возвращает логическое значение true, если операция
выполнена успешно, и значение false, если
операция закончилась неудачей. Если синтаксис
имени переменной или указываемое значение

некорректны, функция возвращает значение

invalid.

Аргументы: name = Строка

value = любое значение

Возвращаемое значение: Логическое значение или значение invalid

Пример: Следующий сценарий использует функцию

WMLBrowser. setVar () для определения переменной Name в WML-странице, которая вызвала
сценарий:

extern function SetVarTestO

{
var Argumentl = "Name";

var Arguments = "Krissy";

var Result = WMLBrowser. setVar (Argumentl, Argument2) ;

var ResultString = "WMLBrowser. setVar ()" 4- "\r\r"
"Setting Name to Krissy";

Dialogs, alert (Resul tString) ;
)



Элементы


Элемент <А>
Синтаксис:

<А LABEL=метка АССЕSSKEY=кнопка ТАSК=задание

DEST=url REL=NEXT МЕТНОD=МетоД РОSТDАТА=данные

АССЕРТ-СНАRSЕТ=набор символов VARS=napbi перемен-
ная/значение RECEIVE=список RETVALS=список
NEXT=url CANCEL=url FRIED=Логическое значение
SENDREFERER=Лoгичecкoe значение СLЕАR=Логическое
значение мимввк=число

>

text

Описание:

Анкерная ссылка связывает задание TASK с текстовой
строкой text. Когда пользователь прокручивает экран,
чтобы увидеть ссылку, телефон отображает сразу за тек-
стом символ ">" и изменяет метку кнопки (надпись на
кнопке) ACCEPT на значение LABEL (если анкер опреде-
ляет это значение). При нажатии пользователем кнопки
ACCEPT телефон выполняет задание TASK, ассоциируе-
мое со ссылкой.

Параметры:

LABEL

Определяет метку кнопки ACCEPT,
используемой при выборе ссылки
пользователем. Длина метки не
должна превышать пяти символов.
Если значение не определено, то по
умолчанию метка принимает значе-
ние ОК.


ACCESSKEY

Определяет одноразрядное число,
появляющееся перед текстом ссыл-
ки. При нажатии пользователем со-
ответствующей кнопки на телефоне,
выполняется задание, ассоциируе-
мое со ссылкой.


TASK

Определяет задание, которое долж-
но выполняться телефоном, когда
пользователь выбирает ссылку. Па-
раметр TASK может представлять
одно из следующих заданий:



GO Запрашивает URL, опреде-
ляемый параметром DEST.



GOSUB Запрашивает URL, определяе-
мый параметром DEST в каче-
стве вложенной процедуры.



RETURN Возвращается к предыдуще-
му действию из вложенной


процедуры.



CANCEL Отменяет текущую вложен-
ную процедуру и возвращает
к предыдущему действию.



PREV Отображает предыдущую
карту в стеке предыстории.



CALL Размещает голосовой теле-
фонный вызов на номер, оп-
ределяемый параметром

NUMBER.



NOOP Ничего не делает (пустая
операция). HDML-страницы
используют эту опцию для
блокировки заданного или
выполняемого по умолчанию
действия.


DEST


Определяет URL, запрашиваемый в
заданиях GO и GOSUB.

В заданиях RETURN или CANCEL, при-
надлежащих вложенной процедуре,
параметр DEST определяет URL, ко-
торый должен запрашиваться после
возврата к действию, вызывавшему
процедуру. Данный параметр игно-
рируется браузером, если действие,
вызывающее процедуру, не отмечает
ее как дружественную ("friendly").


REL=NEXT


Отдает телефону команду на предва-
рительную выборку URL, заданного в
параметре DEST. После этого, пока
пользователь просматривает теку-
щую карту, телефон будет пытаться
загрузить в свой кэш следующий URL.



При запросе пользователем URL,
хранящегося в кэше, информация
будет отображаться браузером без
задержки, которая обычно обуслов-
лена загрузкой ресурса в память.


METHOD

Определяет метод (GET или POST),
используемый телефоном для запро-
са URL, указываемого в параметре
DEST. По умолчанию используется
метод GET.



Рекомендуется использовать метод
POST. Применение метода POST
обеспечивает перекодировку серве-
ром UP.Link данных, получаемых из
телефона, в набор символов, указы-
ваемый приложением в своих HTTP-
заголовках.


POSTDATA


Определяет данные, которые долж-
ны передаваться, если для парамет-
ра METHOD указано значение POST.
Если данные содержат более одного
аргумента, значения должны разде-
ляться с помощью амперсанта (&).


ACCEPT-CHARSET
VARS


Определяет набор символов, кото-
рый, в соответствии с ожиданиями
приложения, должен использовать
телефон для возврата данных. Если
параметр ACCEPT-CHARSET не опре-
делен, то по умолчанию будет ис-
пользоваться набор символов указы-
ваемый в HTTP-заголовках HDML-
страницы.

Определяет список имен перемен-
ных и значений, которые должны
присваиваться при выполнении за-
дания GO ИЛИ GOSUB.

Список переменных и их значений
должен иметь следующий формат:

varl=valuel&var2=value2


Значения должны представляться в
виде ESCAPE-последовательностей в
соответствии с соглашениями об
ESCAPE-последовательностях URL.
Прежде чем использовать значения,
телефон будет декодировать их из
ESCAPE-последовательностей.


RECEIVE

Определяет список имен перемен-
ных, разделяемых точкой с запятой,
которые телефон использует для
сохранения значений, возвращае-
мых из GOSUB-задания.


RETVALS


Определяет список значений, разде-
ляемых точкой с запятой, которые
возвращаются GOSUB-заданием в зада-
ние, вызвавшее GOSUB. Параметр
RETVALS можно использовать только с
RETURN-заданием. Значения должны
представляться в виде ESCAPE-
последовательностей в соответствии с
соглашениями об ESCAPE-
последовательностях URL


NEXT


Определяет URL, который должен
запрашиваться после того как вло-
женная процедура, вызванная с по-
мощью GOSUB-задания, возвращает
управление в задание, вызвавшее
вложенную процедуру. Данный па-
раметр может подавляться парамет-
ром DEST задания RETURN, принадле-
жащего вложенной процедуре, при
условии, что, когда вызывается
GOSUB-задание, параметр FRIEND
имеет значение true (Истина).


CANCEL

Определяет URL, который должен
запрашиваться после того как отме-
няется вложенная процедура, вы-
званная с помощью GOSUB-задания.
Приложения могут подавлять дан-
ный параметр, используя параметр
DEST CANCEL-задания, принадлежа-
щего вложенной процедуре, при ус-



ловии, что, когда вызывается GOSUB-
задание, параметр FRIEND имеет
значение true.


FRIEND


Указывает, должна ли вложенная
процедура в GOSUB-задании считать-
ся дружественной (friendly). Друже-
ственная вложенная процедура мо-
жет использовать параметры DEST и

CLEAR В СВОИХ RETURN- И CANCEL-

заданиях для замены значений, оп-
ределяемых заданием, которое вы-
зывает вложенную процедуру. По
умолчанию параметру FRIEND при-
сваивается значение false (Ложь).

SENDEE FERER


Определяет, должен ли браузер при
запросе с помощью параметров DEST
или NEXT нового URL предоставлять
URL текущей HDML-страницы в HTTP-
заголовках. По умолчанию парамет-
ру SENDREFERER присваивается зна-
чение false.


CLEAR


Определяет, может ли RETURN- или
CANCEL-задание из дружественной
вложенной процедуры сбрасывать в
исходное состояние все переменные
задания, которое вызывает вложен-
ную процедуру. Телефон будет игно-
рировать параметр CLEAR, если при
вызове текущего действия значение
параметра FRIEND не было равно
"true". По умолчанию данному па-
раметру присваивается значение



NUMBER

Определяет для CALL-задания номер
вызываемого телефона.



Определяет текст, который отобра-
жается браузером для представления
на экране ссылки. Браузер отобра-
жает данный текст в квадратных
скобках.

Элемент <ACTION>


Синтаксис:


<ACTION LАВЕL=метка ТУРЕ=кнопка ТАSК=задание

DEST=url REL=NEXT МЕТНОD=МEТОД РОЗТВАТА=данные

АССЕРТ-СНАКЗЕТ=набор символов пары перемен-
ная/значение КЕСЕ1УЕ=список RETVALS=cnHcoK
NEXT=url CANCEL=url =Логическое значение
SENDKEFERER= значение СLЕАR=Логическое
значение cимволов=число SRC=url LСОН=пиктограмма>

Описание:


Элемент <ACTION> связывает задание с функциональны-
ми кнопками телефона, такими, как ACCEPT, PREV, HELP,
SEND, DELETE, SOFT1 или SOFT2. Когда пользователь на-
жимает функциональную кнопку, телефон выполняет
задание, ассоциируемое с кнопкой.

Параметры:


LABEL Определяет метку (надпись) для
кнопки, указываемой параметром
TYPE (Тип). Длина метки не должна
превышать пяти символов. По умол-
чанию для кнопки ACCEPT использу-
ется метка ОК.


Определение метки для кнопки

ACCEPT носит необязательный ха-


рактер. Если определяется метка для

кнопки PREV, то эта метка игнориру-
ется устройством. Для любой другой
кнопки требуется указание метки.



Определяет кнопку на телефоне,
которая будет активизировать зада-
ние. К доступным кнопкам относят-
ся ACCEPT, HELP, PREV, SOFT1,
SOFT2, SEND и DELETE.


TASK Определяет задание, которое долж-
но выполняться телефоном при на-
жатии кнопки. Параметр TASK может
быть любым из следующих заданий:


Запрашивает URL, опреде-

ЛЯСМЫЙ ОПЦИеЙ DEST.

GOSUB Запрашивает URL, опреде-
ляемый опцией DEST в каче-
стве вложенной процедуры.



RETURN Возвращает в предыдущее
действие из вложенной про-
цедуры.



CANCEL Отменяет работу текущей
вложенной процедуры и воз-
вращает к предыдущему дей-
ствию.



PREV Отображает предыдущую
карту из стека предыстории.



CALL Размещает голосовой теле-
фонный вызов на номер, оп-
ределяемый опцией NUMBER.



NOOP Ничего не делает. Приложе-
ния используют данное зада-
. ние для блокировки заданно-
го или выполняемого по
умолчанию действия.


DEST

Определяет URL, который должен
запрашиваться в заданиях GO и
6OSUB.


В заданиях RETURN ИЛИ CANCEL, При-

надлежащих вложенной процедуре,
параметр DEST определяет URL, кото-
рый должен запрашиваться после воз-
врата к действию, вызывавшему про-
цедуру. Данный параметр игнорирует-
ся браузером, если действие, вызы-
вающее процедуру, не отмечает ее как
дружественную.



REL=NEXT


Отдает телефону команду выполнить
предварительную выборку URL, за-
данного в опции DEST. После этого,
пока пользователь просматривает
текущую карту, телефон будет пы-
таться загрузить содержимое URL в
свой кэш. При запросе пользовате-
лем URL, хранящегося в кэше, ин-
формация будет отображаться теле-
фоном без задержки, которая обыч-
но обусловлена загрузкой ресурса в
память.


METHOD

Определяет метод (GET или POST),
применяемый для запроса URL, ука-
зываемого в параметре DEST. По
умолчанию используется метод GET.



Рекомендуется использовать метод
POST. Применение метода POST
обеспечивает перекодировку серве-
ром UP. Link данных, получаемых из
телефона, в набор символов, указы-
ваемый приложением в своих HTTP-
заголовках.


POSTDATA


Определяет данные, которые долж-
ны передаваться, если для парамет-
ра METHOD указано значение POST.
Если данные содержат более одного
аргумента, то следует разделять зна-
чения с помощью амперсанта (&).


ACCEPT-CHARSET


Определяет набор символов, кото-
рый в соответствии с ожиданиями
приложения должен использовать
телефон для возврата данных. Если в
элементе не определен параметр

ACCEPT-CHARSET, TO ПО умолчанию

будет использоваться набор симво-
лов указываемый в HTTP-заголовках
HDML-страницы.


VARS


Определяет список имен перемен-
ных и значений, которые должны
присваиваться при выполнении за-
дания GO ИЛИ GOSUB.



Список переменных и их значений
должен иметь следующий формат:

varl=valuel&var2=value2



Значения должны представляться в
виде ESCAPE-последовательностей в
соответствии с соглашениями об
ESCAPE-последовательностях URL.
Прежде чем использовать значения,
телефон будет декодировать их из
ESCAPE-последовательностей.


RECEIVE

Определяет список имен перемен-
ных, разделяемых точкой с запятой,
которые телефон использует для
хранения значений, возвращаемых
из GOSUB-задания.


RETVALS


Определяет список значений, разде-
ляемых точкой с запятой, которые
возвращаются GOSUB-заданием в дей-
ствие, вызвавшее GOSUB-задание. Оп-
ция RETVALS может использоваться
только с RETURN-заданием. Значения
должны представляться в виде
ESCAPE-последовательностей в соот-
ветствии с соглашениями об ESCAPE-
последовательностях URL


NEXT

Определяет URL, который должен
запрашиваться после того как вло-
женная процедура, вызванная с по-
мощью GOSUB-задания, возвращается
в задание, вызвавшее вложенную
процедуру. Данный параметр может
подавляться параметром DEST зада-
ния RETURN, принадлежащего вло-
женной процедуре, при условии,
что, когда вызывается GOSUB-
задание, параметр FRIEND имеет
значение true.


CANCEL


Определяет URL, который должен
запрашиваться после того как отме-
няется вложенная процедура, вы-
званная с помощью GOSUB-задания.
Данный параметр может подавлять-
ся параметром DEST CANCEL-задания,
принадлежащего вложенной проце-
дуре, при условии, что, когда вызы-
вается возив-задание, опции FRIEND
присвоено значение true.


FRIEND


Указывает, должна ли вложенная
процедура в GOSUB-задании считаться
дружественной. Дружественная вло-
женная процедура может использо-
вать параметры DEST или CLEAR в



RETURN- и CANCEL-заданиях для замены
значений, определяемых заданием,
которое вызывает вложенную проце-
дуру. По умолчанию параметру
FRIEND присваивается значение
false.


SENDREFERER


Определяет, должен ли браузер при
запросе с помощью параметров DEST
или NEXT нового URL предоставлять
URL текущей HDML-страницы в HTTP-
заголовках. По умолчанию парамет-
ру SENDREFERER присваивается зна-
чение false.


CLEAR

Определяет, может ли RETURN- или
CANCEL-задание из дружественной
вложенной процедуры сбрасывать в
исходное состояние все переменные
задания, которое вызывает вложен-
ную процедуру. Телефон будет игно-
рировать параметр CLEAR, если при
вызове текущего действия значение
параметра FRIEND не было равно
true. По умолчанию данному пара-
метру присваивается значение false.


NUMBER

Определяет для CALL-задания номер
вызываемого телефона.


SRC

Определяет URL графического объ-
екта, который должен использовать-
ся браузером вместо метки про-
граммной кнопки. Данная опция иг-
норируется, если параметру ICON
присвоено корректное имя. Так как
по умолчанию программным кноп-
кам не присваиваются метки, то при
использовании параметра SRC следу-
ет также определять параметр
LABEL, чтобы устройство отобража-
ло метку в случае, если указанный
графический объект не может быть
найден.


ICON

Определяет имя локального графи-
ческого объекта, который должен

использоваться браузером вместо
метки программной кнопки. Если
браузер не может обнаружить гра-
фический объект в ПЗУ устройства,
то графический объект будет полу-
чаться с сервера UP. Link. Так как по
умолчанию программным кнопкам
не присваиваются метки, то при ис-
пользовании параметра ICON следует
также определять параметр LABEL,
чтобы устройство отображало метку
в случае, если указанный графиче-
ский объект не может быть найден.

Элемент <СЕ>


Синтаксис:


<СЕ VALUE=значение LABEL=MeTKa ТАSК=задание

DEST=url REL=NEXT МЕТНОD=МEТОД РОSТDАТА=ДанНЫе

АССЕРТ-СНАRSЕТ=набор символов VARS=napbi перемен-
ная/значение RЕСЕLVЕ=СПИСОК RETVALS=CПИCOK
NEXT=url CANCEL=url FRIEND=Логическое значение
SENDEE РЕКЕК=Логическое значение CLEAR=логическое
значение NUMBER=число

Описание:

Определяет пункты списка, из которых пользователь
может делать свой выбор в элементе <CHOICE>.

Параметры:


VALUE При выборе пользователем данного
пункта списка, параметр VALUE оп-

ределяет необязательное значение,

' "

которое сохраняется телефоном в

переменной, указываемой в пара-
метре KEY элемента <CHOICE>, со-
держащего соответствующий эле-

мент<СЕ>.


LABEL Определяет метку кнопки ACCEPT
используемой при выборе пользова-
телем пункта из списка. Длина метки
не должна превышать пяти симво-
лов. Если значение метки не опреде-
ляется в явном виде, то по умолча-
нию используется метка ОК.


TASK


Определяет задание, которое долж-
но выполняться при выборе пользо-
вателем пункта списка. Параметр
TASK может быть любым из следую-
щих заданий:



GO Запрашивает URL, опреде-
ляемый опцией DEST.



GOSUB Запрашивает URL, опреде-
ляемый опцией DEST в каче-
стве вложенной процедуры.



RETURN Возвращает в предыдущее
действие из вложенной про-
цедуры.



CANCEL Отменяет текущую вложен-
ную процедуру и возвращает
к предыдущему действию.



PREV Отображает предыдущую
карту из стека предыстории.



CALL Размещает голосовой теле-
фонный вызов на номер, оп-
ределяемый опцией NUMBER.



NOOP Ничего не делает. Данное
задание может использо-
ваться для заданного или
выполняемого по умолчанию
действия.


DEST


Определяет URL запрашиваемый в
заданиях GO и GOSUB.

В заданиях RETURN или CANCEL, при-
надлежащих вложенной процедуре,
параметр DEST определяет URL, кото-
рый должен запрашиваться после воз-
врата к действию, вызывавшему про-
цедуру. Данный параметр игнорирует-
ся браузером, если действие, вызы-
вающее процедуру, не отмечает ее как
дружественную.


REL=NEXT

Отдает телефону команду на предва-
рительную выборку URL, заданного в
опции DEST. После этого, пока поль-



зователь просматривает текущую
карту, телефон будет пытаться загру-
зить в свой кэш следующий URL При
запросе пользователем URL, храня-
щегося в кэше, информация будет
отображаться телефоном без за-
держки, которая обычно обусловле-
на загрузкой ресурса в память.


METHOD

Определяет метод (GET или POST),
используемый для запроса URL, ука-
зываемого в параметре DEST. По
умолчанию используется метод GET.



Рекомендуется использовать метод
POST. Применение метода POST
обеспечивает перекодировку серве-
ром UP. Link данных, получаемых из
телефона в набор символов, указы-
ваемый приложением в своих HTTP-
заголовках.


POSTDATA

Определяет данные, которые долж-
ны посылаться, если для параметра
METHOD указано значение POST. Если
данные содержат несколько значе-
ний, то они должны разделяться с
помощью амперсанта (б).


ACCEPT-CHARSET


Определяет набор символов, кото-
рый в соответствии с ожиданиями
приложения должен использовать
телефон для возврата данных. Если
параметр ACCEPT-CHARSET не опре-
делен, то по умолчанию будет ис-
пользоваться набор символов указы-
ваемый в HTTP-заголовках HDML-
страницы.


VARS

Определяет список имен перемен-
ных и значений, присваиваемых при
выполнении задания GO или GOSUB.



Список переменных и их значений
должен иметь следующий формат:

var l=valuel &var2=value2



Значения должны представляться в
виде ESCAPE-последовательностей в
соответствии с соглашениями об
ESCAPE-последовательностях URL.
Прежде чем использовать значения,
телефон будет декодировать их из
ESCAPE-последовательностей.


RECEIVE

Определяет список имен перемен-
ных, разделяемых точкой с запятой,
которые телефон использует для
хранения значений, возвращаемых
из GOSUB-задания.


RETVALS


Определяет список значений, разде-
ляемых точкой с запятой, которые
возвращаются GOSUB-заданием в за-
дание, вызвавшее GOSUB. Параметр
RETVALS можно использоваться толь-
ко с RETURN-заданием. Значения
должны представляться в виде
ESCAPE-последовательностей в соот-
ветствии с соглашениями об ESCAPE-
последовательностях URL.


NEXT

Определяет URL, который должен
запрашиваться после того как вло-
женная процедура, вызванная с по-
мощью GOSUB-задания, возвращается
в задание, вызвавшее вложенную
процедуру. Данный параметр может
подавляться параметром DEST зада-
ния RETURN, принадлежащего вло-
женной процедуре, при условии,
что, когда вызывается GOSUB-
задание, параметр FRIEND имеет
значение true.


CANCEL


Определяет URL, который должен
запрашиваться после того как отме-
няется вложенная процедура, вы-
званная с помощью GOSUB-задания.
Данный параметр может подавляться
параметром DEST CANCEL-задания,
принадлежащего вложенной проце-
дуре, при условии, что, когда вызы-



вается GOSUB-задание, параметр
FRIEND имеет значение true.


FRIEND

Указывает, должна ли вложенная
процедура в GOSUB-задании считать-
ся дружественной. Дружественная
вложенная процедура может исполь-
зовать параметры DEST и CLEAR в
своих RETURN- и CANCEL-заданиях
для замены значений, определяемых
заданием, которое вызывает вло-
женную процедуру. По умолчанию
параметру FRIEND присваивается
значение FALSE.


SENDREFERER

Определяет, должен ли браузер при
запросе с помощью параметров DEST
или NEXT нового URL предоставлять
URL текущей HDML-страницы в HTTP-
заголовках. По умолчанию парамет-
ру SENDREFERER присваивается зна-
чение false.


CLEAR
NUMBER

Определяет, может ли RETURN- или
CANCEL-задание из дружественной
вложенной процедуры сбрасывать в
исходное состояние все переменные
задания, которое вызывает вложен-
ную процедуру. Телефон будет игно-
рировать параметр CLEAR, если при
вызове текущего действия значение
параметра FRIEND не было равно
true. По умолчанию данному пара-
метру присваивается значение
false.

Определяет для CALL-задания номер
вызываемого телефона.


Text

Форматированный текст, который
описывает пункт, выбираемый из
списка. В качестве пункта списка
можно использовать графический
объект, включив в текст элемент
<IMG>.



По умолчанию информация отобра-
жается в режиме <LINE> (прокрутка


экрана по горизонтали). Чтобы из-
менить режим отображения, вставьте
перед текстом элемент <WRAP>.

Если параметр METHOD, указываемый
в элементе <CHOICE>, не определен
или ему присвоено значение
NUMBERED, телефон будет автомати-
чески нумеровать первые девять
пунктов списка. Пронумерованные
пункты списка могут затем выби-
раться путем нажатия на телефон-
ной трубке кнопок с соответствую-
щими номерами.


Элемент <CHOICE>


Синтаксис:


<СНОIСЕ NАМЕ=имя МАRКАВLЕ=Логическое значение
ТIТLЕ=заголовок BOOKMARK=url КЕУ=переменная
LКЕУ=переменная METHOD=метод DEFAULT=значение

IDEFAULT=индекс>
actions
text
<CE...>text


Описание:



Карта <CHOICE> (выбор пунктов списка) отображает
текст, за текстом следует список пунктов, из которых
пользователь может выбрать один пункт. Элемент
<СН01СЕ> должен включать в себя один или несколько
элементов <СЕ>, определяющих пункты списка.

Параметры:

NAME Определяет имя карты. Другие кар-
ты могут переходить на данную кар-
ту, используя ее имя как адрес пункта
назначения.


MASKABLE Определяет возможность установки
закладки на карту. Значение, исполь-
зуемое по умолчанию, определяется параметром MARKABLE для HDML-
страницы.


TITLE Определяет имя, используемое по
умолчанию браузером при установке
пользователем закладки на карту.


BOOKMARK

Определяет URL, который телефон
добавляет в свой список закладок
при установке пользователем за-
кладки на карту. Если значение па-
раметра BOOKMARK не определено,
используется URL текущей карты.


KEY

Определяет имя переменной, кото-
рой присваивается значение выби-
раемого пользователем пункта спи-
ска (если для данного пункта опре-
делено значение).

IKEY

Определяет имя переменной, кото-
рая первоначально хранит индекс
(номер) пункта списка, выбираемого
приложением по умолчанию, и ко-
торой присваивается индекс пункта,
выбираемого пользователем. Если
для параметра IKEY значение не оп-
ределено, то по умолчанию будет
использоваться параметр IDEFAULT.
Если и для параметра IDEFAULT не
указано значение, то пунктом, выби-
раемым приложением по умолча-
нию, будет первый пункт списка.


METHOD


Определяет, будет ли браузер нуме-
ровать список. Если данному пара-
метру присвоено значение NUMBER,
телефон автоматически нумерует
первые девять пунктов списка. Затем
пользователь может выбирать пункт
из списка, нажимая на клавиатуре
телефона кнопку с номером выби-
раемого пункта. По умолчанию па-
раметру METHOD присваивается зна-
чение NUMBER.



Если параметру METHOD присвоено
значение ALPHA, список не нумерует-
ся, соответственно, чтобы сделать
свой выбор, пользователь должен
прокрутить экран до требуемого
пункта списка и нажать кнопку
ACCEPT.


DEFAULT

Определяет значение, присваивае-
мое по умолчанию переменной, оп-
ределяемой в параметре KEY. Если
при выводе карты на экран пере-
менной, указываемой в параметре
KEY, не присвоено значение, то ей
присваивается значение данного
параметра. Если переменной, опре-
деляемой параметром KEY, присвое-
но значение, то значение параметра
DEFAULT не изменяется.



IDEFAULT


Определяет индекс пункта, выби-
раемого приложением по умолча-
нию, если параметр IKEY не опреде-
лен или указывает переменную, ко-
торая не имеет значения. При кор-
ректном определении параметра
IKEY, параметр IDEFAULT игнориру-
ется устройством.


Actions

Определяет действия, выполняемые
при нажатии пользователем кнопки.
Если пункт, выбираемый пользова-
телем, определяет какое-либо зада-
ние (task), то это задание отменяет
действия, указываемые в данном па-
раметре.


Text

Содержит форматированный текст,
определяющий заголовок, который
браузер будет отображать над спи-
ском пунктов. Если данный текст вы-
водится на экран в режиме <LIKE>, то
текст, отображаемый на всю ширину
экрана, будет обрезаться.



<CE...>text

Определяет пункт списка, из кото-
рого пользователь может делать
свой выбор, и текст, описывающий
этот пункт.

Элемент <DISPLAY>


Синтаксис:


<DISPLAY NАМЕ=ИМЯ ТIТLЕ=ЗAГОЛОВОК

МАRКАВLЕ=Логическое значение BOOKMARK=url>
actions


</DISPLAY>

Описание:

Отображает форматированный текст.

Параметры:


NAME Определяет имя карты. Другие кар-
ты могут переходить на данную кар-

ту, используя ее имя как адрес пункта

назначения.


TITLE Определяет имя, которое использу-
ется по умолчанию при установке
пользователем закладки на карту.


MARKABLE Определяет возможность установки
закладки на карту. Значение, исполь-
зуемое по умолчанию, определяется
параметром MARKABLE для HDML-
страницы.


BOOKMARK Определяет URL, который телефон
добавляет в свой список закладок
при установке пользователем за-
кладки на карту. Если значение па-
раметра BOOKMARK не определено,
используется URL текущей карты.


Actions Определяет действия, выполняемые
телефоном при нажатии пользова-

телем кнопки.


Text Определяет форматированный
текст отображаемый картой.

Элемент <ENTRY>


Синтаксис:

<ENTRY NAME=ИMЯ МАRКАВLЕ=Логическое значение

ТIТLЕ=ЗаГОЛОВОК BOOKMARK=url FОRМАТ=формат

FILL=заполнение DEFAULT=используемый по умолчанию
КЕУ=переменная NOECHO=Логическое значение
ЕМРТY=Логическое значение>

actions


text

</ENTRY>

Описание:

Отображает приглашение на взаимодействие с прило-
жением и предоставляет пользователю возможность
ввода данных.

Параметры:

NAME Определяет имя карты. Другие кар-
ты могут переходить на данную кар-
ту, используя ее имя как адрес пункта
назначения.



MARKABLE Определяет возможность установки
закладки на данную карту. Значение,
используемое по умолчанию, опре-
деляется параметром MARKABLE для
HDML-страницы.


TITLE Определяет имя по умолчанию, ис-
пользуемое телефоном при установке
пользователем закладки на карту.


BOOKMARK Определяет URL, который телефон
добавляет в свой список закладок
при установке пользователем за-
кладки на карту. Если значение па-
раметра BOOKMARK не определено,

используется URL текущей карты.


FORMAT Определяет формат данных, вводи-
мых пользователем. Спецификация
формата может принимать следую-
щие значения:


А Любой символ или пропис-
ная буква.


а Любой символ или строчная
буква.


N Любая цифра.



X Любой символ, цифра или

прописная буква.



х Любой символ, цифра или
строчная буква.



If Любой символ, цифра или
прописная буква (может из-
меняться на строчную).



m Любой символ, цифра или
строчная буква (может изме-
. няться на прописную).



По умолчанию в качестве специфи-
кации формата используется значе-
ние "*м", допускающая ввод произ-
вольного количества символов,
цифр или комбинаций строчных и
прописных букв.


DEFAULT


Определяет текст, который появляет-
ся в поле ввода данных при первона-
чальном выводе карты браузером на
экран. Данный текст может редакти-
роваться пользователем.


KEY


Указывает имя переменной, которая
хранит текст, вводимый пользовате-
лем. Если указанная переменная уже
имеет значение, это значение ис-
пользуется по умолчанию в качестве
вводимых данных.



Если данная переменная уже имеет
значение, оно заменяет значение,
указываемое в параметре DEFAULT.



NOECHO


Определяет, должен ли телефон
маскировать текст, вводимый
пользователем. Если данный
параметр имеет значение true,
телефон будет отображать звёздочки
вместо любых символов, вводимых
пользователем. По умолчанию дан-
ному параметру присваивается
значение false.


EMPTYOK Указывает, что для данной перемен-
ной телефоном допускается ввод
пустого значения.


Actions Определяет действия, которые будут
выполняться телефоном при нажа-
тии пользователем кнопки.


Text Содержит форматированный текст,
определяющий заголовок, который
будет отображаться браузером над
строкой ввода данных.


Элемент <HDML>


Синтаксис:


<HDML VERSION=Bepсия ТТL=ВремЯ
МАRКАВLЕ=Логическое значение PUBLIC=Логическое
значение АССЕSSDОМАIN=домен АССЕSSРАТН=путь>

Описание:


Элемент <HDML> определяет HDML-страницу и содержит
в заголовке информацию, описывающую HDML-
страницу. Элемент <HDML> также должен содержать одну
или несколько карт выбора пунктов списка, справочной
информации или ввода данных, а также может опреде-
лять параметры и действия, которые распространяются
на все карты HDML-страницы.

Параметры:


VERSION Определяет версию языка HDML,
используемого для описания HDML-
страницы. Параметр определяется в
соответствии со следующим синтак-
сисом: major .minor .lexical. Указа-
ние номера версии носит обязатель-
ный характер. К корректным номе-
рам версий относятся 1.0 и 3.0. Вер-
сия лексического анализатора lexi-
cal является необязательным
параметром.


TTL Определяет время в секундах, в те-
чение которого HDML-страница
должна сохраняться в кэше телефо-

на. Если для данного параметра не
указано значение, то по умолчанию
HDML-страница будет сохраняться в
кэше в течение 30 дней. Если пара-



метру присваивается нулевое значе-
ние, HDML-страница не будет сохра-
няться в кэше.


MARKABLE


Определяет, могут ли карты HDML-
страницы отмечаться закладками.
Данный параметр подавляется па-
раметром MARKABLE ДЛЯ ОТДСЛЬНЫХ
карт HDML-страницы.


PUBLIC




Определяет наличие управления
доступом к данной HDML-странице.
Если параметру присвоено значение
TRUE, то любая HDML-страница мо-
жет иметь ссылки на карты данной
HDML-страницы. Если параметру
присвоено значение FALSE, то толь-
ко HDML-страницы, домены и пути
которых соответствуют значениям
параметров ACCESSDOMAIN и
ACCESSPATH, могут иметь ссылки на
карты данной HDML-страницы.


ACCESSDOMAIN

Определяет домен HDML-страниц,
которым разрешается иметь ссылки
на карты данной HDML-страницы,
если параметру PUBLIC присвоено
значение FALSE. По умолчанию зна-
чением данного параметра является
домен текущей HDML-страницы.


ACCESS PATH


Определяет путь HDML-страниц, ко-
торым разрешается иметь ссылки на
карты данной HDML-страницы, если
параметру PUBLIC присвоено значе-
ние FALSE. По умолчанию значением
данного параметра является корне-
вой каталог текущей HDML-страницы,
так что любая HDML-страница из до-
мена, указанного в параметре
ACCESSDOMAIN, может иметь ссылки
на карты данной HDML-страницы.


Actions

Определяет действия, которые рас-
пространяются на все карты HDML-
страницы.


Cards

Включает одну или несколько карт.

Элемент <IMG>


Синтаксис:

<IMG АLТ=текст SRC=url ICON=пиктограмма>

Описание:


Определяет графический объект, который будет появ-
ляться в форматированном тексте, если телефон под-
держивает отображение графики. Графические объекты
могут размещаться в любой символьной строке форма-
тированного текста, такой как текст, отображаемый в
картах выбора пунктов списка, справочной информа-
ции и ввода данных и в пунктах списка. Графические
объекты могут также использоваться в качестве меток
программных кнопок.

Параметры:

ALT Определяет текст, который должен
отображаться, если браузер не мо-
жет вывести на экран графический
объект. Данный текст будет выво-
диться, если телефон не поддержи-
вает графику или если графический
объект не может быть найден.


SRC Определяет URL графического объ-
екта, который должен выводиться на
экран. Если в параметре ICON указы-
вается корректное имя, значение
данного параметра будет игнориро-
ваться устройством.


ICON, Определяет имя локального графи-
ческого объекта, который должен
выводиться на экран. Если браузер
не может найти графический объект
в ПЗУ устройства, то этот графиче-
ский объект будет загружаться с сер-
вера UP. Link.

Элемент <NODISPLAY>


Синтаксис:


<NODISPLAY ЫАМЕ=ИМЯ>

actions

</NODISPLAY>

Описание:

Карта <NODISPLAY> используется для инициализации
переменных. Она немедленно выполняет действия
ACCEPT или PREV, без отображения каких-либо данных на
экране телефона.

Параметры:

NAME

Определяет имя карты. Другие кар-
ты могут переходить на данную кар-
ту, используя ее имя как адрес пункта
назначения.


Actions

Определяет действия, которые
должны выполняться при переходе
пользователя на карту. Когда поль-
зователь переходит на карту в пря-
мом направлении, автоматически
выполняется действие ACCEPT. Когда
выполняется переход в обратном
направлении, автоматически вы-
полняется действие PREV.



Логические операции



Логические операции

Язык WMLScript поддерживает следующие базовые логические операции:

Оператор

Операция

&&

логическое «И» (AND)


II

логическое «ИЛИ» (OR)

!

логическое отрицание (NOT)

Оператор логического «И» (AND) вычисляет первый операнд и проверяет результат. Если получено логическое значение true (Истина), то результат операции будет равен значению второго операнда. Если получено логическое значение
false (Ложь) или недопустимое значение, то результат будет равен логическому
значению false или значению invalid (Недопустимое значение), и второй операнд не будет вычисляться. Также оператор логического «ИЛИ» (OR) вычисляет первый операнд и проверяет результат. Если получено логическое значение true или недопустимое значение, то результат операции будет равен логическому значению true или invalid.
Если получено логическое значение false, то результат операции будет равен
значению второго операнда.



Оператор Isvalid



Оператор Isvalid


Оператор isvalid возвращает логическое значение true, если тип выражения
относится к допустимым типам и false, если выражение имеет недопустимый
тип,




Оператор Typeof



Оператор Typeof

Язык WMLScript поддерживает следующие базовые типы данных: Boolean (логические значения), integer (целые числа), floating point (числа с плавающей
запятой), string (символьные строки), и invalid (недопустимые значения).
Оператор Typeof возвращает целочисленное значение, указывающее тип данного выражения. Оператор Typeof может принимать следующие значения:

Тип

Возвращаемое значение

Integer (целое число)


Floating point (число с плавающей запятой)

1

String (строка)

2

Boolean (логическое значение)

3

Invalid (недопустимое значение)

4



Операторы присваивания



Операторы присваивания

Операторы присваивания назначают переменным их значения. Язык описания
сценариев WMLScript поддерживает следующие операторы присваивания:

Оператор

Операция

=

присваивание

+=

сложение чисел или объединение символьных строк и
присваивание

-=

вычитание и присваивание

*=

умножение и присваивание

/=

деление и присваивание

div=

целочисленное деление и присваивание

%=

получение остатка и присваивание (знак результата сов-
падает со знаком делимого)

«=

поразрядное смещение влево и присваивание

»=

поразрядное смещение вправо и присваивание

>»=

поразрядное смещение вправо с заполнением нулями и
присваивание

&-

поразрядная операция «И» (AND) и присваивание

/\=

поразрядная операция «исключающее ИЛИ» (XOR) и
присваивание

\-

поразрядная операция «ИЛИ» (OR) и присваивание



Операторы сравнения



Операторы сравнения

Язык WMLScript поддерживает следующие базовые операции сравнения:

Оператор

Операция

<

меньше

<- .,>

меньше или равно

==

равно

>=

больше или равно

>

больше

! =

не равно

Логическое значение true больше логического значения false.

Если один из операндов имеет недопустимое значение, результат
сравнения принимает значение invalid.



Справочник по WMLScript


Справочник по WMLScript Операторы присваивания Арифметические операции Логические операции Строковые операторы Операторы сравнения Условный оператор Оператор Typeof Оператор lsvalid Библиотека Lang Библиотека Float Библиотека String Библиотека URL Библиотека WMLBrowser Библиотека Dialogs Библиотека Console

Строковые операторы



Строковые операторы

Язык WMLScript поддерживает объединение строк в качестве встроенной операции. Операторы «+» и «+=», используемые с символьными строками, выполняют
объединение символьных строк. Выполнение других операций со строками реализуется с помощью функций библиотеки String.



Теги


Тег <а>


Синтаксис:
Описание:

<а href="url" title="label">
text
</а>

Сокращенная форма тега <anchor>. Используйте только
для определения неявных <до>-заданий.

Параметры:

href

Запрашиваемый URL.


title

Метка (надпись), которая должна
использоваться для кнопки ACCEPT
(Ввод).


text

Любой форматированный текст.

Teг<access>


Синтаксис:

<head>
<acces domain=" domain" path="path" />
</head>

Описание:

Определяет информацию, управляющую доступом к дан-
ным WML-страницы. По умолчанию все WML-страницы
объявляются общедоступными.

Параметры:

domain

Домен URL других WML-страниц, ко-
торые могут иметь доступ к картам
WML-страницы. По умолчанию это
домен текущей WML-страницы.

Г

path

Корневой URL других WML-страниц,
которые могут иметь доступ к кар-
там данной WML-страницы.

Тег <anchor>


Синтаксис:

<anchor title="label">
task
text
</anchor>

Описание:


Связывает задание task с текстовой строкой или ссыл-
кой. Когда пользователь выбирает текст ссылки и на-
жимает кнопку ACCEPT, устройство выполняет указан-
ное задание.

Параметры:

title


Определяет метку для ссылки. Если
данный параметр title не опреде-
лен, то в качестве метки по умолча-
нию используется слово Link. Мо-
жет использоваться в качестве метки
для кнопки ACCEPT, причем длина
не должна превышать пяти симво-




task

В качестве задания должны указы-
ваться элементы <go>, <prev> или
<refresh>.


text

Любой форматированный текст.
Обычно устройство некоторым об-
разом выделяет текст, как правило,
заключая его в скобки.

Тег<b>



Синтаксис:

<b>text</b>


Описание:

Отображает текст полужирным шрифтом.

Параметры:

text


Текст, который должен отображать-
ся полужирным шрифтом.

Тег<br/>


Синтаксис:

<br/>

Описание:


Определяет разрыв строки. Текст, следующий после
разрыва строки, отображается на экране телефона с но-
вой строки.

Все WML-элементы требуют наличия символа конца (/), поэтому
синтаксис тега разрыва строки должен быть <br/>, а не <br>, как
это было бы в HTML.

Тег <card>


Синтаксис:


, <card id ="name" title=" label" newcon-
text="boolean" ordered="boolean" onenterfor-
ward="url" onenterbackward="url" ontimer="url">

content
<card/>

Описание:

Карта (card) определяет порядок взаимодействия между
пользователем и устройством. Устройство отображает
за раз максимум одну карту. Полное отображение одной
карты может занимать несколько экранов. WML-
страница содержит одну или несколько карт.

Параметры:

Определяет для карты ее имя, кото-
рое используется при навигации по

Картам.


Определяет метку для карты. Брау-
зер использует метку как имя заклад-
ки, по умолчанию, когда пользова-
тель помечает карту закладкой
(Bookmark).


new-

context

Определяет отсутствие или наличие
инициализации контекста (служеб-
ой информации) устройства при
переходе пользователя на данную
карту. При инициализации контекста
устройства удаляются все перемен-
ные, связанные с контекстом, очи-
щается стек предыстории и устрой-



ство устанавливается в известное со-
стояние. По умолчанию данному па-
раметру присваивается значение
FALSE (Ложь).



ordered


Определяет структуру карты. Уста-
навливаемое по умолчанию значе-
ние true (Истина) заставляет уст-
ройство отображать содержимое
карты в фиксированной последова-
тельности.


onenterforward



Определяет URL, который должен
открывать и выполнять браузер, ко-
гда пользователь переходит на карту
посредством <до>-задания.

.

onenterbackward


Определяет URL, который должен
открывать и выполнять браузер, ко-
гда пользователь переходит на карту
посредством <prev>-зaдaния.


ontimer



Определяет URL, который должен
открывать и выполнять браузер, ко-
гда истекает время, установленное с
помощью элемента <timer>. ...



Ter<do>

content


Любой из следующих элементов:
<onevent>
<timer>
<do>
<a>
<fieldset>
<img>
<input>
<select>
<p>

Описание:

Связывает задание с функциональной кнопкой или дру-
гим элементом пользовательского интерфейса. При ак-
тивизации кнопки пользователем устройство выполняет
задание.

Параметры:

type


Определяет действие пользователя,
которое активизирует задание. В
качестве значения параметра type
(Тип) могут использоваться accept,
delete, help, options или prev, со-
ответствующие действию пользова-
теля.


label


Отображается устройством как мет-
ка функциональной кнопки. Длина
метки не должна превышать пяти
символов. Только функции ACCEPT и
OPTIONS поддерживают использова-
ние метки.


name

Определяет имя элемента <do>.

optional

Определяет, может ли устройство
игнорировать данный элемент <do>.



Задание, которое должно выпол-
няться устройством при выполне-
нии пользователем определенного
действия. Параметр task должен
принимать одно из следующих зна-
чений: <go>, <prev>, <noop> или
<refresh>.

Ter<em>



Синтаксис:

<em>Text</em>


Описание:

Отображает выделенный текст.

Параметры:

text

Текст, который должен отображать-
ся выделенным шрифтом.

В настоящее время браузер UP.Browser не поддерживает текст, вы-
деляемый с помощью тега <eт>.

Тег <f ieldset>


Синтаксис:

<fieldset title=" label ">

content
</f ieldset>

Описание:

Позволяет группировать внутри отдельной карты блоки
текста и элементы ввода.

Параметры:

title

Определяет метку группы
<fieldset>. Параметр title (заго-
ловок) может использоваться раз-
ными устройствами по-разному: как
заголовок (title) или как пригла-
шение (prompt).


content

Определяет группируемые элемен-
ты. Может включать любой из сле-
дующих типов элементов:
<f ieldset>, <input> и <select>.

Тег <go>


Синтаксис:

<go href="nrl" sendreferer="Boolean" method="method"
accept- char se t= " char se t "

<postfield name="data" value="value" />
content
</go>

Описание:

Отдает устройству команду открыть определенный URL.
Если URL определяет карту, устройство отображает эту
карту. Если URL определяет WML-страницу, устройство
отображает первую карту в этой WML-странице.

Параметры:

URL, который следует открыть.


sendreferer Определяет, должно ли устройство

включать в запрос URL WML-
страницы. Если параметр принима-
ет значение true, устройство уста-
навливает заголовок HTTP_REFERER
на относительный URL WML-
страницы. По умолчанию данный
параметр принимает значение
false.


method Определяет метод передачи для
HTTP-протокола. По умолчанию ме-
тод принимает значение get. Если



вы в явном виде определяете метод
как post или используете вложен-
ный элемент <postf ield>, то метод
изменяет значение на post.


accept-charset

Определяет кодировки символов, с
которыми может работать прило-
жение.

Ter<head>



Синтаксис:

<head>
content
</head>


Описание:

Описывает информацию о WML-странице, включая ин-
формацию, управляющую доступом и метаданные.

Параметры:

content

Определяет информацию заголовка
WML-страницы. Может представлять
собой элемент <access> или один
или несколько элементов <meta>.


Тег <i>



Синтаксис:

<i>text</i>


Описание:

Отображает текст курсивом.

Параметры:

text

Текст, который должен отображать-
ся курсивом.

Ter<img>


Синтаксис:

<img alt="text" src="url" localsrc="icon"
align="alignment" hspace="n" />

Описание:

Отображает графический объект внутри форматиро-
ванного текста.

Параметры:

alt


Определяет текст, отображаемый в
случае, если устройство не поддер-
живает графику или указанный
графический объект не может быть
найден.


src


URL графического объекта, который
должен отображаться устройством.



Данный параметр игнорируется,
если в параметре localsrc задается
корректная пиктограмма.


localsrc


Имя пиктограммы, которую следует
отобразить. Устройство будет пы-
таться найти пиктограмму в своем
ПЗУ. Если указано имя существую-
щей пиктограммы, то параметры
alt и src игнорируются. Тем не ме-
нее, присутствие параметров alt и
src носит все еще обязательный ха-
рактер.

align


Определяет выравнивание графиче-
ского объекта относительно теку-
щей текстовой строки. Должен при-
нимать одно из следующих значе-
ний: top, middle или bottom. По
умолчанию данному параметру при-
сваивается значение bottom.



Определяет пространство слева и
справа от графического объекта.

Ter <input>



Синтаксис:


text

<input name="variable" title="label" type="type"
value="value" f ormat="format11 emptyok="boolean"
maxlength="n" />

Описание:

Предоставляет пользователю возможность вводить
текст, который приложение присваивает переменной.

Параметры:

text


Текст, который устройство отобра-
жает в качестве приглашения поль-
зователю на взаимодействие с при-
ложением.


name

Имя переменной, которой присваи-
ваются данные, вводимые пользова-
телем.


title

Определяет метку вводимого эле-
мента.



Определяет, как устройство должно
отображать текст, вводимый пользе-



вателем. При указании для данного
параметра значения "text" текст
отображается на экране. При указа-
нии для данного параметра значения
"password" символы текста маски-
руются (заменяются на символы *).


value

Определяет значение, которое будет
присваиваться при вводе по умолча-
нию.


format

Определяет формат, которому долж-
ны соответствовать данные,
вводимые пользователем. Специфи-
кация формата может принимать
следующие значения:



А Любой символ или пропис-
ная буква.



а Любой символ или строчная
буква.



N Любая цифра.



X Любой символ, цифра или
прописная буква.



х Любой символ, цифра или
строчная буква.



М Любой символ, цифра или
прописная буква (может из-
меняться на строчную).



ю Любой символ, цифра или
строчная буква (может изме-
няться на прописную). ,


Для ограничения числа вводимых пользователем сим-
волов можно указывать их число перед спецификацией
формата. При указании в спецификации звездочки (*)
допускается вводить произвольное число символов.

Тег <meta>


Синтаксис:

<meta property="property" content="value" forua=
"Boolean"

Описание:

Указывает для WML-страницы метаинформацию.

Параметры:


property

B определении параметра должна
присутствовать строка http-
equiv="Cache-Control", которая
сообщает WAP-браузеру, что данная
часть метаинформации относится к
системе кэширования памяти.


content



Значение должно представляться в
формате content=max-age=nnn и
определять максимальное время, в
течение которого должно сохра-
няться содержимое данной WML-
страницы в кэше браузера. По умол-
чанию используется значение, рав-
ное 30 дням.


forua

Указывает, должен или нет параметр
property передаваться на телефон. ,


Тег <nоор>



Синтаксис:

<nooр />

Описание:

Отдает устройству команду ничего не делать.

Тег <onevent>


Синтаксис:


<onevent type="type">task</onevent>

Описание:


Связывает событие с заданием. При наступлении собы-
тия устройство выполняет задание, связанное с событи-
ем.

Параметры:


type

Действие, которое вызывает наступ-
ление события. Параметр type может
принимать следующие значения:
<onpick>, <onenterforward>,
<onenterbackward> или <ontimer>.


task

Задание, которое должно выполнять-
ся устройством при наступлении со-
бытия. Параметр task должен при-
нимать одно из следующих значений:
<go>, <prev>, <noop> или <ref resh>.

Тег <optgroup>


Синтаксис:

<optgroup title=" label ">content</optgroup>

Описание:


Позволяет группировать несколько элементов <option>.

и Параметры:


title


Определяет метку для группы. Уст-
ройство может использовать эту
метку в качестве заголовка при ото-
бражении устройством содержания
<optgroup>.


content


Может быть элементом <option>
или другим элементом <optgroup>.

В настоящее время браузер UP.Browser не поддерживает тег
<optgroup>.

Тег <option>

:

Синтаксис:

<option title="label" value="value" onpick="url">
content
</option>

Описание:

Определяет выбор пользователя внутри элемента
<select>.

Параметры:



title


Определяет метку, идентифици-
рующую опцию. При выборе поль-
зователем опции заголовок исполь-
зуется устройством в качестве метки
для кнопки ACCEPT. Длина метки не
должна превышать пяти символов.


value


Определяет значение, которое долж-
но присваиваться переменной, ука-
зываемой в элементе <select>,
когда пользователь выбирает опцию.


onpick

Указывает URL, который должен от-
крываться, если пользователь вы-
брал из списка заданную опцию.


content

Текст, который отображается уст-
ройством, чтобы представить еде-


данный выбор и, если требуется,
может указывать на действие, кото-
рое следует выполнить при выборе
опции пользователем.

Тег<р>


Синтаксис;

<р align="alignment" mode="wrapmode">
content

Описание:

Определяет новый абзац, а также опции выравнивания
и обтекания текста.

Параметры:


align


Определяет выравнивание текста на
экране. Опции выравнивания могут
принимать значения: left, right и
center. По умолчанию используется
значение left (выравнивание влево).


mode

Определяет режим обтекания тек-
ста. Опциями данного параметра
являются wrap и nowrap. При выборе
в качестве значения nowrap, устрой-
ство для отображения длинных
строк использует горизонтальную
прокрутку экрана. Если не указывать
режим обтекания текста, устройство
продолжает использовать ранее ус-
тановленное значение. Если значе-
ние параметра ранее не определя-
лось, устройство будет использовать
режим по умолчанию, каковым яв-
ляется wrap.


Тег <postf ield>



Синтаксис:

<postfield name="name" value="value" />

Описание:

У  '"'.'! 'i'l ОТ. .-

Определяет пары имя/значение (name/value), которые
приложение передает на сервер с помощью операции

<до>. . .,,.-., :..:>>,.,,:..'

Параметры:

name

Имя переменной.


value

Символьная строка, задающая зна-
чение поименованной переменной.

Тег <prev>


Синтаксис:

<prev>content< /prev>

Описание:

Команда устройству на переход к предыдущему URL. Ес-
ли в стеке предыстории отсутствует предыдущий URL,
то данная операция не имеет какого-либо эффекта.

Параметры:

content Один или несколько операторов
<setvar> (которые могут отсутство-
вать) для присвоения значений пе-
ременным до того, как будет откры-
ваться предыдущий URL.

Параметр content является необязательным. Если вы не указы-
ваете какого-либо содержимого (content), то вместо синтаксиче-
ской конструкции <prev>content</prev> должен использоваться
тег </prev>.


Ter<refresh>


Синтаксис:

<refresh>content</ refresh>


Описание:

Команда устройству на регенерацию переменных, опре-
деляемых в параметре content. Экран также обновляет-
ся, если в текущий момент на нем отображаются какие-
либо из указанных переменных.

Параметры:


content

Один или несколько элементов
<setvar>.


Тег <select>


Синтаксис:

text

<select title="label" multiple="boolean"
name="variable" value="default" iname="index"
ivalue="default">

content
</select>

Описание:

Определяет список опций, из которого пользователь
может делать свой выбор.

Параметры:

text Любой форматированный текст или

графический объект. Телефон ото-



бражает содержимое данного пара-
метра (text) в качестве приглаше-
ния пользователю на взаимодейст-
вие с приложением.


title

Определяет метку для списка, из ко-
торого производится выбор. Может
отображаться некоторыми устрой-
ствами как метка списка.


multiple

Указывает, может ли пользователь
выбирать из списка сразу несколько
элементов. По умолчанию данный
параметр принимает значение
false.


name

Определяет имя переменной, ис-
пользуемой устройством для хране-
ния значения, связанного с опцией,
которую выбирает пользователь.
Если сделан выбор нескольких спи-
сочных элементов, значения хра-
нятся в виде списка с разделителем в
виде точки с запятой.


value


Определяет значение, присваиваемое
по умолчанию переменной, опреде-
ляемой параметром name. Если при
выполнении элемента <select>, пе-
ременной уже присвоено значение, то
сохраняется присвоенное значение, а
данное значение, используемое по
умолчанию, игнорируется.


iname


Определяет имя переменной, ис-
пользуемой устройством для хране-
ния индекса, связанного с выбирае-
мой пользователем опцией. Значе-
ние индекса для каждой опции пред-
ставляет собой позицию опции в
списке, из которого осуществляется
выбор. Для первой позиции значе-
ние индекса равно единице.


ivalue

Определяет для переменной, опре-
деляемой параметром iname, значе-
ние индекса, используемое по умол-
чанию.

'

content

Определяет список пунктов, из ко-
торых пользователь может делать
свой выбор. Содержит один или не-
сколько элементов <option>.

Ter<setvar>


Синтаксис:

<setvar name="name" value="value" />

Описание:


Присваивает переменной определенное значение, пре-
жде чем устройство будет выполнять операцию <до>,
<prev> или <ref resh>.

Параметры:

name

Имя переменной.



Значение, присваиваемое поимено-
ванной переменной.

Тег <small>


Синтаксис:

<small>text</small>

Описание:

Отображает текст уменьшенным шрифтом.

Параметры:

text

Текст, отображаемый уменьшенным

шрифтом.

Б настоящее время браузер UP. Browser не поддерживает уменьшен-
ный шрифт.

Ter<strong>

Синтаксис:

Описание:

Отображает выделенный текст.

Параметры:

text Текст, отображаемый выделенным


В настоящее время браузер UP.Browser не поддерживает текст, вы-
деляемый с помощью тега <strong>.

Ter<table>


Синтаксис:

<table title="name" align="alignment" columns="n"
table data
</table>

Описание:

Позволяет отображать информацию в виде таблицы.

Параметры:

title

Определяет метку (может отсутство-
вать) для таблицы.


align


Определяет выравнивание текста в
колонках. Существуют следующие
опции выравнивания: left, center
или right. Если значение не опре-
делено, по умолчанию используется
выравнивание влево (left).


columns


Определяет число колонок в табли-
це. Наличие данного параметра обя-
зательно, причем не допускается
присваивание нулевого значения.


table data

Включает элементы <tr> и <td>, оп-
ределяющие содержимое таблицы.

Ter<td>


" -  ' ' *'  '''.'''.,.

Синтаксис:

<td>content</td>


Описание:

Определяет данные одной ячейки таблицы.

Параметры:


content

Содержит текст, элементы <img> или
<anchor>, которые представляют
содержимое ячейки таблицы.

Тег <tr>


Синтаксис:
Описание:

<tr>

<td>content</td>

</tr>

Определяет данные одной строки таблицы.

Параметры:

content

Содержит элементы <td>, пред-
ставляющие содержимое строки
таблицы.

Тег <template>


Синтаксис:

<template onenterforward="url" onenterbackward=
"url" ontimer="url"

content
</template>

Описание:


Определяет действия на уровне WML-страницы, кото-
рые применяются в отношении всех карт WML-
страницы. Приложение может переопределять данные
действия для некоторой определенной карты, указывая
те же самые события в соответствующем элементе
<card>.

Параметры:

onenterforward Определяет URL, который будет от-
крываться, если пользователь пере-
ходит на карту с помощью <до>
задания.


onenterbackward Определяет URL, который будет от-
крываться, если пользователь пере-
ходит на карту с помощью <prev>. задания.


ontimer Определяет URL, который будет от-
крываться, если истекает время, оп-
ределяемое элементом <timer>.


content Определяет действие, которое
должно выполняться при наступле-
нии события. Содержимое (content)
может включать элементы <do> и
<onevent>.

Тег <timer>


Синтаксис:

<timer name=" variable" value="value" />

Описание:

Элемент <timer> задает метод автоматического запуска
задания по истечении некоторого периода неактивно-
сти пользователя. Таймер запускается при переходе на
карту и останавливается, когда выполняется какое-либо
задание. Допускается определять только одно задание
на таймер и один таймер на одну карту.

Параметры:


name

Определяет имя переменной, ис-
пользуемой для хранения значения
таймера. При переходе пользовате-
ля с одной карты на другую, пере-
менная устанавливается равной те-
кущему значению таймера (которое
отсчитывается от его первоначаль-
ного значения в сторону убывания к
нулю) или нулю, если значение тай-
мера истекло.


value

Строка, определяющая начальное
значение таймера. Значение указы-
вается в десятых долях секунды. При
установке значения, равного нулю,
таймер отключается.

Тег<и>



Синтаксис:

<u>text</u>


Описание:

Отображает подчеркнутый текст.

Параметры:

text

Текст, который должен отображать-
ся подчеркнутым шрифтом.

В настоящее время браузер UP.Browser не поддерживает подчеркну-
тый текст.

Тег <wml>


Синтаксис:

<wml>
content
</wml>

Описание:

Определяет начало и конец WML-страницы.

Параметры:

Все элементы, которые определяют действия, выпол-
няемые WML-страницей.



Условный Оператор



Условный Оператор

Язык WMLScript поддерживает условный оператор, который включает в свой состав три операнда, как показано ниже:

Result = argl ? arg2 : агgЗ;

Если первый операнд (argl) имеет значение true, то данный оператор присваивает результату (Result) значение второго операнда (arg2). Если первый операнд (argl) имеет значение false или недопустимое значение, то оператор присваивает результату (Result) значение третьего операнда (аrgЗ).