Editing WoW:USERAPI strfindt

{{userfunc}} <!-- Leave this line in! -->
<center>'''strfindt''' ''- by [[user:Mikk|Mikk]] -''</center>


<!-- Describe the purpose of the function(s), exhausting detail can be saved for a later section -->
A thin wrapper for [[API strfind|strfind]] that returns the results as a table, allowing it to be used in e.g. if() clauses while capturing subexpressions.

<!-- List return values and arguments as well as function name(s), follow Blizzard usage convention for args -->
 nBeginPos, nEndPos = ''&lt;PREFIX&gt;''_strfindt(tableCaptures, strHaystack, strRegex, nStartPos, boolPlain)


== Function Parameters ==
<!-- If you are listing several functions, you'll need to have several of these, e.g. "Foo Parameters", "Bar Parameters",... -->
=== Arguments ===
<!-- List each argument, together with its type -->
:(tableCaptures, strHaystack, strRegex, nStartPos, boolPlain)

:;tableCaptures : '''output''' Table - captured subexpressions
<small>(identical to [[API strfind|strfind]]() after this point)</small>
:;strHaystack : String - the string to perform the search in
:;strRegex : String - the regular expression (search pattern)
:;nStartPos : Number - the position to begin the search on (nil = from the beginning)
:;boolPlain : Boolean - set to ''true'' to not use regexes (which defeats the whole purpose of this wrapper)

=== Returns ===
<!-- List each return value, together with its type -->
:nBegin, nEnd

:;nBeginPos : Number - beginning of match (1-based) or nil for no match
:;nEndPos: String - end position of match


== Example ==
  local results = {};
  if(''&lt;PREFIX&gt;''_strfindt(results, 
    '&lt;b>&lt;a href="wowwiki.com">WoWWiki&lt;/a>', 
    '&lt;a [^>]*%fhref="([^"]*)"[^>]>([^<])+&lt;/a>')
  then
    print results[2] . " lives at " . results[1];
  end

====Result====
  WoWWiki lives at wowwiki.com

==Code==
  -- Returns: nBeginPos, nEndPos.  Captured expressions go in tOut
  function ''&lt;PREFIX&gt;''_strfindt(tOut, strFind, strRegex, nStart, bPlain)
    local a = { string.find(strFind, strRegex, nStart, bPlain) };
    while(getn(tOut)>0) do tremove(tOut,1); end
    for _,v in a do
      tinsert(tOut, v);
    end
    return a[1], a[2];
  end  

__NOTOC__
[[Category:User defined functions]]