方法

GLibVariantget_string

自:2.24

声明 [源]

const gchar*
g_variant_get_string (
  GVariant* value,
  gsize* length
)

描述 [源]

返回字符串类型 GVariant 实例的字符串值。这包括类型 G_VARIANT_TYPE_STRINGG_VARIANT_TYPE_OBJECT_PATHG_VARIANT_TYPE_SIGNATURE

字符串将始终以 UTF-8 编码, Never 将是 NULL,并将 never 包含 nul 字节。

如果length不是NULL,则返回字符串的长度(以字节为单位)。对于可信值,这些信息已经知道。不可信的值将会被验证,如果验证通过,将执行strlen()。如果无效,将返回默认值 —— 对于G_VARIANT_TYPE_OBJECT_PATH,这是"/",对于其他类型则是空字符串。

使用除了这三种类型之外的任何类型的value调用此函数将是一个错误。

只要value存在,返回值就是有效的。

自2.24版本起可用。

参数

length

类型: gsize*

存储长度的指针。

此参数将由函数设置。
此参数可以是NULL

返回值

类型: const gchar*

常量字符串,UTF-8编码。

返回的数据由实例拥有。
值是一个以NUL终止的UTF-8字符串。