函数

GLibstrstr_len

声明 [src]

gchar*
g_strstr_len (
  const gchar* haystack,
  gssize haystack_len,
  const gchar* needle
)

说明 [src]

在字符串 haystack 中搜索字符串 needle 的首次出现，将搜索长度限制在 haystack_len 或 NUL 终止符字节（以二者中先达到的为准）。

长度 -1 可用于表示“搜索整个字符串”，如 strstr()。

此函数返回的 gchar * 而不是 const gchar * 是历史遗留问题。

参数

haystack

类型： const gchar*

要从中搜索的字符串。

数据由函数的调用者所有。
该值是一个以 NUL 结尾的 UTF-8 字符串。
haystack_len

类型： gssize

haystack 以字节为单位的最大长度或 -1 以搜索整个字符串。

needle

类型： const gchar*

要搜索的字符串。

数据由函数的调用者所有。
该值是一个以 NUL 结尾的 UTF-8 字符串。

返回值

类型： gchar*

指向找到出现的指针，如果未找到，则为 NULL。

数据由被调用函数所有。
返回值可以是 NULL。
该值是一个以 NUL 结尾的 UTF-8 字符串。