函数

Giodbus_escape_object_path_bytestring

自:2.68

声明 [src]

gchar*
g_dbus_escape_object_path_bytestring (
  const guint8* bytes
)

说明 [src]

转义 bytes 以用于 D-Bus 对象路径组件。bytes 是一个数组,其中包含一个或多个非零字节(使用未指定编码),后跟一个零字节。

转义方法包括用下划线 (_) 前缀其十六进制值替换所有非字母数字字符(参见 g_ascii_isalnum())。例如:foo.bar.baz 将变为 foo_2ebar_2ebaz

当输入几乎是一个有效的对象路径组件时,可以使用此方法,但输入远离有效对象路径组件时不能使用。其他转义算法也可以与 D-Bus 对象路径配合使用。

这可以通过 g_dbus_unescape_object_path() 来逆转。

自:2.68 起可用

参数

bytes

类型:一个 guint8 数组

要转义的字节字符串。

该数组必须以 NULL 结尾。
数据归函数调用者所有。

返回值

类型: gchar*

bytes 的转义版本。使用 g_free() 释放。

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