Applications de la bibliothèque string

Fonctions de base

Fonction	Description	Exemple	Résultat
len	calculer la longueur d’une chaîne	string.len("abcd")	4
rep	renvoyer n copies de la chaîne s	string.rep("abcd",2)	abcdabcd
lower	convertir toutes les lettres de la chaîne en minuscules	string.lower("AbcD")	abcd
upper	convertir toutes les lettres de la chaîne en majuscules	string.upper("AbcD")	ABCD
format	formater une chaîne	string.format("the value is:%d",4)	the value is:4
sub	extraire une sous-chaîne	string.sub("abcd",2)	bcd
		string.sub("abcd",-2)	cd
		string.sub("abcd",2,-2)	bc
		string.sub("abcd",2,3)	bc
find	rechercher une chaîne (afficher la position)	string.find("cdcdcdcd","ab")	nil
		string.find("cdcdcdcd","cd")	1 2
		string.find("cdcdcdcd","cd",7)	7 8
match	rechercher une chaîne (afficher le contenu)	string.match("cdcdcdcd","ab")	nil
		string.match("cdcdcdcd","cd")	cd
gsub	remplacer une chaîne	string.gsub("abcdabcd","a","z")	zbcdzbcd 2
		string.gsub("aaaa","a","z",3)	zzza 3
byte	renvoyer la forme entière d’un caractère	string.byte("ABCD",4)	68
char	convertir des nombres entiers en caractères et les concaténer	string.char(97,98,99,100)	abcd

Classes de caractères courantes

Classe de caractères	Description	Exemple	Résultat
.	n’importe quel caractère	string.find("",".")	nil
%s	espace blanc	string.find("ab cd","%s%s")	3 4
%S	caractère qui n’est pas un espace blanc	string.find("ab cd","%S%S")	1 2
%p	signe de ponctuation	string.find("ab,.cd","%p%p")	3 4
%P	caractère qui n’est pas un signe de ponctuation	string.find("ab,.cd","%P%P")	1 2
%c	caractère de contrôle	string.find("abcd\t\n","%c%c")	5 6
%C	caractère qui n’est pas un caractère de contrôle	string.find("\t\nabcd","%C%C")	3 4
%d	chiffre	string.find("abcd12","%d%d")	5 6
%D	caractère qui n’est pas un chiffre	string.find("12abcd","%D%D")	3 4
%x	chiffre hexadécimal	string.find("efgh","%x%x")	1 2
%X	caractère qui n’est pas un chiffre hexadécimal	string.find("efgh","%X%X")	3 4
%a	lettre	string.find("AB12","%a%a")	1 2
%A	caractère qui n’est pas une lettre	string.find("AB12","%A%A")	3 4
%l	lettre minuscule	string.find("ABab","%l%l")	3 4
%L	lettre majuscule	string.find("ABab","%L%L")	1 2
%u	lettre majuscule	string.find("ABab","%u%u")	1 2
%U	caractère qui n’est pas une lettre majuscule	string.find("ABab","%U%U")	3 4
%w	lettre ou chiffre	string.find("a1()","%w%w")	1 2
%W	caractère qui n’est ni une lettre ni un chiffre	string.find("a1()","%W%W")	3 4

Caractère d’échappement %

Classe de caractères	Description	Exemple	Résultat
%	caractère d’échappement	string.find("abc%..","%%")	4 4
		string.find("abc..d","%.%.")	4 5

Créer un ensemble de caractères avec [] ; « - » est le trait d’union et « ^ » représente le complément de l’ensemble

Classe de caractères	Description	Exemple	Résultat
[01]	faire correspondre un nombre binaire	string.find("32123","[01]")	3 3
[AB][CD]	faire correspondre AC, AD, BC ou BD	string.find("ABCDEF","[AB][CD]")	2 3
[[]]	faire correspondre une paire de crochets []	string.find("ABC[]D","[[]]")	4 5
[1-3]	faire correspondre les chiffres 1 à 3	string.find("312","[1-3][1-3][1-3]")	1 3
[b-d]	faire correspondre les lettres b à d	string.find("dbc","[b-d][b-d][b-d]")	1 3
[^%s]	faire correspondre n’importe quel caractère non blanc	string.find(" a ","[^%s]")	3 3
[^%d]	faire correspondre n’importe quel caractère qui n’est pas un chiffre	string.find("123a","[^%d]")	4 4
[^%a]	faire correspondre n’importe quel caractère qui n’est pas une lettre	string.find("abc1","[^%a]")	4 4

Utiliser « () » pour capturer

Classe de caractères	Description	Exemple	Résultat
()	capturer une chaîne	string.find("12ab","(%a%a)")	3 4 ab
		string.find("ab12","(%d%d)")	3 4 12

Modificateurs de motif

Modificateur	Description	Exemple	Résultat
+	indique un ou plusieurs éléments et fait correspondre le plus grand nombre possible	string.find("aaabbb","(a+b)")	1 4 aaab
		string.find("cccbbb","(a+b)")	nil
-	indique zéro ou plusieurs éléments et fait correspondre le plus petit nombre possible	string.find("zzxyyy","(xy-)")	3 3 x
		string.find("zzzyyy","(x-y)")	4 4 y
*	indique zéro ou plusieurs éléments et fait correspondre le plus grand nombre possible	string.find("mmmnnn","(m*n)")	1 4 mmmn
		string.find("lllnnn","(m*n)")	4 4 n
?	indique zéro ou un élément	string.find("aaabbb","(a?b)")	3 4 ab
		string.find("cccbbb","(a?b)")	4 4 b

Utilisations courantes de match

Description	Exemple	Résultat
faire correspondre du chinois	string.match("男女abc123","([^%w%p]+)")	男女
faire correspondre de l’anglais	string.match("男女abc123","(%a+)")	abc
faire correspondre des chiffres	string.match("男女abc123","(%d+)")	123
faire correspondre des lettres et des chiffres	string.match("男女abc123","(%w+)")	abc123