gi-gio-2.0.29: Gio bindings
CopyrightWill Thompson and Iñaki García Etxebarria
LicenseLGPL-2.1
MaintainerIñaki García Etxebarria
Safe HaskellSafe-Inferred
LanguageHaskell2010

GI.Gio.Structs.DBusInterfaceInfo

Description

Information about a D-Bus interface.

Since: 2.26

Synopsis

Exported types

newtype DBusInterfaceInfo Source #

Memory-managed wrapper type.

newZeroDBusInterfaceInfo :: MonadIO m => m DBusInterfaceInfo Source #

Construct a DBusInterfaceInfo struct initialized to zero.

Methods

Click to display all available methods, including inherited ones

Expand

Methods

cacheBuild, cacheRelease, generateXml, lookupMethod, lookupProperty, lookupSignal, ref, unref.

Getters

None.

Setters

None.

cacheBuild

dBusInterfaceInfoCacheBuild Source #

Arguments

:: (HasCallStack, MonadIO m) 
=> DBusInterfaceInfo

info: A DBusInterfaceInfo.

-> m () 

Builds a lookup-cache to speed up dBusInterfaceInfoLookupMethod, dBusInterfaceInfoLookupSignal and dBusInterfaceInfoLookupProperty.

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 dBusInterfaceInfoCacheRelease is called.

Since: 2.30

cacheRelease

dBusInterfaceInfoCacheRelease Source #

Arguments

:: (HasCallStack, MonadIO m) 
=> DBusInterfaceInfo

info: A GDBusInterfaceInfo

-> m () 

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

Since: 2.30

generateXml

dBusInterfaceInfoGenerateXml Source #

Arguments

:: (HasCallStack, MonadIO m) 
=> DBusInterfaceInfo

info: A DBusNodeInfo

-> Word32

indent: Indentation level.

-> String

stringBuilder: A String to to append XML data to.

-> m () 

Appends an XML representation of info (and its children) to stringBuilder.

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

Since: 2.26

lookupMethod

dBusInterfaceInfoLookupMethod Source #

Arguments

:: (HasCallStack, MonadIO m) 
=> DBusInterfaceInfo

info: A DBusInterfaceInfo.

-> Text

name: A D-Bus method name (typically in CamelCase)

-> m (Maybe DBusMethodInfo)

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

Looks up information about a method.

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

Since: 2.26

lookupProperty

dBusInterfaceInfoLookupProperty Source #

Arguments

:: (HasCallStack, MonadIO m) 
=> DBusInterfaceInfo

info: A DBusInterfaceInfo.

-> Text

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

-> m (Maybe DBusPropertyInfo)

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

Looks up information about a property.

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

Since: 2.26

lookupSignal

dBusInterfaceInfoLookupSignal Source #

Arguments

:: (HasCallStack, MonadIO m) 
=> DBusInterfaceInfo

info: A DBusInterfaceInfo.

-> Text

name: A D-Bus signal name (typically in CamelCase)

-> m (Maybe DBusSignalInfo)

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

Looks up information about a signal.

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

Since: 2.26

ref

dBusInterfaceInfoRef Source #

Arguments

:: (HasCallStack, MonadIO m) 
=> DBusInterfaceInfo

info: A DBusInterfaceInfo

-> m DBusInterfaceInfo

Returns: The same info.

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

Since: 2.26

unref

dBusInterfaceInfoUnref Source #

Arguments

:: (HasCallStack, MonadIO m) 
=> DBusInterfaceInfo

info: A DBusInterfaceInfo.

-> m () 

If info is statically allocated, does nothing. Otherwise decreases the reference count of info. When its reference count drops to 0, the memory used is freed.

Since: 2.26

Properties

annotations

A pointer to a Nothing-terminated array of pointers to DBusAnnotationInfo structures or Nothing if there are no annotations.

clearDBusInterfaceInfoAnnotations :: MonadIO m => DBusInterfaceInfo -> m () Source #

Set the value of the “annotations” field to Nothing. When overloading is enabled, this is equivalent to

clear #annotations

getDBusInterfaceInfoAnnotations :: MonadIO m => DBusInterfaceInfo -> m (Maybe [DBusAnnotationInfo]) Source #

Get the value of the “annotations” field. When overloading is enabled, this is equivalent to

get dBusInterfaceInfo #annotations

setDBusInterfaceInfoAnnotations :: MonadIO m => DBusInterfaceInfo -> Ptr (Ptr DBusAnnotationInfo) -> m () Source #

Set the value of the “annotations” field. When overloading is enabled, this is equivalent to

set dBusInterfaceInfo [ #annotations := value ]

methods

A pointer to a Nothing-terminated array of pointers to DBusMethodInfo structures or Nothing if there are no methods.

clearDBusInterfaceInfoMethods :: MonadIO m => DBusInterfaceInfo -> m () Source #

Set the value of the “methods” field to Nothing. When overloading is enabled, this is equivalent to

clear #methods

getDBusInterfaceInfoMethods :: MonadIO m => DBusInterfaceInfo -> m (Maybe [DBusMethodInfo]) Source #

Get the value of the “methods” field. When overloading is enabled, this is equivalent to

get dBusInterfaceInfo #methods

setDBusInterfaceInfoMethods :: MonadIO m => DBusInterfaceInfo -> Ptr (Ptr DBusMethodInfo) -> m () Source #

Set the value of the “methods” field. When overloading is enabled, this is equivalent to

set dBusInterfaceInfo [ #methods := value ]

name

The name of the D-Bus interface, e.g. "org.freedesktop.DBus.Properties".

clearDBusInterfaceInfoName :: MonadIO m => DBusInterfaceInfo -> m () Source #

Set the value of the “name” field to Nothing. When overloading is enabled, this is equivalent to

clear #name

getDBusInterfaceInfoName :: MonadIO m => DBusInterfaceInfo -> m (Maybe Text) Source #

Get the value of the “name” field. When overloading is enabled, this is equivalent to

get dBusInterfaceInfo #name

setDBusInterfaceInfoName :: MonadIO m => DBusInterfaceInfo -> CString -> m () Source #

Set the value of the “name” field. When overloading is enabled, this is equivalent to

set dBusInterfaceInfo [ #name := value ]

properties

A pointer to a Nothing-terminated array of pointers to DBusPropertyInfo structures or Nothing if there are no properties.

clearDBusInterfaceInfoProperties :: MonadIO m => DBusInterfaceInfo -> m () Source #

Set the value of the “properties” field to Nothing. When overloading is enabled, this is equivalent to

clear #properties

getDBusInterfaceInfoProperties :: MonadIO m => DBusInterfaceInfo -> m (Maybe [DBusPropertyInfo]) Source #

Get the value of the “properties” field. When overloading is enabled, this is equivalent to

get dBusInterfaceInfo #properties

setDBusInterfaceInfoProperties :: MonadIO m => DBusInterfaceInfo -> Ptr (Ptr DBusPropertyInfo) -> m () Source #

Set the value of the “properties” field. When overloading is enabled, this is equivalent to

set dBusInterfaceInfo [ #properties := value ]

refCount

The reference count or -1 if statically allocated.

getDBusInterfaceInfoRefCount :: MonadIO m => DBusInterfaceInfo -> m Int32 Source #

Get the value of the “ref_count” field. When overloading is enabled, this is equivalent to

get dBusInterfaceInfo #refCount

setDBusInterfaceInfoRefCount :: MonadIO m => DBusInterfaceInfo -> Int32 -> m () Source #

Set the value of the “ref_count” field. When overloading is enabled, this is equivalent to

set dBusInterfaceInfo [ #refCount := value ]

signals

A pointer to a Nothing-terminated array of pointers to DBusSignalInfo structures or Nothing if there are no signals.

clearDBusInterfaceInfoSignals :: MonadIO m => DBusInterfaceInfo -> m () Source #

Set the value of the “signals” field to Nothing. When overloading is enabled, this is equivalent to

clear #signals

getDBusInterfaceInfoSignals :: MonadIO m => DBusInterfaceInfo -> m (Maybe [DBusSignalInfo]) Source #

Get the value of the “signals” field. When overloading is enabled, this is equivalent to

get dBusInterfaceInfo #signals

setDBusInterfaceInfoSignals :: MonadIO m => DBusInterfaceInfo -> Ptr (Ptr DBusSignalInfo) -> m () Source #

Set the value of the “signals” field. When overloading is enabled, this is equivalent to

set dBusInterfaceInfo [ #signals := value ]