Функции для работы со строками

Глобальные функции

allt(<строка>)

Возвращает строку, убирая пробелы слева и справа.
Пример:
allt(' 3455 ') вернет значение '3455'

cleanSpace(<строка>)

Убирает пробелы слева и справа, количество пробелов между символами в строке сокращает до одного.
Пример:
cleanSpace (' 3   45  51 ') вернет '3 45 51'

chrtran(<строка>, <подстрока1>, <подстрока2>)

Функция производит замену символов в <строке> в соответствии с переданными <подстрокой 1>, <подстрокой 2>.
Пример:
chrtran("1234","321","ab") возвращает "ba4" ("3"->"a","2"->"b","1"->"","4" ни на что не меняется)

corectDbfTxt(<строка>)

Заменяет в тексте украинскую "i" на латинскую.
Пример:
corectDbfTxt('іndex') заменит украинскую букву "і" латинской

cutspace(<строка>)

Замена всех непрерывных последовательностей пробелов в один (аналог функции cleanSpace).
Пример:
cutspace(' 3   45  51 ') вернет '3 45 51'

equals(<строка1>>, <строка2>)

Сравнивает две строки с учетом регистра.
Пример:
equals('ааа', 'ааа') возвращает "true"
equals('Ааа', 'ааа') возвращает "false"

equalsIgnoreCase(<строка1>, <строка2>)

Сравнивает две строки без учета регистра.
Пример:
equalsIgnoreCase('Ааа', 'ааа') возвращает "true"

initials(<фамилия имя отчество>)

Получить по полному ФИО фамилию и инициалы.
Пример:
initials("Кукушкин Кирилл Ульянович") возвращает "Кукушкин К.У." Требует подключение servis/initials.js

left(<строка1>, <количество символов>)

Позволяет получить в строке подстроку с заданным количеством символов (отсчет слева).
Пример:
left('1234', 3) возвращает значение 123

ltrim(<строка>)

Возвращает строку, убирая пробелы слева.
Пример:
ltrim(' 3455 ') вернет значение '3455 '

nvl(<выражение>,<значение>)

возвращает <значение2>, если вычисление <выражения> дает значение null.
Пример:
nvl('345','-') вернет значение 345
nvl('','-') вернет значение '-'

replace(<строка>,<подстрока1>,<подстрока2>)

Ищет совпадение между строкой и подстрокой 1, а после этого замещает совпавшую подстроку подстрокой 2.
Пример:
replace('12 мая','12','25') вернет '25 мая'

replicate(<символ>,<количество символов>)

Повторяет данную строку указанное количество раз.
Пример:
replicate('0', 4) вернет "0000"

right(<строка1>, <количество символов>)

Позволяет получить в строке подстроку с заданным количеством символов (отсчет справа).
Пример:
right('1234', 3) возвращает значение 234

rtrim(<строка>)

Возвращает строку, убирая пробелы справа.
Пример:
rtrim(' 3455 ') вернет значение ' 345 5'

strcmp(<строка1>,<строка2>)

Сравнение строк без учета пробелов (используется в накладных). Если <строка1>=<строка1> вернет 0; <строка1> > <строка2> вернет 1; <строка1> < <строка2> вернет -1.
Пример:
strcmp('45','46') возвращает значение "-1"

strlen(<строка>)

Считает количество символов в строке.
Пример:
strlen('петренко') возвращает значение 8

strtok(<строка>,<конечный символ>)

Возвращает подстроку заданной длины. Конец подстроки задается конкретным символом.
Пример:
strtok('189-97','-') вернет значение 189

substr(<строка><№ начального символа>,<количество символов>)

Позволяет получить заданную подстроку в строке.
Пример:
substr('2013547648',2,3) вернет значение 135 (первый символ имеет индекс 0)
Доступиться к символам строки можно как к элементам массива
Пример:
('3456',[3]) вернет значение 6 (первый символ имеет индекс 0)

upper(<строка>)

Привести строку к верхнему регистру.
Пример:
upper("Иванов") возвращает "ИВАНОВ"

val(<строка>)

Возвращает числовое значение по строковому значению, содержащему число.
Пример:
val('185.6 a') вернет значение 185.6

Функции объекта "String" (Строка)

charAt(<индекс>)

Возвращает символ строки по заданному индексу. Индекс первого символа равен 0, индекс последнего символа строки с названием StringName равен StringName.length - 1. Если индекс не входит в диапазон, то вернется пустая строка.
Пример:
var str = "document"
str.charAt(3) вернет символ "u"

charCodeAt(<индекс>)

Возвращает Unicode-значение символа, который задан с помощью специального индекса.
Пример:
var str = "document"
str.charCodeAt(3) вернет символ 117 ( Unicode-значение символа "u")

cleanSpace()

Убирает пробелы слева и справа, количество пробелов между символами в строке сокращает до одного.
Пример:
var str = "  do   cume   nt "
str.cleanSpace() вернет "do cume nt"

concat(<строка1>,<строка2>,...)

Объединяет строки и возвращает новую строку. Строка(строки), указанные в качестве параметров, добавляются в конец текущего строкового объекта.
Пример:
var str = "document"
str.concat("1","2") вернет строку "document12"

endsWith(<строка>)

Проверяет, заканчивается или нет строка определенной последовательностью символов.
Пример:
var str = "privet"
str.endsWith("et") вернет "true"
str.endsWith("d") вернет "false"

equals(<строка>)

Сравнивает строки с учетом регистра.
Пример:
var str = "privet"
str.equals("Privet") вернет "false"

equalsIgnoreCase(<строка>)

Сравнивает строки без учета регистра.
Пример:
var str = "privet"
str.equals("Privet") вернет "true"

String.fromCharCode(<значение1>,<значение2>....)

Возвращает строку, созданную с использованием специфицированной последовательности Unicode-значений.
Пример:
String.fromCharCode(65,66,67) вернет строку "ABC"

indexOf(<строка>,<индекс>)

Проверка вхождения одной строки в другую. Возвращает индекс первого появления заданной подстроки (-1, если значение не найдено). Вторым параметром (<Индекс>) можно указать место, с которого будет начинаться поиск (целое число от 0 до длины строки, по умолчанию имеет значение 0).
Пример:
var str = "Петренко Петр"
str.indexOf("ет") вернет 1
str.indexOf("ет",5) вернет 10
str.indexOf("345",5) вернет -1
str.indexOf("Ет") вернет -1 (учитывается регистр)

lastIndexOf(<строка>,<индекс>)

Проверка вхождения одной строки в другую. Возвращает индекс последнего появления заданной подстроки (-1, если значение не найдено). Вторым параметром (<Индекс>) можно указать место, до которого будет осуществляеться поиск (целое число от 0 до длины строки, по умолчанию имеет значение 0).
Пример:
var str = "Петренко Петр"
str.lastIndexOf("е")
вернет 10
str.lastIndexOf("t")
вернет -1
str.lastIndexOf("e",7)
вернет 4
str.lastIndexOf("E",7) вернет -1 (учитывает регистр)

left(<количество символов>)

Возвращает строку с указанным количеством символов (отсчет с левого края строки).
Пример:
var str = "Vsem privet"
str.left(6) вернет "Vsem p"

leftTrim()

Убирает пробелы слева.
Пример:
var str = "    Vsem privet"
str.left(6) вернет "Vsem privet"

length

Свойсво объекта String - длина.
Пример:
var str = "privet"
str.length вернет 6

match(<регулярное выражение>)

Разбивает строку на массив строк в соответствии с заданным регулярным выражением.
Пример:
var str="проспект Освободителей"
str.match(/ос/) вернет "ос"
str.match(/ос/gi) вернет "ос","Ос"(i - без учета регистра, g - все строки)

replace(<регулярное выражение>,<строка>)

Ищет совпадение между подстрокой (регулярным выражением) и строкой и после этого замещает совпавшую подстроку новой подстрокой.
Пример:
var str = "May 23"
str.replace(23,"31") вернет "May 31"

right(<количество символов>)

Возвращает строку с указанным количеством символов (отсчет с правого края строки).
Пример:
var str = "debet-kredit"
str.right(6) вернет "kredit"

rightTrim()

Убирает пробелы слева.
Пример:
var str = "debet-kredit   "
str.right() вернет "debet-kredit"

split(<символ>)

Разбивает строку по заданному символу на массив строк.
Пример:
var str = "debet-kredit   "
str.split("-") вернет "debet","kredit"

startsWith(<строка>)

Проверяет, начинается ли строка определенной последовательностью символов.
Пример:
var str = "privet"
str.startsWith("pr") вернет "true"
str.startsWith("pre") вернет "false"

split(<символ>)

Разбивает строку по заданному символу на массив строк.
Пример:
var str = "debet-kredit   "
str.split("-") вернет "debet","kredit"

substr(<№ начального символа>,<количество символов>)

Возвращает заданное количество символов строки, начиная отсчет с указанного символа.
Пример:
var str = "10042010"
str.substr(2,5) вернет "04201"

substring(<начальный индекс>,<конечный индекс>)

Возвращает заданное количество символов строки, начиная отсчет от начального индекса и до конечного (не включительно).
Пример:
var str = "document"
str.substr(0,5) вернет "docum"

toLowerCase()

Приводит строку к нижнему регистру.
Пример:
var str = "Петренко С.Г."
str.toLowerCase() вернет "петренко с.г."

toUpperCase()

Приводит строку к верхнему регистру.
Пример:
var str = "Петренко С.Г."
str.toUpperCase() вернет "ПЕТРЕНКО С.Г."


Смотри также:

Формы печати

Функции для получения информации из базы данных