Gio.DBusNodeInfo¶

Fields¶

Name	Type	Access	Description
annotations	[`Gio.DBusAnnotationInfo`]	r/w	A pointer to a `None`-terminated array of pointers to `Gio.DBusAnnotationInfo` structures or `None` if there are no annotations.
interfaces	[`Gio.DBusInterfaceInfo`]	r/w	A pointer to a `None`-terminated array of pointers to `Gio.DBusInterfaceInfo` structures or `None` if there are no interfaces.
nodes	[`Gio.DBusNodeInfo`]	r/w	A pointer to a `None`-terminated array of pointers to `Gio.DBusNodeInfo` structures or `None` if there are no nodes.
path	`str`	r/w	The path of the node or `None` if omitted. Note that this may be a relative path. See the D-Bus specification for more details.
ref_count	`int`	r/w	The reference count or -1 if statically allocated.

Methods¶

class	`new_for_xml` (xml_data)
	`generate_xml` (indent, string_builder)
	`lookup_interface` (name)
	`ref` ()
	`unref` ()

Details¶

class Gio.DBusNodeInfo¶

Information about nodes in a remote object hierarchy.

New in version 2.26.

classmethod new_for_xml(xml_data)[source]¶

Parameters:: xml_data (str) – Valid D-Bus introspection XML.
Raises:: GLib.Error
Returns:: A Gio.DBusNodeInfo structure or None if error is set. Free with Gio.DBusNodeInfo.unref().
Return type:: Gio.DBusNodeInfo

Parses xml_data and returns a 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.

New in version 2.26.

generate_xml(indent, string_builder)[source]¶

Parameters:

indent (int) – Indentation level.
string_builder (GLib.String) – A GLib.String to to append XML data to.

Appends an XML representation of self (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.

New in version 2.26.

lookup_interface(name)[source]¶

Parameters:: name (str) – A D-Bus interface name.
Returns:: A Gio.DBusInterfaceInfo or None if not found. Do not free, it is owned by self.
Return type:: Gio.DBusInterfaceInfo or None

Looks up information about an interface.

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

New in version 2.26.

ref()[source]¶

Returns:: The same self.
Return type:: Gio.DBusNodeInfo

If self is statically allocated does nothing. Otherwise increases the reference count.

New in version 2.26.

unref()[source]¶: If self is statically allocated, does nothing. Otherwise decreases the reference count of self. When its reference count drops to 0, the memory used is freed.

New in version 2.26.