函数

GLibutf8_casefold

声明 [src]

gchar*
g_utf8_casefold (
  const gchar* str,
  gssize len
)

描述 [src]

将字符串转换成与大小写无关的格式。结果不会对应任何特定的大小写，但可以与调用 g_utf8_casefold() 处理其他字符串所得的结果进行比较或排序，以判断是否相等。

请注意，g_utf8_casefold() 调用后接 g_utf8_collate() 只会近似得出正确的语言大小写无关的排序结果，尽管这个结果已经相当不错。要准确实现这一功能，需要用到更加复杂的对照函数，该函数需要考虑到大小写敏感性。GLib 目前不提供此类 函数。

参数

str

类型: const gchar*

一个 UTF-8 编码字符串。

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

类型: gssize

str 的长度（以字节为单位），如果 str 是空终止的，则为 -1。

返回的值

类型: gchar*

一个新分配的字符串，它是 str 的大小写无关形式。

函数调用者拥有该数据的所有权，并负责释放它。
该值为一个以 NUL 结尾的 UTF-8 字符串。