Применение библиотеки string

Основные функции

Функция	Описание	Пример	Результат
len	Вычисляет длину строки	string.len("abcd")	4
rep	Возвращает n копий строки s	string.rep("abcd",2)	abcdabcd
lower	Переводит все буквы строки в нижний регистр	string.lower("AbcD")	abcd
upper	Переводит все буквы строки в верхний регистр	string.upper("AbcD")	ABCD
format	Форматирует строку	string.format("the value is:%d",4)	the value is:4
sub	Извлекает подстроку	string.sub("abcd",2)	bcd
		string.sub("abcd",-2)	cd
		string.sub("abcd",2,-2)	bc
		string.sub("abcd",2,3)	bc
find	Ищет в строке (возвращает позиции)	string.find("cdcdcdcd","ab")	nil
		string.find("cdcdcdcd","cd")	1 2
		string.find("cdcdcdcd","cd",7)	7 8
match	Ищет в строке (возвращает содержимое)	string.match("cdcdcdcd","ab")	nil
		string.match("cdcdcdcd","cd")	cd
gsub	Заменяет вхождения в строке	string.gsub("abcdabcd","a","z")	zbcdzbcd 2
		string.gsub("aaaa","a","z",3)	zzza 3
byte	Возвращает целочисленное представление символа	string.byte("ABCD",4)	68
char	Преобразует целые числа в символы и объединяет их	string.char(97,98,99,100)	abcd

Основные шаблоны

Класс символов	Описание	Пример	Результат
.	Любой символ	string.find("",".")	nil
%s	Пробельный символ	string.find("ab cd","%s%s")	3 4
%S	Непробельный символ	string.find("ab cd","%S%S")	1 2
%p	Знак пунктуации	string.find("ab,.cd","%p%p")	3 4
%P	Символ, не являющийся пунктуацией	string.find("ab,.cd","%P%P")	1 2
%c	Управляющий символ	string.find("abcd\t\n","%c%c")	5 6
%C	Символ, не являющийся управляющим	string.find("\t\nabcd","%C%C")	3 4
%d	Цифра	string.find("abcd12","%d%d")	5 6
%D	Нецифровой символ	string.find("12abcd","%D%D")	3 4
%x	Шестнадцатеричная цифра	string.find("efgh","%x%x")	1 2
%X	Символ, не являющийся шестнадцатеричной цифрой	string.find("efgh","%X%X")	3 4
%a	Буква	string.find("AB12","%a%a")	1 2
%A	Символ, не являющийся буквой	string.find("AB12","%A%A")	3 4
%l	Строчная буква	string.find("ABab","%l%l")	3 4
%L	Прописная буква	string.find("ABab","%L%L")	1 2
%u	Прописная буква	string.find("ABab","%u%u")	1 2
%U	Не прописная буква	string.find("ABab","%U%U")	3 4
%w	Буква или цифра	string.find("a1()","%w%w")	1 2
%W	Символ, не являющийся буквой или цифрой	string.find("a1()","%W%W")	3 4

Экранирующий символ %

Класс символов	Описание	Пример	Результат
%	Экранирующий символ	string.find("abc%..","%%")	4 4
		string.find("abc..d","%.%.")	4 5

Создание набора символов с помощью []: «-» — диапазон, «^» — дополнение набора

Класс символов	Описание	Пример	Результат
[01]	Сопоставляет двоичные числа	string.find("32123","[01]")	3 3
[AB][CD]	Сопоставляет AC, AD, BC и BD	string.find("ABCDEF","[AB][CD]")	2 3
[[]]	Сопоставляет пару квадратных скобок []	string.find("ABC[]D","[[]]")	4 5
[1-3]	Сопоставляет цифры от 1 до 3	string.find("312","[1-3][1-3][1-3]")	1 3
[b-d]	Сопоставляет буквы от b до d	string.find("dbc","[b-d][b-d][b-d]")	1 3
[^%s]	Сопоставляет любой непробельный символ	string.find(" a ","[^%s]")	3 3
[^%d]	Сопоставляет любой нецифровой символ	string.find("123a","[^%d]")	4 4
[^%a]	Сопоставляет любой символ, не являющийся буквой	string.find("abc1","[^%a]")	4 4

Захват с помощью «()»

Класс символов	Описание	Пример	Результат
()	Захватывает строку	string.find("12ab","(%a%a)")	3 4 ab
		string.find("ab12","(%d%d)")	3 4 12

Модификаторы шаблонов

Модификатор	Описание	Пример	Результат
+	Один или более символов, максимально возможное совпадение	string.find("aaabbb","(a+b)")	1 4 aaab
		string.find("cccbbb","(a+b)")	nil
-	Ноль или более символов, минимально возможное совпадение	string.find("zzxyyy","(xy-)")	3 3 x
		string.find("zzzyyy","(x-y)")	4 4 y
*	Ноль или более символов, максимально возможное совпадение	string.find("mmmnnn","(m*n)")	1 4 mmmn
		string.find("lllnnn","(m*n)")	4 4 n
?	Ноль или один символ	string.find("aaabbb","(a?b)")	3 4 ab
		string.find("cccbbb","(a?b)")	4 4 b

Распространённые способы использования match

Описание	Пример	Результат
Сопоставление китайских символов	string.match("男女abc123","([^%w%p]+)")	男女
Сопоставление латинских букв	string.match("男女abc123","(%a+)")	abc
Сопоставление цифр	string.match("男女abc123","(%d+)")	123
Сопоставление латинских букв и цифр	string.match("男女abc123","(%w+)")	abc123