GLib.MarkupParser

Fields

Name

Type

Access

Description

end_element

object

r

Callback to invoke when the closing tag of an element is seen. Note that this is also called for empty tags like <empty/>.

error

object

r

Callback to invoke when an error occurs.

passthrough

object

r

Callback to invoke for comments, processing instructions and doctype declarations; if you’re re-writing the parsed document, write the passthrough text back out in the same position. If the GLib.MarkupParseFlags.TREAT_CDATA_AS_TEXT flag is not set, this function is also called for CDATA marked sections.

start_element

object

r

Callback to invoke when the opening tag of an element is seen. The callback’s attribute_names and attribute_values parameters are None-terminated.

text

object

r

Callback to invoke when some text is seen (text is always inside an element). Note that the text of an element may be spread over multiple calls of this function. If the GLib.MarkupParseFlags.TREAT_CDATA_AS_TEXT flag is set, this function is also called for the content of CDATA marked sections.

Methods

None

Details

class GLib.MarkupParser

Any of the fields in GLib.MarkupParser can be None, in which case they will be ignored. Except for the error function, any of these callbacks can set an error; in particular the GLib.MarkupError.UNKNOWN_ELEMENT, GLib.MarkupError.UNKNOWN_ATTRIBUTE, and GLib.MarkupError.INVALID_CONTENT errors are intended to be set from these callbacks. If you set an error from a callback, GLib.MarkupParseContext.parse() will report that error back to its caller.