Aplicações da biblioteca string

Funções básicas

Função	Descrição	Exemplo	Resultado
len	calcula o comprimento da string	string.len("abcd")	4
rep	retorna n cópias da string s	string.rep("abcd",2)	abcdabcd
lower	converte todas as letras da string para minúsculas	string.lower("AbcD")	abcd
upper	converte todas as letras da string para maiúsculas	string.upper("AbcD")	ABCD
format	formata uma string	string.format("the value is:%d",4)	the value is:4
sub	extrai uma substring	string.sub("abcd",2)	bcd
		string.sub("abcd",-2)	cd
		string.sub("abcd",2,-2)	bc
		string.sub("abcd",2,3)	bc
find	localiza na string (exibe a posição)	string.find("cdcdcdcd","ab")	nil
		string.find("cdcdcdcd","cd")	1 2
		string.find("cdcdcdcd","cd",7)	7 8
match	localiza na string (exibe o conteúdo)	string.match("cdcdcdcd","ab")	nil
		string.match("cdcdcdcd","cd")	cd
gsub	substitui na string	string.gsub("abcdabcd","a","z")	zbcdzbcd 2
		string.gsub("aaaa","a","z",3)	zzza 3
byte	retorna a forma inteira do caractere	string.byte("ABCD",4)	68
char	converte números inteiros em caracteres e os concatena	string.char(97,98,99,100)	abcd

Padrões básicos

Classe de caractere	Descrição	Exemplo	Resultado
.	qualquer caractere	string.find("",".")	nil
%s	espaço em branco	string.find("ab cd","%s%s")	3 4
%S	não espaço em branco	string.find("ab cd","%S%S")	1 2
%p	pontuação	string.find("ab,.cd","%p%p")	3 4
%P	não pontuação	string.find("ab,.cd","%P%P")	1 2
%c	caractere de controle	string.find("abcd\t\n","%c%c")	5 6
%C	não caractere de controle	string.find("\t\nabcd","%C%C")	3 4
%d	número	string.find("abcd12","%d%d")	5 6
%D	não número	string.find("12abcd","%D%D")	3 4
%x	número hexadecimal	string.find("efgh","%x%x")	1 2
%X	não número hexadecimal	string.find("efgh","%X%X")	3 4
%a	letra	string.find("AB12","%a%a")	1 2
%A	não letra	string.find("AB12","%A%A")	3 4
%l	letra minúscula	string.find("ABab","%l%l")	3 4
%L	letra maiúscula	string.find("ABab","%L%L")	1 2
%u	letra maiúscula	string.find("ABab","%u%u")	1 2
%U	não letra maiúscula	string.find("ABab","%U%U")	3 4
%w	letra ou número	string.find("a1()","%w%w")	1 2
%W	não letra nem número	string.find("a1()","%W%W")	3 4

Caractere de escape %

Classe de caractere	Descrição	Exemplo	Resultado
%	caractere de escape	string.find("abc%..","%%")	4 4
		string.find("abc..d","%.%.")	4 5

Criar conjuntos de caracteres com []; "-" é o hífen e "^" representa o complemento do conjunto

Classe de caractere	Descrição	Exemplo	Resultado
[01]	corresponde a números binários	string.find("32123","[01]")	3 3
[AB][CD]	corresponde a AC, AD, BC e BD	string.find("ABCDEF","[AB][CD]")	2 3
[[]]	corresponde a um par de colchetes []	string.find("ABC[]D","[[]]")	4 5
[1-3]	corresponde aos números de 1 a 3	string.find("312","[1-3][1-3][1-3]")	1 3
[b-d]	corresponde às letras de b a d	string.find("dbc","[b-d][b-d][b-d]")	1 3
[^%s]	corresponde a qualquer caractere não vazio	string.find(" a ","[^%s]")	3 3
[^%d]	corresponde a qualquer caractere não numérico	string.find("123a","[^%d]")	4 4
[^%a]	corresponde a qualquer caractere que não seja letra	string.find("abc1","[^%a]")	4 4

Captura com "()"

Classe de caractere	Descrição	Exemplo	Resultado
()	captura uma string	string.find("12ab","(%a%a)")	3 4 ab
		string.find("ab12","(%d%d)")	3 4 12

Modificadores de padrão

Modificador	Descrição	Exemplo	Resultado
+	indica um ou mais; corresponde ao máximo possível	string.find("aaabbb","(a+b)")	1 4 aaab
		string.find("cccbbb","(a+b)")	nil
-	indica zero ou mais; corresponde ao mínimo possível	string.find("zzxyyy","(xy-)")	3 3 x
		string.find("zzzyyy","(x-y)")	4 4 y
*	indica zero ou mais; corresponde ao máximo possível	string.find("mmmnnn","(m*n)")	1 4 mmmn
		string.find("lllnnn","(m*n)")	4 4 n
?	indica zero ou um	string.find("aaabbb","(a?b)")	3 4 ab
		string.find("cccbbb","(a?b)")	4 4 b

Usos comuns de match

Descrição	Exemplo	Resultado
corresponde a chinês	string.match("男女abc123","([^%w%p]+)")	男女
corresponde a inglês	string.match("男女abc123","(%a+)")	abc
corresponde a números	string.match("男女abc123","(%d+)")	123
corresponde a inglês e números	string.match("男女abc123","(%w+)")	abc123