Method
GtkTextIterforward_search
Declaration [src]
gboolean
gtk_text_iter_forward_search (
const GtkTextIter* iter,
const char* str,
GtkTextSearchFlags flags,
GtkTextIter* match_start,
GtkTextIter* match_end,
const GtkTextIter* limit
)
Description [src]
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.
Parameters
str |
const char* |
A search string. |
|
| The data is owned by the caller of the function. | |
| The string is a NUL terminated UTF-8 string. | |
flags |
GtkTextSearchFlags |
Flags affecting how the search is done. |
|
match_start |
GtkTextIter |
Return location for start of match. |
|
| The argument will be set by the function. | |
The argument can be NULL. | |
| The data is owned by the caller of the function. | |
match_end |
GtkTextIter |
Return location for end of match. |
|
| The argument will be set by the function. | |
The argument can be NULL. | |
| The data is owned by the caller of the function. | |
limit |
GtkTextIter |
Location of last possible |
|
The argument can be NULL. | |
| The data is owned by the caller of the function. |