:right-sidebar: True

DBusNodeInfo
===================================================================

.. currentmodule:: gi.repository.Gio


.. versionadded:: 2.26




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






Information about nodes in a remote object hierarchy.


Constructors
------------

.. rst-class:: interim-class

.. class:: DBusNodeInfo
   :no-index:


   .. classmethod:: new_for_xml(xml_data: str) -> ~gi.repository.Gio.DBusNodeInfo

      Parses ``xml_data`` and returns a :obj:`~gi.repository.Gio.DBusNodeInfo` representing the data.

      The introspection XML must contain exactly one top-level
      ``<node>`` element.

      Note that this routine is using a
      [GMarkup][glib-Simple-XML-Subset-Parser.description]-based
      parser that only accepts a subset of valid XML documents.


      .. versionadded:: 2.26





      :param xml_data: Valid D-Bus introspection XML.








Methods
-------

.. rst-class:: interim-class

.. class:: DBusNodeInfo
   :no-index:


   .. method:: generate_xml(indent: int, string_builder: ~gi.repository.GLib.String) -> None

      Appends an XML representation of ``info`` (and its children) to ``string_builder``\.

      This function is typically used for generating introspection XML documents at run-time for
      handling the ``org.freedesktop.DBus.Introspectable.Introspect``  method.


      .. versionadded:: 2.26





      :param indent: Indentation level.

      :param string_builder: A :obj:`~gi.repository.GLib.String` to to append XML data to.




   .. method:: lookup_interface(name: str) -> ~gi.repository.Gio.DBusInterfaceInfo | None

      Looks up information about an interface.

      The cost of this function is O(n) in number of interfaces.


      .. versionadded:: 2.26





      :param name: A D-Bus interface name.














Fields
------

.. rst-class:: interim-class

.. class:: DBusNodeInfo
   :no-index:
   

   .. attribute:: annotations

      A pointer to a :const:`None`-terminated array of pointers to :obj:`~gi.repository.Gio.DBusAnnotationInfo` structures or :const:`None` if there are no annotations.






   .. attribute:: interfaces

      A pointer to a :const:`None`-terminated array of pointers to :obj:`~gi.repository.Gio.DBusInterfaceInfo` structures or :const:`None` if there are no interfaces.






   .. attribute:: nodes

      A pointer to a :const:`None`-terminated array of pointers to :obj:`~gi.repository.Gio.DBusNodeInfo` structures or :const:`None` if there are no nodes.






   .. attribute:: path

      The path of the node or :const:`None` if omitted. Note that this may be a relative path. See the D-Bus specification for more details.






   .. attribute:: ref_count

      The reference count or -1 if statically allocated.