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

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

Оператор

Операция

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

вычитание

умножение

деление

div

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

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

Оператор

Операция

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

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

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

>>>

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

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

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

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

Библиотека 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 предоставляет набор функций пользовательского интерфейса.

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 содержит набор функций для работы с числами в формате с
плавающей запятой. Наличие данных функций носит необязательный характер.
Если устройство не поддерживает операции над числами с плавающей запятой,
все функции данной библиотеки будут возвращать значение 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) ;

Библиотека 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 содержит набор функций для работы с символьными строками.
Строка представляет собой массив символов. Позиция каждого символа в строке
задается его индексом. Индекс первого символа в строке равен нулю. Строка может также рассматриваться как массив элементов, разделяемых с помощью разделительного символа. Позиция каждого элемента в строке задается его индексом. Индекс первого элемента в строке равен нулю.

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 описывается следующей синтаксической конструкцией:
<scheme>://<host>:<port>/<path>;<params>?<query>#<fragment>

escapeString

Функция: URL. escapeString (string);

Описание: Возвращает новую строку, получаемую из вход-
ной строки string путем замены всех спецсим-
волов на ESCAPE-последовательности в формате
%хх. Если входная строка содержит символы, не
являющиеся частью набора символов US-ASCII,
функция возвращает значение invalid.

ESCAPE-последовательности заменяются сле-
дующие символы:

Управляющие символы: (шестнадцатеричные

значения ОО-lf и 7f из
набора символов USASCII)

Знак пробела: (шестнадцатеричное

значение 20 из набора
символов US-ASCII)

Зарезервированные
символы: ;/?:@& = + $,

Несмысловые символы: () |\Л[]'

Разделители:

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

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

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

URL.escapeStringO для кодирования строки
"@&#":

extern function EscapeStringTest()

{
var Argument = "@&#";

var Result = URL.escapeString(Argument);

var ResultString = "URL.escapeStringO" + "\r\r"
"escapeString(@&#) = " + Result;

Dialogs. alert (ResultString) ;

getBase

Функция: URL. getBase ();

Описание: Возвращает абсолютный URL текущего

WMLScript-файла (без фрагмента).

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

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

extern function GetBaseTest()
{

var Result = URL.getBase();

var ResultString = "URL.getBase()" + "\r\r" +

"getBaseO = " + Result;

Dialogs.alert(ResultString);

}

getFragment

Функция: URL.getFragment (urlString);

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

URL-строке. При обнаружении некорректного
синтаксиса URL функция возвращает значение
invalid.

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

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

extern function GetFragmentTest()
{

var Result = URL.getFragment("");

var ResultString = "URL.getFragment()" + "\r\r" +
"The fragment is " + Result;

Dialogs.alert(ResultString);

}

getHost

Функция: URL.getHost(urlString);

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

входной URL-строке. Относительные URL не

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

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

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

URL.getHostO для извлечения имени хост-системы из URL

extern function GetHostTest()

{

var Result = URL.getHost("#abed");

var ResultString = "URL.getHost()" + "\r\r" +
"The host is " + Result;

Dialogs.alert(ResultString);

}

getParameters

Функция: URL. getParameters (urlString);

Описание: Возвращает параметры, заданные во входной

URL-строке. При обнаружении некорректного
синтаксиса URL функция возвращает значение
invalid.

Аргумент: ur IStr ing = Строка

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

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

URL.getParameters() для извлечения списка
параметров из URL

extern function GetParametersTest()
{

var Result = URL.getParameters(" ,-2;3");

var ResultString = "URL.getParameters()" + "\r\r" +
"The parameters are " + Result;

Dialogs.alert(ResultString);

}

getPath

Функция: URL.getPath(urlString);

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

строке. При обнаружении некорректного син-

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

invalid.

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

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

URL . getPath () для извлечения пути из URL

;

extern function GetPathTest()
{

var Result = URL.getPath("");
var ResultString = "URL.getPath()" + "\r\r" +

"The path is " + Result;

Dialogs.alert(ResultString);

{

getPort

Функция: URL.getPort(urlString);

Описание: Возвращает порт, указанный во входной URL-

строке. Если порт не указан, функция возвращает пустую строку. При обнаружении некоррект-
ного синтаксиса URL функция возвращает значение invalid.

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

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

URL. getPort () для извлечения номера порта из
URL ;2;3:

extern function GetPortTest()

var Result = URL.getPort("");

var ResultString = "URL.getPort()" + "\r\r" +

"The port is " + Result;

Dialogs.alert(ResultString);

getQuery

Функция: URL.getQuery(urlString);

Описание: Возвращает запрос, указанный во входной URL-
строке. Если запрос не указан, функция возвра-
щает пустую строку. При обнаружении некорректного синтаксиса URL функция возвращает
значение invalid.

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

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

URL.getQuery() для извлечения строки запроса
из URL &b=2:

extern function GetQueryTest()
{

var Result =
URL.getQuery("&b=2");

var ResultString = "URL.getQuery()" + "\r\r" +

"The query is " + Result; :

Dialogs.alert(ResultString);

)

getReferer

Функция: tJRL.getReferer();

Описание: Возвращает URL ресурса, который вызвал текущий WMLScript-сценарий.

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

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

URL. getReferer () для получения имени WML-
файла, вызвавшего сценарий:

extern function GetRefererTest()
{

var Result = URL.getReferer();

var ResultString = "URL.getReferer()" + "\r\r" +
"URL.getReferer = " + Result;

Dialogs.alert(ResultString);

{

getScheme

Функция: URL. getScheme (urlString);

Описание: Возвращает название протокола передачи данных, заданного во входной URL-строке. При об-
наружении некорректного синтаксиса URL
функция возвращает значение invalid.

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

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

протокола передачи данных, используемого в
- URL 1;2;3:

extern function GetSchemeTest()

{

var Result = URL.getScheme("");

var ResultString = "URL. getScheme ()" + "\r\r" +

"The scheme is " + Result;

Dialogs. alert (ResultString) ;
{

isValid

Функция: URL. isValid (urlString);

Описание: Возвращает логическое значение true, если
синтаксис входной URL-строки корректен и
false, если синтаксис не корректен.

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

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

URL. isValid(), чтобы установить являются ли
строки "waplib.com" и "" корректными URL-
строками:

extern function IsValidTest ()

var Argumentl = "waplib.com"; ,
var Resultl = URL.isValid(Argumentl);

var Argument2 = "";
var Result2 = URL.isValid(Arguments);

var ResultString = "URL.isValid()" + "\r\r" +

"isValid(waplib.com) = " + Resultl + "\r" +
"isValid() = " + Result2;

Dialogs.alert(ResultString);

resolve

Функция: URL.resolve(baseURL, embeddedURL);

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

указываемого базового URL и вложенного URL.

При обнаружении некорректного синтаксиса
URL функция возвращает значение invalid.

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

embeddedURL = Строка

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

Пример: Следующий сценарий использует функцию
URL.resolve{) для объединения двух аргументов в абсолютный URL:

extern function ResolveTest()

{

var Argumentl = "";
var Arguments = "Demos.wml";

var Result = URL.resolve(Argumentl, Arguments);

var ResultString = "URL.resolve()" + "\r\r" +

"The absolute URL is " + Result;

Dialogs.alert(ResultString);

}

unescapeString

Функция: URL.unescapeString(string);

Описание: Возвращает новую строку, получаемую из входной строки string путем замены всех ESCAPE-
последовательностей (таких, как те, что получаются с помощью функции URL.escapeString)
на символы, представляемые этими ESCAPE-

последовательностями. Если строка содержит

символы, которые не входят в набор знаков US-
ASCII, функция возвращает значение invalid.

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

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

URL.unescapeStringO для декодирования

строки "%40%26%23":

extern function UnescapeStringTest()

{

var Argument = "%40%26%23";

var Result = URL.unescapeString(Argument);

var ResultString = "URL.unescapeStringO" + "\r\r" +

"unescapeString(%40%26%23) = " + Result;

Dialogs.alert(ResultString);

}

Библиотека 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);

Функция: 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) ;
)

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

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

Оператор

Операция

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

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

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

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

значению второго операнда.

Оператор Isvalid

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

Оператор Typeof

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

Тип

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

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

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

String (строка)

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

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

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

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

Оператор

Операция

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

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

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

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

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

div=

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

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

«=

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

»=

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

>»=

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

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

/\=

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

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

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

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

Оператор

Операция

меньше

<- .,>

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

равно

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

больше

! =

не равно

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

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

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

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

Условный Оператор

Язык WMLScript поддерживает условный оператор, который включает в свой состав три операнда, как показано ниже:

Result = argl ? arg2 : агgЗ;

Если первый операнд (argl) имеет значение true, то данный оператор присваивает результату (Result) значение второго операнда (arg2). Если первый операнд (argl) имеет значение false или недопустимое значение, то оператор присваивает результату (Result) значение третьего операнда (аrgЗ).