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


           

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

}



Содержание    Назад    Вперед