// This file was generated by gir (https://github.com/gtk-rs/gir)
// from gir-files (https://github.com/gtk-rs/gir-files)
// DO NOT EDIT

use crate::DBusMethodInfo;
use crate::DBusPropertyInfo;
use crate::DBusSignalInfo;
use glib::translate::*;

glib::wrapper! {
    /// Information about a D-Bus interface.
    #[derive(Debug, PartialEq, Eq, PartialOrd, Ord, Hash)]
    pub struct DBusInterfaceInfo(Shared<ffi::GDBusInterfaceInfo>);

    match fn {
        ref => |ptr| ffi::g_dbus_interface_info_ref(ptr),
        unref => |ptr| ffi::g_dbus_interface_info_unref(ptr),
        type_ => || ffi::g_dbus_interface_info_get_type(),
    }
}

impl DBusInterfaceInfo {
    /// 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.
    /// ## `indent`
    /// Indentation level.
    /// ## `string_builder`
    /// A [`glib::String`][crate::glib::String] to to append XML data to.
    #[doc(alias = "g_dbus_interface_info_generate_xml")]
    pub fn generate_xml(&self, indent: u32, string_builder: &mut glib::String) {
        unsafe {
            ffi::g_dbus_interface_info_generate_xml(
                self.to_glib_none().0,
                indent,
                string_builder.to_glib_none_mut().0,
            );
        }
    }

    /// 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 `self`.
    /// ## `name`
    /// A D-Bus method name (typically in CamelCase)
    ///
    /// # Returns
    ///
    /// A [`DBusMethodInfo`][crate::DBusMethodInfo] or [`None`] if not found. Do not free, it is owned by `self`.
    #[doc(alias = "g_dbus_interface_info_lookup_method")]
    pub fn lookup_method(&self, name: &str) -> Option<DBusMethodInfo> {
        unsafe {
            from_glib_none(ffi::g_dbus_interface_info_lookup_method(
                self.to_glib_none().0,
                name.to_glib_none().0,
            ))
        }
    }

    /// 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 `self`.
    /// ## `name`
    /// A D-Bus property name (typically in CamelCase).
    ///
    /// # Returns
    ///
    /// A [`DBusPropertyInfo`][crate::DBusPropertyInfo] or [`None`] if not found. Do not free, it is owned by `self`.
    #[doc(alias = "g_dbus_interface_info_lookup_property")]
    pub fn lookup_property(&self, name: &str) -> Option<DBusPropertyInfo> {
        unsafe {
            from_glib_none(ffi::g_dbus_interface_info_lookup_property(
                self.to_glib_none().0,
                name.to_glib_none().0,
            ))
        }
    }

    /// 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 `self`.
    /// ## `name`
    /// A D-Bus signal name (typically in CamelCase)
    ///
    /// # Returns
    ///
    /// A [`DBusSignalInfo`][crate::DBusSignalInfo] or [`None`] if not found. Do not free, it is owned by `self`.
    #[doc(alias = "g_dbus_interface_info_lookup_signal")]
    pub fn lookup_signal(&self, name: &str) -> Option<DBusSignalInfo> {
        unsafe {
            from_glib_none(ffi::g_dbus_interface_info_lookup_signal(
                self.to_glib_none().0,
                name.to_glib_none().0,
            ))
        }
    }
}