Gtk.TextIter.prototype.forward_search

function forward_search(str:String, flags:Gtk.TextSearchFlags, limit:Gtk.TextIter):Boolean {
    // Gjs wrapper for gtk_text_iter_forward_search()
}

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.

If the #GTK_TEXT_SEARCH_VISIBLE_ONLY flag is present, the match may have invisible text interspersed in str. i.e. str will be a possibly-noncontiguous subsequence of the matched range. similarly, if you specify #GTK_TEXT_SEARCH_TEXT_ONLY, the match may have pixbufs or child widgets mixed inside the matched range. If these flags are not given, the match must be exact; the special 0xFFFC character in str will match embedded pixbufs or child widgets. If you specify the #GTK_TEXT_SEARCH_CASE_INSENSITIVE flag, the text will be matched regardless of what case it is in.

str

a search string

flags

flags affecting how the search is done

limit

bound for the search, or null for the end of the buffer

Returns

whether a match was found