函数

GLibutf8_collate_key

声明 [src]

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

描述 [src]

将字符串转换为整理密钥，该密钥可与使用 strcmp() 由同一函数生成的其它整理密钥进行比较。

使用 strcmp() 比较两个字符串的整理密钥的结果将始终与使用 g_utf8_collate() 比较两个原始密钥相同。

请注意，此函数取决于 [当前语言环境][setlocale]。

请注意，返回的字符串不能保证为任何编码，尤其是 UTF-8。返回值仅用于比较。

参数

str

类型： const gchar*

UTF-8 编码字符串。

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

类型： gssize

str 的长度（以字节为单位），或如果 str 以 nul 结尾，则为 -1。

返回值

类型： gchar*

新分配的字符串。字符串内容仅用于排序时。用完该字符串后，应使用 g_free() 释放该字符串。

函数的调用者负责拥有该数据并释放它。
该值是平台原生字符串，在类 Unix 系统上使用首选的操作系统编码，在 Windows 上使用 UTF-8。