方法

GLibMarkupParseContextparse

声明 [源代码]

gboolean
g_markup_parse_context_parse (
  GMarkupParseContext* context,
  const gchar* text,
  gssize text_len,
  GError** error
)

描述 [源代码]

GMarkupParseContext 提供一些数据。

数据不需要是有效的 UTF-8;如果数据无效,将发出错误信号。数据不需要是一个完整的文档;您可以通过多次调用该函数来增量地将文档喂给解析器。通常,您从网络连接或文件接收数据时,可以将每个接收到的数据块喂给此函数,如果发生错误则终止过程。一旦报告了错误,就不能再向 GMarkupParseContext 提供更多数据;所有错误都是致命的。

参数

text

类型: const gchar*

要解析的文本块。

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

类型: gssize

text 的字节长度。

error

类型: GError **

恢复性错误的可返回位置。

该参数可以为 NULL
如果返回位置不为 NULL,则必须将其初始化为一个 NULLGError*
如果没有错误,方法将保留初始化参数为 NULL
在发生错误的情况下,该参数将被设置为一个新的 GError;调用者将接管数据,并负责释放它。

返回值

类型: gboolean

如果发生错误,则返回 FALSE,在成功时返回 TRUE