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

       

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


Содержание раздела