Функции библиотеки 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"

Функция 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 = "INT" 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 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

Функция WMLScript trim()

Данная функция возвращает строку без ведущих и конечных пробелов.

Синтаксис:

n = String.trim(string)

Параметр Описание

n	Строка, возвращаемая функцией
string	Строка

Пример:

var x = String.trim(" Добро пожаловать в INTUIT! ");

Результат:

x = "Добро пожаловать в INTUIT!"

---

---