函数

GLibVariantparse_error_print_context

since: 2.40

声明 [src]

gchar*
g_variant_parse_error_print_context (
  GError* error,
  const gchar* source_str
)

描述 [src]

以规范方式打印出字符串中 Showing the context of a GVariant parse error 的消息。

生成的字符串适合输出到控制台或其他以标准方式处理换行符的单屏媒体。

该消息通常看起来像以下之一

unterminated string constant:
  (1, 2, 3, 'abc
            ^^^^

或

unable to find a common type:
  [1, 2, 3, 'str']
   ^        ^^^^^

未来的版本中消息格式可能会更改。

error 必须来自 g_variant_parse() 的失败尝试，而 source_str 必须是造成错误的 exact same string。如果当您传递 source_str 到 g_variant_parse() 时它没有以 nul结尾，那么在使用此函数之前必须添加 nul 结尾。

since: 2.40

参数

error

类型: GError

来自 GVariantParseError 域的 GError。

数据由函数的调用者拥有。

source_str

类型: const gchar*

传递给解析器的字符串。

数据由函数的调用者拥有。

值是一个以 NUL 结尾的 UTF-8 字符串。

返回值

类型: gchar*

打印的消息。

函数的调用者获得数据的所有权，并负责释放它。

值是一个以 NUL 结尾的 UTF-8 字符串。