Модуль string
Модуль string
включает в себя всё из стандартной библиотеки для работы со строками в Lua, а также некоторые расширения специально для Tarantool.
В данном разделе мы рассматриваем только дополнительные функции, добавленные разработчиками Tarantool.
Ниже приведен перечень всех функций библиотеки string
.
Имя | Назначение |
---|---|
string.ljust() | Выравнивание строки по левому полю |
string.rjust() | Выравнивание строки по правому полю |
string.hex() | Given a string, return hexadecimal values |
string.fromhex() | Given hexadecimal values, return a string |
string.startswith() | Проверка, начинается ли строка с заданной подстроки |
string.endswith() | Проверка, заканчивается ли строка на заданную подстроку |
string.lstrip() | Remove characters from the left of a string |
string.rstrip() | Remove characters from the right of a string |
string.split() | Разделение строки на таблицу со строками |
string.strip() | Удаление пробелов слева и справа от строки |
-
string.
ljust
(input-string, width[, pad-character])¶ Возврат строки, выровненной по левому краю, шириной, указанной в
width
.Параметры: Возвращается: выровненная по левому краю строка (не изменяется, если ширина <= длине строки)
Тип возвращаемого значения: строка
Пример:
tarantool> string = require('string') --- ... tarantool> string.ljust(' A', 5) --- - ' A ' ...
-
string.
rjust
(input-string, width[, pad-character])¶ Возврат строки, выровненной по правому краю, шириной, указанной в
width
.Параметры: Возвращается: выровненная по правому краю строка (не изменяется, если ширина <= длине строки)
Тип возвращаемого значения: строка
Пример:
tarantool> string = require('string') --- ... tarantool> string.rjust('', 5, 'X') --- - 'XXXXX' ...
-
string.
hex
(input-string)¶ Возврат шестнадцатеричного значения введенной строки.
Параметры: - input-string (
string
) – обрабатываемая строка
Возвращается: шестнадцатеричное число, два символа шестнадцатеричных цифр для каждого введенного символа
Тип возвращаемого значения: строка
Пример:
tarantool> string = require('string') --- ... tarantool> string.hex('ABC ') --- - '41424320' ...
- input-string (
-
string.
fromhex
(hexadecimal-input-string)¶ Given a string containing pairs of hexadecimal digits, return a string with one byte for each pair. This is the reverse of
string.hex()
. The hexadecimal-input-string must contain an even number of hexadecimal digits.Параметры: - hexadecimal-input-string (
string
) – string with pairs of hexadecimal digits
Возвращается: string with one byte for each pair of hexadecimal digits
Тип возвращаемого значения: строка
Пример:
tarantool> string = require('string') --- ... tarantool> string.fromhex('41424320') --- - 'ABC ' ...
- hexadecimal-input-string (
-
string.
startswith
(input-string, start-string[, start-pos[, end-pos]])¶ Возврат true (правда), если
input-string
начинается соstart-string
, в противном случае, возврат false (ложь).Параметры: Возвращается: true (правда) или false (ложь)
Тип возвращаемого значения: boolean (логический)
Значения
start-pos
иend-pos
могут быть отрицательными, что означает, что положение вычисляется с конца строки.Пример:
tarantool> string = require('string') --- ... tarantool> string.startswith(' A', 'A', 2, 5) --- - true ...
-
string.
endswith
(input-string, end-string[, start-pos[, end-pos]])¶ Возврат true (правда), если
input-string
заканчивается наend-string
, в противном случае, возврат false (ложь).Параметры: Возвращается: true (правда) или false (ложь)
Тип возвращаемого значения: boolean (логический)
Значения
start-pos
иend-pos
могут быть отрицательными, что означает, что положение вычисляется с конца строки.Пример:
tarantool> string = require('string') --- ... tarantool> string.endswith('Baa', 'aa') --- - true ...
-
string.
lstrip
(input-string[, list-of-characters])¶ Return the value of the input string, after removing characters on the left. The optional
list-of-characters
parameter is a set not a sequence, sostring.lstrip(...,'ABC')
does not mean strip'ABC'
, it means strip'A'
or'B'
or'C'
.Параметры: Возвращается: result after stripping characters from input string
Тип возвращаемого значения: строка
Пример:
tarantool> string = require('string') --- ... tarantool> string.lstrip(' ABC ') --- - 'ABC ' ...
-
string.
rstrip
(input-string[, list-of-characters])¶ Return the value of the input string, after removing characters on the right. The optional
list-of-characters
parameter is a set not a sequence, sostring.rstrip(...,'ABC')
does not mean strip'ABC'
, it means strip'A'
or'B'
or'C'
.Параметры: Возвращается: result after stripping characters from input string
Тип возвращаемого значения: строка
Пример:
tarantool> string = require('string') --- ... tarantool> string.rstrip(' ABC ') --- - ' ABC' ...
-
string.
split
(input-string[, split-string[, max]])¶ Разделение
input-string
на одну или более выводимых строк в таблице. Места разделения указаны вsplit-string
.Параметры: Возвращается: таблица строк, которые были разделены из
input-string
Тип возвращаемого значения: таблица
Пример:
tarantool> string = require('string') --- ... tarantool> string.split("A:B:C:D:F", ":", 2) --- - - A - B - C:D:F ...
-
string.
strip
(input-string[, list-of-characters])¶ Return the value of the input string, after removing characters on the left and the right. The optional
list-of-characters
parameter is a set not a sequence, sostring.strip(...,'ABC')
does not mean strip'ABC'
, it means strip'A'
or'B'
or'C'
.Параметры: Возвращается: result after stripping characters from input string
Тип возвращаемого значения: строка
Пример:
tarantool> string = require('string') --- ... tarantool> string.strip(' ABC ') --- - ABC ...