![]() |
![]() |
![]() |
GtkSourceView 2 Reference Manual | ![]() |
---|---|---|---|---|
Top | Description |
GtkSourceIterGtkSourceIter — Improved search support in a GtkSourceBuffer |
#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
);
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.
|
a GtkTextIter where the search begins. |
|
search string. |
|
bitmask of flags affecting the search. |
|
(allow-none) return location for start of match, or NULL .
|
|
return location for end of match, or NULL . [allow-none]
|
|
location of last possible match_start , or NULL for start of buffer. [allow-none]
|
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.
|
start of search. |
|
a search string. |
|
flags affecting how the search is done. |
|
return location for start of match, or NULL . [allow-none]
|
|
return location for end of match, or NULL . [allow-none]
|
|
bound for the search, or NULL for the end of the buffer. [allow-none]
|
Returns : |
whether a match was found. |