Текстовые

Примечание|Замечание:

• эти функции не модифицируют переданное в них текстовое значение. Вместо этого они возвращают измененную строку;
• позиция первого символа в строке равна 0. Это следует учитывать при передаче параметров в некоторые функции, например, Insert.

Asc

Функция	Параметры	Возвращаемое значение
Asc	char c	int

Возвращает целое значение, представляющее код символа c.

Пример:

Asc('A') = 65

Chr

Функция	Параметры	Возвращаемое значение
Chr	int i	char

Возвращает символ с кодом i.

Пример:

Chr(65) = 'A'

Insert

Функция	Параметры	Возвращаемое значение
Insert	string s, int startIndex, string value	string

Вставляет подстроку value в строку s, начиная с позиции startIndex, и возвращает новую строку.

Пример:

Insert("ABC", 1, "12") = "A12BC"

Length

Функция	Параметры	Возвращаемое значение
Length	string s	int

Возвращает длину строки s.

Пример:

Length("ABC") = 3

LowerCase

Функция	Параметры	Возвращаемое значение
LowerCase	string s	string

Переводит все символы строки s в нижний регистр и возвращает результат.

Пример:

LowerCase("ABC") = "abc"

PadLeft

Функция	Параметры	Возвращаемое значение
PadLeft	string s, int totalWidth	string
PadLeft	string s, int totalWidth, char paddingChar	string

Дополняет строку s пробелами или символами paddingChar слева, до длины, указанной в параметре totalWidth, и возвращает новую строку.

Примеры:

PadLeft("ABC", 5) = "  ABC"
PadLeft("ABC", 5, '0') = "00ABC"

PadRight

Функция	Параметры	Возвращаемое значение
PadRight	string s, int totalWidth	string
PadRight	string s, int totalWidth, char paddingChar	string

Дополняет строку s пробелами или символами paddingChar справа, до длины, указанной в параметре totalWidth, и возвращает новую строку.

Примеры:

PadRight("ABC", 5) = "ABC  "
PadRight("ABC", 5, '0') = "ABC00"

Remove

Функция	Параметры	Возвращаемое значение
Remove	string s, int startIndex	string
Remove	string s, int startIndex, int count	string

Удаляет все символы или указанное в count количество символов из строки s, начиная с позиции startIndex, и возвращает новую строку.

Примеры:

Remove("ABCD", 3) = "ABC"
Remove("A00BC", 1, 2) = "ABC"

Replace

Функция	Параметры	Возвращаемое значение
Replace	string s, string oldValue, string newValue	string

Заменяет в строке s все вхождения подстроки oldValue на подстроку newValue, и возвращает новую строку.

Пример:

Replace("A00", "00", "BC") = "ABC"

Substring

Функция	Параметры	Возвращаемое значение
Substring	string s, int startIndex	string
Substring	string s, int startIndex, int length	string

Возвращает все символы строки s или количество length символов, начиная с позиции startIndex.

Примеры:

Substring("ABCDEF", 4) = "EF"
Substring("ABCDEF", 1, 3) = "BCD"

TitleCase

Функция	Параметры	Возвращаемое значение
TitleCase	string s	string

Переводит символы строки s в "титульный" регистр. При этом первый символ каждого слова делается заглавным, остальные символы - строчными.

Пример:

TitleCase("john smith") = "John Smith"

Trim

Функция	Параметры	Возвращаемое значение
Trim	string s	string

Обрезает незначащие пробелы в начале и конце строки s.

Пример:

Trim("  ABC  ") = "ABC"

UpperCase

Функция	Параметры	Возвращаемое значение
UpperCase	string s	string

Переводит все символы строки s в верхний регистр и возвращает результат.

Пример:

UpperCase("abc") = "ABC"