方法
GtkTextIterforward_search
声明 [src]
gboolean
gtk_text_iter_forward_search (
const GtkTextIter* iter,
const char* str,
GtkTextSearchFlags flags,
GtkTextIter* match_start,
GtkTextIter* match_end,
const GtkTextIter* limit
)
描述 [src]
向前进搜索字符串 str
。
任何匹配都通过将 match_start
设置为匹配的第一个字符并将 match_end
设置为匹配后的第一个字符来返回。搜索将不会超出 limit
。注意,搜索是一个线性或 O(n) 操作,所以您可能希望使用 limit
来避免在大缓冲区上锁定您的 UI。
match_start
永远不会设置为一个在 iter
之前的 GtkTextIter
,即使存在在或之后于 iter
的可能 match_end
。
参数
str
-
类型:
const char*
一个搜索字符串。
数据由方法的调用者拥有。 值是一个以空字符终止的 UTF-8 字符串。 flags
-
影响搜索如何进行的标志。
match_start
-
类型:
GtkTextIter
匹配开始的返回位置。
该参数将由函数设置。 该参数可以是 NULL
。返回的数据由实例拥有。 match_end
-
类型:
GtkTextIter
匹配结束的返回位置。
该参数将由函数设置。 该参数可以是 NULL
。返回的数据由实例拥有。 limit
-
类型:
GtkTextIter
最后一个可能的
match_end
的位置,或NULL
为缓冲区的末尾。该参数可以是 NULL
。数据由方法的调用者拥有。