函数

GLibUriunescape_segment

自:2.16

声明 [源]

char*
g_uri_unescape_segment (
  const char* escaped_string,
  const char* escaped_string_end,
  const char* illegal_characters
)

描述 [源]

将转义字符串的一段转换为普通字符串。

如果 illegal_charactersNUL 字符出现在 escaped_string 中的转义字符中,则这是一个错误,并将返回 NULL。如果你想避免例如在转义路径元素中展开斜杠,可能会让路径处理造成混淆,这很有用。

注意:与 g_uri_unescape_bytes() 不同,输出中不接受 NUL 字节。

自:2.16

参数

escaped_string

类型: const char*

一个字符串,可能为 NULL

该参数可以为 NULL
数据由该函数的调用者拥有。
值是一个以 NUL 结束的 UTF-8 字符串。
escaped_string_end

类型: const char*

指向 escaped_string 结尾的指针,可能为 NULL

该参数可以为 NULL
数据由该函数的调用者拥有。
值是一个以 NUL 结束的 UTF-8 字符串。
illegal_characters

类型: const char*

一个可选的字符串,表示不允许出现的非法字符,可能为 NULL

该参数可以为 NULL
数据由该函数的调用者拥有。
值是一个以 NUL 结束的 UTF-8 字符串。

返回值

类型: char*

返回 escaped_string 的未转义版本,或者在错误发生时返回 NULL。当不再需要时,应释放返回的字符串。作为一个特殊情况,如果为 escaped_string 提供了 NULL,此函数将返回 NULL

该函数的调用者将拥有数据,并且负责释放它。
返回值可以为 NULL
值是一个以 NUL 结束的 UTF-8 字符串。