re:gmatch

Matches a regexp to a string, applying a function

Prototype

result = re:gmatch (string, fun, count, flags)

The gmatch function:

Tries to match the regex re against string up to count times (or as many as possible if count is either not given or is not a positive number), subject to execution flags "flags".
Each time there is a match, fun is called as fun (m, t), where m is the matched string and t is a table of substring matches (this table contains false in the positions where the corresponding sub-pattern did not match.).
If fun returns a true value, then gmatch immediately returns.
gmatch returns the number of matches made.


re = rex.new ("(\[A-Za-z\]+)")
n = re:gmatch ("Nick goes East", function (m, t) print (m) end )
print (n) --> 3

Output from function during execution:

Nick
goes
East