getGroupStart

From RPTools Wiki
Revision as of 17:59, 14 March 2023 by Taustin (talk | contribs) (Text replacement - "source>" to "syntaxhighlight>")
Jump to navigation Jump to search

getGroupStart() Function

Introduced in version 1.3b48
Returns the start index of the specified capture group for the specified match that was found using strfind()

Usage

<source lang="mtmacro" line> getGroupStart(id, match, group) </syntaxhighlight> Where

  • id is the id returned by strfind()
  • match is the number of the match found by strfind()
  • group is the number of the capture group found by strfind()

Example

<source lang="mtmacro" line>

[h: id = strfind("this is a test", "(\\S+)\\s(\\S+)\\s*")] match 1, group 1 start = [getGroupStart(id, 1, 1)]
match 1, group 2 start = [getGroupStart(id, 1, 2)]
match 2, group 1 start = [getGroupStart(id, 2, 1)]
match 2, group 2 start = [getGroupStart(id, 2, 2)]
</syntaxhighlight> Returns

match 1, group 1 start = 0 
match 1, group 2 start = 5 
match 2, group 1 start = 8 
match 2, group 2 start = 10