String.gmatch

From GiderosMobile
Revision as of 09:58, 3 September 2018 by Hgy29 (talk | contribs)


Available since: Gideros 2011.6
Class: string

Description

Returns an iterator function that, each time it is called, returns the next captures from pattern over string s. If pattern specifies no captures, then the whole match is produced in each call.


As an example, the following loop 
    s = "hello world from Lua"
    for w in string.gmatch(s, "%a+") do
      print(w)
    end
will iterate over all the words from string s, printing one per line. The next example collects all pairs key=value from the given string into a table: 
    t = {}
    s = "from=world, to=Lua"
    for k, v in string.gmatch(s, "(%w+)=(%w+)") do
      t[k] = v
    end


For this function, a '^' at the start of a pattern does not work as an anchor, as this would prevent the iteration.
(function) = string.gmatch(s,pat)

Parameters

s: (string) string where to look for patterns
pat: (string) pattern to look for

Return values

Returns (function) iterator function