Строки

Здесь описаны операторы и функции для работы со строками (тип str).

• bool( str s ) bool

• float( str s ) float

• int( str s ) int

• Find( str s, str substr ) int

• Format( str s, anytype args... ) str

• HasPrefix( str s, str prefix ) bool

• HasSuffix( str s, str suffix ) bool

• Left( str s, int i ) string

• Lines( str s ) arr.str

• Lower( str s ) string

• Repeat( str s, int count ) str

• Replace( str s, str old, str new ) str

• Right( str s, int i ) string

• Size( int size, str format ) string

• Split( str s, str sep ) arr.str

• Substr( str s, int off, int length ) str

• Trim( str s, str cutset ) str

• TrimLeft( str s, str cutset ) str

• TrimRight( str s, str cutset ) str

• TrimSpace( str s ) str

• Upper( str s ) string

Операторы

Оператор	Результат	Описание
str + str	str	Слияние двух строк.
* str	int	Получить длину строки.
str ?	bool	Вызов bool(str).
| str	str	Этот унарный оператор удаляет пробельные символы в начале, в конце строки и рядом с символами перевода строки.
str == str	bool	Возвращает true если две строки равны и false, в противном случае.
str > str	bool	Возвращает true если первая строка больше второй и false, в противном случае.
str < str	bool	Возвращает true если первая строка меньше второй и false, в противном случае.
str != str	bool	Возвращает true если две строки не равны и false, в противном случае.
str >= str	bool	Возвращает true если первая строка больше или равна второй и false, в противном случае.
str <= str	bool	Возвращает true если первая строка меньше или равна второй и false, в противном случае.
str = str	str	Присваивание строки.
str = int	str	Конвертирует целое число в строку и присваивает её переменной.
str = bool	str	Присваивает переменной "true" или "false".
str += str	str	Добавляет к строковой переменной строку.
str [ int ]	int	Установить/получить уникодный символ по индексу.

Функции

bool(str s) bool

Функция bool возвращает false, если строка пустая, равна "0" или "false", в противном случае, возвращается true.

float(str s) float

Функция float преобразует строку в число типа float. Если строка имеет неверный формат, то возвращается ошибка.

int(str s) int

Функция int преобразует строку в число типа int. Если строка имеет неверный формат, то возвращается ошибка.

Find(str s, str substr) int

Функция Find возвращает смещение первого вхождения подстроки substr в строке s, или -1, если substr отсутствует в строке s.

Format(str s, anytype args...) str

Функция Format форматирует строку в соответствии со спецификатором s и возвращает результирующую строку. Имеются следующие управляющие команды:

Общие

• %v - значение в формате по умолчанию

• %% - знак процента

bool

• %t - слово true или false

int

• %b - по основанию 2

• %c - соответствующий символ Unicode

• %d - по основанию 10. Это формат по умолчанию для int.

• %o - по основанию 8

• %x - по основанию 16, с нижним регистром a-f

• %X - по основанию 16, с верхним регистром A-F

• %U - формат Unicode: U+1234

float

• %e - научная запись, например -1.234456e+78

• %E - научная запись, например -1.234456E+78

• %f - десятичная точка без экспоненты, например 123.456. Вы можете указать общую ширину и мантиссу %[width].[precision]f - %8.2f, %.3f, %7f.

• %g - %e для большой экспоненты, и %f в противном случае. Это формат по умолчанию для float.

str

• %s - формат по умолчанию для строк.

• %x - по основанию 16 в нижнем регистре, два символа на 1 байт.

• %X - по основанию 16 в верхнем регистре, два символа на 1 байт.

Вы можете указать i-ый аргумент в форматируемой строке подобно этому - Format("%d %[1]d %[1]d", 10)

arr.int mya = {1,2,3}
time t
Format(`%s %v %v %g %6.2[4]f`, `ok`, mya, Now(t), 99.0 + 1.)

HasPrefix(str s, str prefix) bool

Функция HasPrefix возвращает true, если строка s начинается со строки prefix.

HasSuffix(str s, str suffix) bool

Функция HasSuffix возвращает true, если строка s заканчивается строкой suffix.

Left(str s, int i) str

Функция Left возвращает подстроку из первых i символов строки s.

Lines(str s) arr.str

Функция Lines разбивает строку s на подстроки по символам перевода строки. Все подстроки добавляются в возвращаемый массив строк.

Lower(str s) str

Функция Lower приводит копию строки s к нижнему регистру и возвращает её.

Repeat(str s, int count) str

Функция Repeat возвращает новую строку состоящую из count повторений строки s.

Replace(str s, str old, str new) str

Функция Replace возвращает копию строки s со всеми подстроками old замененными на строку new.

Right(str s, int i) str

Функция Right возвращает подстроку из последних i символов строки s.

Size(int size, str format) str

Функция Size возвращает округленный размер в виде строки. В параметре format укажите шаблон вывода для десятичного числа с плавающей точкой и строки. Если format равен пустой строке, то используется формат %.2f%s.

Print( Size(956348901, `%.1f %s `) + Size(62, `%[2]s%.2[1]f `) + Size(123789, ``))
// 912.0 MB B62 120.89KB

Split(str s, str sep) arr.str

Функция Split разбивает строку s на подстроки разделенные строкой sep. Все подстроки добавляются в возвращаемый массив строк.

Substr(str s, int off, int length) str

Функция Substr возвращает подстроку s с указанным смещением и длиной.

Trim(str s, str cutset) str

Функция Trim возвращает подстроку строки s с удалёнными начальными и конечными символами, которые содержатся в строке cutset.

TrimLeft(str s, str cutset) str

Функция TrimLeft возвращает подстроку строки s с удалёнными начальными символами, которые содержатся в строке cutset.

TrimRight(str s, str cutset) str

Функция TrimRight возвращает подстроку строки s с удалёнными конечными символами, которые содержатся в строке cutset.

TrimSpace(str s) str

Функция TrimSpace возвращает подстроку строки s с удалёнными начальными и конечными пробельными символами.

Upper(str s) str

Функция Upper приводит копию строки s к верхнему регистру и возвращает её.