string.gmatch (s, pattern)

イテレータ関数は、呼び出されるたびに、文字列s の パターンから次のキャプチャを返します。

patternがキャプチャなしを指定した場合、各呼び出しでマッチ全体が生成される。

例として、次のループでは、

s = "hello world from Lua"
for w in string.gmatch(s, "%a+") do
print(w)

end

ストリング s のすべての単語について繰り返し、それぞれを別々の行に出力します。次の例は、与えられた文字列からすべてのペア「key=value 」をテーブルに集める：

t = {}
s = "from=world, to=Lua"

for k, v in string.gmatch(s, "(%w+)=(%w+)") do t[k] = v

end

この関数の場合、パターンの始まりの「^」は、反復をさせないための、アンカーとして機能しません。