方法

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

类型: GtkTextSearchFlags

影响搜索如何进行的标志。

match_start

类型: GtkTextIter

匹配开始的返回位置。

该参数将由函数设置。
该参数可以是 NULL
返回的数据由实例拥有。
match_end

类型: GtkTextIter

匹配结束的返回位置。

该参数将由函数设置。
该参数可以是 NULL
返回的数据由实例拥有。
limit

类型: GtkTextIter

最后一个可能的 match_end 的位置,或 NULL 为缓冲区的末尾。

该参数可以是 NULL
数据由方法的调用者拥有。

返回值

类型: gboolean

是否找到匹配。