Searches forward for str
.
Any match is returned by setting match_start
to the first character of the match and match_end
to the first
character after the match. The search will not continue past limit
. Note that a search is a linear or O(n) operation, so you
may wish to use limit
to avoid locking up your UI on large buffers.
match_start
will never be set to a TextIter located before
this, even if there is a possible match_end
after or at this
.
this |
start of search |
str |
a search string |
flags |
flags affecting how the search is done |
match_start |
return location for start of match, or null |
match_end |
return location for end of match, or null |
limit |
location of last possible |
whether a match was found |