GtkSourceView Reference Manual | ||||
---|---|---|---|---|
#include <gtksourceview/gtksourceiter.h> enum GtkSourceSearchFlags; gboolean gtk_source_iter_backward_search (const GtkTextIter *iter, const gchar *str, GtkSourceSearchFlags flags, GtkTextIter *match_start, GtkTextIter *match_end, const GtkTextIter *limit); gboolean gtk_source_iter_forward_search (const GtkTextIter *iter, const gchar *str, GtkSourceSearchFlags flags, GtkTextIter *match_start, GtkTextIter *match_end, const GtkTextIter *limit); gboolean gtk_source_iter_find_matching_bracket (GtkTextIter *iter);
typedef enum { GTK_SOURCE_SEARCH_VISIBLE_ONLY = 1 << 0, GTK_SOURCE_SEARCH_TEXT_ONLY = 1 << 1, GTK_SOURCE_SEARCH_CASE_INSENSITIVE = 1 << 2 /* Possible future plans: SEARCH_REGEXP */ } GtkSourceSearchFlags;
gboolean gtk_source_iter_backward_search (const GtkTextIter *iter, const gchar *str, GtkSourceSearchFlags flags, GtkTextIter *match_start, GtkTextIter *match_end, const GtkTextIter *limit);
Same as gtk_text_iter_backward_search()
, but supports case insensitive
searching.
iter : |
a GtkTextIter where the search begins. |
str : |
search string. |
flags : |
bitmask of flags affecting the search. |
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 match_start , or %NULL for start of buffer.
|
Returns : | whether a match was found. |
gboolean gtk_source_iter_forward_search (const GtkTextIter *iter, const gchar *str, GtkSourceSearchFlags flags, GtkTextIter *match_start, GtkTextIter *match_end, const GtkTextIter *limit);
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_SOURCE_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_SOURCE_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_SOURCE_SEARCH_CASE_INSENSITIVE flag, the text will
be matched regardless of what case it is in.
Same as gtk_text_iter_forward_search()
, but supports case insensitive
searching.
iter : |
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 : |
bound for the search, or %NULL for the end of the buffer.
|
Returns : | whether a match was found. |
gboolean gtk_source_iter_find_matching_bracket (GtkTextIter *iter);
Tries to match the bracket character currently at iter
with its
opening/closing counterpart, and if found moves iter
to the position
where it was found.
iter
must be a GtkTextIter belonging to a GtkSourceBuffer.
iter : |
a GtkTextIter. |
Returns : | TRUE if the matching bracket was found and the iter
iter moved.
|