:right-sidebar: True

MarkupParser
===================================================================

.. currentmodule:: gi.repository.GLib





.. class:: MarkupParser(*args, **kwargs)
   :no-contents-entry:






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












Fields
------

.. rst-class:: interim-class

.. class:: MarkupParser
   :no-index:
   

   .. attribute:: end_element

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






   .. attribute:: error

      Callback to invoke when an error occurs.






   .. attribute:: passthrough

      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
          :const:`~gi.repository.GLib.MarkupParseFlags.TREAT_CDATA_AS_TEXT` flag is not set, this function is also
          called for CDATA marked sections.






   .. attribute:: start_element

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






   .. attribute:: text

      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
          :const:`~gi.repository.GLib.MarkupParseFlags.TREAT_CDATA_AS_TEXT` flag is set, this function is also
          called for the content of CDATA marked sections.