Эта библиотека
содержит функции для манипулирования текстом.
Функции библиотеки String
Функция |
Описание |
charAt() |
Возвращает символ из указанной позиции |
compare() |
Сравнивает две строки и возвращает значение,
представляющее результат сравнения |
ElementAt() |
Разбивает
строку на элементы и возвращает указанный
элемент |
elements() |
Возвращает количество вхождений в строку
указанного значения |
find() |
Возвращает позицию подстроки в строке |
format() |
Форматирует значение |
insertAt() |
Разбивает
строку на элементы и вставляет подстроку в
указанной позиции индекса |
isEmpty() |
Проверяет,
не является ли строка пустой
|
length() |
Возвращает длину строки |
removeAt() |
Разбивает
строку на элементы и удаляет указанный
элемент |
replace() |
Заменяет
часть строки новой строкой |
replaceAt() |
Разбивает
строку на элементы и заменяет указанный
элемент |
squeeze() |
Заменяет
в строке все множественные пробелы на
одиночные пробелы |
subString() |
Возвращает указанную часть строки |
toString() |
Преобразует значение в строку |
trim() |
Возвращает строку без ведущих и конечных
пробелов |
Функция charAt()
Данная функция
возвращает символ из указанной индексной позиции.
Синтаксис:
n = String.charAt(string,
index)
Параметр |
Описание |
N |
Строка,
возвращаемая функцией |
String |
Строка |
Index |
Число,
определяющее индексную позицию в строке
|
Пример:
var t = String.charAt("world",3);
var x = String.charAt("world",1);
var y = String.charAt("world",0);
var z = String.charAt("world",15);
Результат:
t = "l"
x = "o"
y = "w"
z = ""
Функция compare()
Данная функция
сравнивает две строки и возвращает значение,
представляющее результат сравнения.
Значения могут быть
следующими:
-1 (если строка1 < строки2)
0 (если строка1 = строке2)
1 (если строка1 > строки2)
Синтаксис:
n = String.compare(string1,
string2)
Параметр |
Описание |
N |
Строка,
возвращаемая функцией |
string1 |
Строка |
string2 |
Строка
|
Пример:
var x =
String.compare("exam","example");
var y = String.compare("example","example");
var z = String.compare("example","exam");
Результат:
x = -1
y = 0
z = 1
Функция elementAt()
Данная функция
разбивает строку на элементы и возвращает элемент в
заданной позиции индекса.
Синтаксис:
n = String.elementAt(string,
index, separator)
Параметр |
Описание |
N |
Строка,
возвращаемая функцией |
String |
Анализируемая строка |
Index |
Целое
число, определяющее возвращаемую часть |
separator |
Разделитель элементов строки
|
Пример:
var r= String.elementAt("Добро
пожаловать в INTUIT",1," ");
var s= String.elementAt("Добро пожаловать в
INTUIT",3," ");
var t= String.elementAt("Добро пожаловать в
INTUIT",0," ");
var x= String.elementAt("Фрукты+Овощи",1,"+");
var y= String.elementAt("Овощи+Фрукты",0,"+");
var z= String.elementAt("Фрукты+Овощи",7,"+");
Примечание:
- если индекс окажется
отрицательным, то возвращается первый элемент;
- если индекс окажется
слишком большим, возвращается последний элемент.
Результат:
r = "пожаловать"
s = "INTUIT"
t = "Добро"
x = "Овощи"
y = "Овощи"
z= "Овощи"
Функция elements()
Данная функция
возвращает количество вхождений в строку указанного
значения.
Синтаксис:
n = String.elements(string,
separator)
Параметр |
Описание |
n |
Целое
число, равное количеству вхождений в строку
string
значения, которое задано параметром
separator |
string |
Строка, в
которой осуществляется поиск |
separator |
Строковое
значение, которое отыскивается в строке
string |
Пример:
var x = String.elements("Добро
пожаловать в INTUIT","а");
var y = String.elements("Добро пожаловать в
INTUIT","о");
var z = String.elements("Добро пожаловать в
INTUIT"," ");
Результат:
x = 2
y = 4
z = 3
Функция find()
Данная функция
возвращает позицию подстроки в строке.
Синтаксис:
n = String.find(string,
substring)
Параметр |
Описание |
n |
Целое
число, возвращаемое функцией |
String |
Строка, в
которой осуществляется поиск |
substring |
Значение,
которое отыскивается в строке
string |
Пример:
var x =
String.find("example","ex");
var y = String.find("example","pl");
var z = String.find("example","bo");
Результат:
x = 0
y = 4
z = 0
Функция format()
Данная функция
форматирует значение.
Синтаксис:
n = String.format(format,
value)
Параметр |
Описание |
n |
Строка,
возвращаемая функцией |
format |
Определяет способ форматирования значения.
format состоит
из трех частей.
- %width.precision
type width
- необязательное значение.
Определяет минимальное количество
выводимых символов.
- precision
- необязательное значение. Задает
точность выводимого значения. Может
принимать одно из следующих значений:
- d
(минимальное число цифр для вывода.
По умолчанию равно 1);
- f
(число со знаком после десятичной
точки. По умолчанию равно 6);
- s
(максимальное число цифр для вывода.
По умолчанию выводятся все символы).
- type -
Обязательное значение. Определяет, как
интерпретируется отформатированное
значение. Может принимать одно из
следующих значений:
- d
(целое число - выводимое число имеет
nd
позиций);
- f
(число с плавающей точкой -
выводимое число имеет
nf
десятичных позиций);
- s
(строка - символы выводятся в конце
строки или пока не будет достигнуто
значение точности)
|
value |
Форматируемое значение
|
Пример:
var x = String.format("%1.2f",
1.3);
var y = String.format("%2f", 5.675)
Результат:
x = "1.30"
y = "5.67"
Функция insertAt()
Данная функция
разбивает строку на элементы и вставляет подстроку в
указанной индексной позиции.
Синтаксис:
n = String.insertAt(string,
substring, index, separator)
Параметр |
Описание |
n |
Возвращаемая функцией строка |
string |
Исходная
строка |
substring |
Подстрока,
вставляемая в исходную строку
|
index |
Целое
число, определяющее позицию для вставки
подстроки |
separator |
Разделитель |
Пример:
var x = String.insertAt("Добро
пожаловать на INTUIT","сайт",3," ");
Результат:
x = "Добро пожаловать на сайт
INTUIT"
Функция WMLScript isEmpty()
Данная функция
возвращает true, если
строка пустая, в противном случае значение будет
false.
Синтаксис:
n = String.isEmpty(string)
Параметр |
Описание |
n |
Булево
значение, возвращаемое функцией |
string |
Строка
|
Пример:
var r = String.isEmpty("first");
var s = String.isEmpty("example");
var t = String.isEmpty("exam");
var x = String.isEmpty("");
Результат:
r = false
s = false
t = false
x = true
Функция length()
Данная функция
возвращает длину строки.
Синтаксис:
n = String.length(string)
Параметр |
Описание |
n |
Длина
строки |
string |
Строка
|
Пример:
var r = String.isEmpty("first");
var s = String.isEmpty("example");
var t = String.isEmpty("90");
var x = String.isEmpty("");
Результат:
r = 5
s = 7
t = 2
x = 0
Функция removeAt()
Данная функция
разбивает строку на элементы и удаляет указанный элемент.
Синтаксис:
n = String.removeAt(string,
index, separator)
Параметр |
Описание |
n |
Строка,
возвращаемая функцией |
string |
Исходная
строка |
index |
Индекс
удаляемого элемента |
separator
|
Разделитель |
Пример:
var a = String.removeAt("Сайт
INTUIT",7," ");
var b = String.removeAt("Сайт INTUIT ",-1," ");
var c = String.removeAt("Сайт INTUIT ",0,"I");
var d = String.removeAt("Сайт INTUIT ",0," ");
Результат:
a = "Сайт"
b = "INTUIT"
c = "NTUIT"
d = "INTUIT"
Функция replace()
Данная функция
заменяет часть строки новой строкой и возвращает
результат.
Синтаксис:
n = String.replace(string,
oldvalue, newvalue)
Параметр |
Описание |
n |
Строка,
возвращаемая функцией |
string |
Исходная
строка |
oldvalue |
Значение,
которое будет заменено |
newvalue |
Значение,
которое заменит
oldvalue |
Пример:
var x =
String.replace("победа","побе","звез");
var y = String.replace("собака", "ака","оль");
Результат:
x = "звезда"
y = "соболь"
Функция replaceAt()
Данная функция
разбивает строку на элементы и заменяет указанный
элемент.
Синтаксис:
n = String.replaceAt(string,
substring, index, separator)
Параметр |
Описание |
n |
Строка,
возвращаемая функцией |
string |
Исходная
строка |
substring |
Подстрока,
которая заменяет указанный элемент в
исходной строке |
index |
Целое
значение, которое определяет, где поместить
substring
|
separator
|
Разделитель |
Пример:
var x = String.replaceAt("Это
INTUIT","Сайт ",0," ");
var y = String.replaceAt("Курсы INTUIT","Образование
можно получить в",0," ");
Результат:
x = "Сайт INTUITL"
y = "Образование можно получить в INTUIT"
Функция squeeze()
Данная функция
заменяет в строке все множественные пробелы одиночными
пробелами.
Синтаксис:
n = String.squeeze(string)
Параметр |
Описание |
n |
Строка,
возвращаемая из функции |
string |
Строка
|
Пример:
var x = String.squeeze("Добро
пожаловать в INTUIT\r\n");
Результат:
x = "Добро пожаловать в INTUIT
"
Функция subString()
Данная функция
возвращает указанную часть строки.
Синтаксис:
n = String.subString(string,
start, length)
Параметр |
Описание |
n |
Новая
строка, возвращаемая функцией |
String |
Исходная
строка |
Start |
Начальная
позиция |
Length |
Длина
новой строки
|
Пример:
var r =
String.subString("INTUIT",1,3);
var s = String.subString("INTUIT",3,1);
var t = String.subString("INTUIT",0,3);
var x = String.subString("INTUIT",4,2);
var y = String.subString("INTUIT",8,9);
var z = String.subString("INTUIT",2,4);
Результат:
r = "NTU"
s = "U"
t = "INTU"
x = "IT"
y = ""
z = "TUIT"
Функция toString()
Данная функция
преобразует значение в строку.
Синтаксис:
n = String.toString(value)
Параметр |
Описание |
n |
Строка,
возвращаемая функцией |
value |
Любое
значение |
Пример:
var x = String.toString(120);
var y = String.toString(INTUIT);
Результат:
x = "120"
y = "INTUIT"
Функция WMLScript trim()
Данная функция
возвращает строку без ведущих и конечных пробелов.
Синтаксис:
n = String.trim(string)
Параметр |
Описание |
n |
Строка,
возвращаемая функцией |
string |
Строка |
Пример:
var x = String.trim("
Добро пожаловать в INTUIT! ");
Результат:
x = "Добро пожаловать в
INTUIT!"
|