gtkTextIterForwardSearch {RGtk2} | R Documentation |
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.
gtkTextIterForwardSearch(object, str, flags, limit = NULL)
|
start of search |
|
a search string |
|
flags affecting how the search is done |
|
bound for the search, or |
If the
GTK_TEXT_SEARCH_VISIBLE_ONLYflag 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.
A list containing the following elements:
retval |
[logical] whether a match was found |
|
return location for start of match, or |
|
return location for end of match, or |
Derived by RGtkGen from GTK+ documentation