a search string
flags affecting how the search is done
return location for start of match, or NULL. [out caller-allocates][allow-none]
return location for end of match, or NULL. [out caller-allocates][allow-none]
location of last possible match_end, or NULL for the end of the buffer. [allow-none]
whether a match was found
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 GtkTextIter located before iter, even if there is a possible match_end after or at iter.