Anwendungen der string-Bibliothek

Grundlegende Funktionen

Funktion	Beschreibung	Beispiel	Ergebnis
len	Stringlänge berechnen	string.len("abcd")	4
rep	n Kopien des Strings s zurückgeben	string.rep("abcd",2)	abcdabcd
lower	Alle Buchstaben des Strings in Kleinbuchstaben umwandeln	string.lower("AbcD")	abcd
upper	Alle Buchstaben des Strings in Großbuchstaben umwandeln	string.upper("AbcD")	ABCD
format	String formatieren	string.format("the value is:%d",4)	the value is:4
sub	Teilstring aus einem String ausschneiden	string.sub("abcd",2)	bcd
		string.sub("abcd",-2)	cd
		string.sub("abcd",2,-2)	bc
		string.sub("abcd",2,3)	bc
find	Im String suchen (Position anzeigen)	string.find("cdcdcdcd","ab")	nil
		string.find("cdcdcdcd","cd")	1 2
		string.find("cdcdcdcd","cd",7)	7 8
match	Im String suchen (Inhalt anzeigen)	string.match("cdcdcdcd","ab")	nil
		string.match("cdcdcdcd","cd")	cd
gsub	Im String ersetzen	string.gsub("abcdabcd","a","z")	zbcdzbcd 2
		string.gsub("aaaa","a","z",3)	zzza 3
byte	Zeichen als Ganzzahl zurückgeben	string.byte("ABCD",4)	68
char	Ganzzahlen in Zeichen umwandeln und verbinden	string.char(97,98,99,100)	abcd

Grundlegende Musterstrings

Zeichenklasse	Beschreibung	Beispiel	Ergebnis
.	Beliebiges Zeichen	string.find("",".")	nil
%s	Leerzeichen	string.find("ab cd","%s%s")	3 4
%S	Nicht-Leerzeichen	string.find("ab cd","%S%S")	1 2
%p	Satzzeichen	string.find("ab,.cd","%p%p")	3 4
%P	Nicht-Satzzeichen	string.find("ab,.cd","%P%P")	1 2
%c	Steuerzeichen	string.find("abcd\t\n","%c%c")	5 6
%C	Nicht-Steuerzeichen	string.find("\t\nabcd","%C%C")	3 4
%d	Ziffer	string.find("abcd12","%d%d")	5 6
%D	Nicht-Ziffer	string.find("12abcd","%D%D")	3 4
%x	Hexadezimalziffer	string.find("efgh","%x%x")	1 2
%X	Keine Hexadezimalziffer	string.find("efgh","%X%X")	3 4
%a	Buchstabe	string.find("AB12","%a%a")	1 2
%A	Kein Buchstabe	string.find("AB12","%A%A")	3 4
%l	Kleinbuchstabe	string.find("ABab","%l%l")	3 4
%L	Großbuchstabe	string.find("ABab","%L%L")	1 2
%u	Großbuchstabe	string.find("ABab","%u%u")	1 2
%U	Kein Großbuchstabe	string.find("ABab","%U%U")	3 4
%w	Buchstabe oder Ziffer	string.find("a1()","%w%w")	1 2
%W	Weder Buchstabe noch Ziffer	string.find("a1()","%W%W")	3 4

Escapezeichen %

Zeichenklasse	Beschreibung	Beispiel	Ergebnis
%	Escapezeichen	string.find("abc%..","%%")	4 4
		string.find("abc..d","%.%.")	4 5

Zeichensätze mit [] erstellen; "-" ist der Bindestrich, "^" das Komplement des Zeichensatzes

Zeichenklasse	Beschreibung	Beispiel	Ergebnis
[01]	Binärzahlen abgleichen	string.find("32123","[01]")	3 3
[AB][CD]	AC, AD, BC und BD abgleichen	string.find("ABCDEF","[AB][CD]")	2 3
[[]]	Ein Paar eckiger Klammern [] abgleichen	string.find("ABC[]D","[[]]")	4 5
[1-3]	Ziffern von 1 bis 3 abgleichen	string.find("312","[1-3][1-3][1-3]")	1 3
[b-d]	Buchstaben von b bis d abgleichen	string.find("dbc","[b-d][b-d][b-d]")	1 3
[^%s]	Beliebiges Nicht-Leerzeichen abgleichen	string.find(" a ","[^%s]")	3 3
[^%d]	Beliebige Nicht-Ziffer abgleichen	string.find("123a","[^%d]")	4 4
[^%a]	Beliebigen Nicht-Buchstaben abgleichen	string.find("abc1","[^%a]")	4 4

Mit "()" Captures erstellen

Zeichenklasse	Beschreibung	Beispiel	Ergebnis
()	String erfassen	string.find("12ab","(%a%a)")	3 4 ab
		string.find("ab12","(%d%d)")	3 4 12

Muster-Modifikatoren

Modifikator	Beschreibung	Beispiel	Ergebnis
+	Bedeutet eines oder mehrere, möglichst viele abgleichen	string.find("aaabbb","(a+b)")	1 4 aaab
		string.find("cccbbb","(a+b)")	nil
-	Bedeutet null oder mehrere, möglichst wenige abgleichen	string.find("zzxyyy","(xy-)")	3 3 x
		string.find("zzzyyy","(x-y)")	4 4 y
*	Bedeutet null oder mehrere, möglichst viele abgleichen	string.find("mmmnnn","(m*n)")	1 4 mmmn
		string.find("lllnnn","(m*n)")	4 4 n
?	Bedeutet null oder eines	string.find("aaabbb","(a?b)")	3 4 ab
		string.find("cccbbb","(a?b)")	4 4 b

Häufige Verwendungen von match

Beschreibung	Beispiel	Ergebnis
Chinesisch abgleichen	string.match("男女abc123","([^%w%p]+)")	男女
Englisch abgleichen	string.match("男女abc123","(%a+)")	abc
Ziffern abgleichen	string.match("男女abc123","(%d+)")	123
Englisch und Ziffern abgleichen	string.match("男女abc123","(%w+)")	abc123