glibmm 2.56.0

Public Member Functions | Protected Member Functions | Related Functions | List of all members
Gio::DBus::InterfaceInfo Class Referencefinal
D-Bus API

Stores information about a D-Bus interface. More...

`#include <giomm/dbusintrospection.h>`

## Public Member Functions
void | reference () const
| Increment the reference count for this object. More...
void | unreference () const
| Decrement the reference count for this object. More...
GDBusInterfaceInfo* | gobj ()
| Provides access to the underlying C instance. More...
const GDBusInterfaceInfo* | gobj () const
| Provides access to the underlying C instance. More...
GDBusInterfaceInfo* | gobj_copy () const
| Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs. More...
| InterfaceInfo ()=delete
| InterfaceInfo (const InterfaceInfo&)=delete
InterfaceInfo& | operator= (const InterfaceInfo&)=delete
Glib::RefPtr< MethodInfo > | lookup_method (const Glib::ustring& name)
| Looks up information about a method. More...
Glib::RefPtr< const MethodInfo > | lookup_method (const Glib::ustring& name) const
| Looks up information about a method. More...
Glib::RefPtr< SignalInfo > | lookup_signal (const Glib::ustring& name)
| Looks up information about a signal. More...
Glib::RefPtr< const SignalInfo > | lookup_signal (const Glib::ustring& name) const
| Looks up information about a signal. More...
Glib::RefPtr< PropertyInfo > | lookup_property (const Glib::ustring& name)
| Looks up information about a property. More...
Glib::RefPtr< const PropertyInfo > | lookup_property (const Glib::ustring& name) const
| Looks up information about a property. More...
void | cache_build ()
| Builds a lookup-cache to speed up g_dbus_interface_info_lookup_method(), g_dbus_interface_info_lookup_signal() and g_dbus_interface_info_lookup_property(). More...
void | cache_release ()
| Decrements the usage count for the cache for info built by g_dbus_interface_info_cache_build() (if any) and frees the resources used by the cache if the usage count drops to zero. More...

## Protected Member Functions
void | operator delete (void*, std::size_t)

## Related Functions
(Note that these are not member functions.)
Glib::RefPtr< Gio::DBus::InterfaceInfo > | wrap (GDBusInterfaceInfo* object, bool take_copy=false)
| A Glib::wrap() method for this object. More...

## Detailed Description

Stores information about a D-Bus interface.

Since glibmm 2.28:

## Constructor & Destructor Documentation

## ◆ InterfaceInfo() [1/2]

Gio::DBus::InterfaceInfo::InterfaceInfo | ( |  | ) |
| delete

## ◆ InterfaceInfo() [2/2]

Gio::DBus::InterfaceInfo::InterfaceInfo | ( | const InterfaceInfo& |  | ) |
| delete

## Member Function Documentation

## ◆ cache_build()

void Gio::DBus::InterfaceInfo::cache_build | ( |  | ) |

Builds a lookup-cache to speed up g_dbus_interface_info_lookup_method(), g_dbus_interface_info_lookup_signal() and g_dbus_interface_info_lookup_property().

If this has already been called with info, the existing cache is used and its use count is increased.

Note that info cannot be modified until g_dbus_interface_info_cache_release() is called.

Since glibmm 2.44:

## ◆ cache_release()

void Gio::DBus::InterfaceInfo::cache_release | ( |  | ) |

Decrements the usage count for the cache for info built by g_dbus_interface_info_cache_build() (if any) and frees the resources used by the cache if the usage count drops to zero.

Since glibmm 2.44:

## ◆ gobj() [1/2]

GDBusInterfaceInfo* Gio::DBus::InterfaceInfo::gobj | ( |  | ) |

Provides access to the underlying C instance.

## ◆ gobj() [2/2]

const GDBusInterfaceInfo* Gio::DBus::InterfaceInfo::gobj | ( |  | ) | const

Provides access to the underlying C instance.

## ◆ gobj_copy()

GDBusInterfaceInfo* Gio::DBus::InterfaceInfo::gobj_copy | ( |  | ) | const

Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs.

## ◆ lookup_method() [1/2]

Glib::RefPtr<MethodInfo> Gio::DBus::InterfaceInfo::lookup_method | ( | const Glib::ustring& | name | ) |

Looks up information about a method.

The cost of this function is O(n) in number of methods unless g_dbus_interface_info_cache_build() has been used on info.

Since glibmm 2.26:

Parameters

  name | A D-Bus method name (typically in CamelCase).

Returns
  A DBusMethodInfo or `nullptr` if not found. Do not free, it is owned by info.

## ◆ lookup_method() [2/2]

Glib::RefPtr<const MethodInfo> Gio::DBus::InterfaceInfo::lookup_method | ( | const Glib::ustring& | name | ) | const

Looks up information about a method.

The cost of this function is O(n) in number of methods unless g_dbus_interface_info_cache_build() has been used on info.

Since glibmm 2.26:

Parameters

  name | A D-Bus method name (typically in CamelCase).

Returns
  A DBusMethodInfo or `nullptr` if not found. Do not free, it is owned by info.

## ◆ lookup_property() [1/2]

Glib::RefPtr<PropertyInfo> Gio::DBus::InterfaceInfo::lookup_property | ( | const Glib::ustring& | name | ) |

Looks up information about a property.

The cost of this function is O(n) in number of properties unless g_dbus_interface_info_cache_build() has been used on info.

Since glibmm 2.26:

Parameters

  name | A D-Bus property name (typically in CamelCase).

Returns
  A DBusPropertyInfo or `nullptr` if not found. Do not free, it is owned by info.

## ◆ lookup_property() [2/2]

Glib::RefPtr<const PropertyInfo> Gio::DBus::InterfaceInfo::lookup_property | ( | const Glib::ustring& | name | ) | const

Looks up information about a property.

The cost of this function is O(n) in number of properties unless g_dbus_interface_info_cache_build() has been used on info.

Since glibmm 2.26:

Parameters

  name | A D-Bus property name (typically in CamelCase).

Returns
  A DBusPropertyInfo or `nullptr` if not found. Do not free, it is owned by info.

## ◆ lookup_signal() [1/2]

Glib::RefPtr<SignalInfo> Gio::DBus::InterfaceInfo::lookup_signal | ( | const Glib::ustring& | name | ) |

Looks up information about a signal.

The cost of this function is O(n) in number of signals unless g_dbus_interface_info_cache_build() has been used on info.

Since glibmm 2.26:

Parameters

  name | A D-Bus signal name (typically in CamelCase).

Returns
  A DBusSignalInfo or `nullptr` if not found. Do not free, it is owned by info.

## ◆ lookup_signal() [2/2]

Glib::RefPtr<const SignalInfo> Gio::DBus::InterfaceInfo::lookup_signal | ( | const Glib::ustring& | name | ) | const

Looks up information about a signal.

The cost of this function is O(n) in number of signals unless g_dbus_interface_info_cache_build() has been used on info.

Since glibmm 2.26:

Parameters

  name | A D-Bus signal name (typically in CamelCase).

Returns
  A DBusSignalInfo or `nullptr` if not found. Do not free, it is owned by info.

## ◆ operator delete()

void Gio::DBus::InterfaceInfo::operator delete | ( | void * | ,
|  | std::size_t |
| ) |  |
| protected

## ◆ operator=()

InterfaceInfo& Gio::DBus::InterfaceInfo::operator= | ( | const InterfaceInfo& |  | ) |
| delete

## ◆ reference()

void Gio::DBus::InterfaceInfo::reference | ( |  | ) | const

Increment the reference count for this object.

You should never need to do this manually - use the object via a RefPtr instead.

## ◆ unreference()

void Gio::DBus::InterfaceInfo::unreference | ( |  | ) | const

Decrement the reference count for this object.

You should never need to do this manually - use the object via a RefPtr instead.

## Friends And Related Function Documentation

## ◆ wrap()

Glib::RefPtr< Gio::DBus::InterfaceInfo > wrap | ( | GDBusInterfaceInfo * | object,
|  | bool | take_copy = `false`
| ) |  |
| related

A Glib::wrap() method for this object.

Parameters

  object | The C instance.
  take_copy | False if the result should take ownership of the C instance. True if it should take a new copy or ref.

Returns
  A C++ instance that wraps this C instance.