メインコンテンツまでスキップ

string ライブラリの活用

基本関数

関数説明結果
len文字列の長さを計算string.len("abcd")4
rep文字列 s のコピーを n 個返す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

パターン修飾子

修飾子説明結果
+1 個以上を表し、最長一致string.find("aaabbb","(a+b)")1 4 aaab
string.find("cccbbb","(a+b)")nil
-0 個以上を表し、最短一致string.find("zzxyyy","(xy-)")3 3 x
string.find("zzzyyy","(x-y)")4 4 y
*0 個以上を表し、最長一致string.find("mmmnnn","(m*n)")1 4 mmmn
string.find("lllnnn","(m*n)")4 4 n
?0 個または 1 個を表す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