Copyright | Will Thompson and Iñaki García Etxebarria |
---|---|
License | LGPL-2.1 |
Maintainer | Iñaki García Etxebarria |
Safe Haskell | None |
Language | Haskell2010 |
GI.Gio.Objects.DBusMessage
Contents
- Exported types
- Methods
- bytesNeeded
- copy
- getArg0
- getArg0Path
- getBody
- getByteOrder
- getDestination
- getErrorName
- getFlags
- getHeader
- getHeaderFields
- getInterface
- getLocked
- getMember
- getMessageType
- getNumUnixFds
- getPath
- getReplySerial
- getSender
- getSerial
- getSignature
- getUnixFdList
- lock
- new
- newFromBlob
- newMethodCall
- newMethodErrorLiteral
- newMethodReply
- newSignal
- setBody
- setByteOrder
- setDestination
- setErrorName
- setFlags
- setHeader
- setInterface
- setMember
- setMessageType
- setNumUnixFds
- setPath
- setReplySerial
- setSender
- setSerial
- setSignature
- setUnixFdList
- toBlob
- toGerror
- Properties
Description
A type for representing D-Bus messages that can be sent or received
on a DBusConnection
.
Since: 2.26
Synopsis
- newtype DBusMessage = DBusMessage (ManagedPtr DBusMessage)
- class (GObject o, IsDescendantOf DBusMessage o) => IsDBusMessage o
- toDBusMessage :: (MonadIO m, IsDBusMessage o) => o -> m DBusMessage
- type family ResolveDBusMessageMethod (t :: Symbol) o where ...
- dBusMessageBytesNeeded :: (HasCallStack, MonadIO m) => ByteString -> m Int64
- data DBusMessageCopyMethodInfo
- dBusMessageCopy :: (HasCallStack, MonadIO m, IsDBusMessage a) => a -> m DBusMessage
- data DBusMessageGetArg0MethodInfo
- dBusMessageGetArg0 :: (HasCallStack, MonadIO m, IsDBusMessage a) => a -> m (Maybe Text)
- data DBusMessageGetArg0PathMethodInfo
- dBusMessageGetArg0Path :: (HasCallStack, MonadIO m, IsDBusMessage a) => a -> m (Maybe Text)
- data DBusMessageGetBodyMethodInfo
- dBusMessageGetBody :: (HasCallStack, MonadIO m, IsDBusMessage a) => a -> m (Maybe GVariant)
- data DBusMessageGetByteOrderMethodInfo
- dBusMessageGetByteOrder :: (HasCallStack, MonadIO m, IsDBusMessage a) => a -> m DBusMessageByteOrder
- data DBusMessageGetDestinationMethodInfo
- dBusMessageGetDestination :: (HasCallStack, MonadIO m, IsDBusMessage a) => a -> m (Maybe Text)
- data DBusMessageGetErrorNameMethodInfo
- dBusMessageGetErrorName :: (HasCallStack, MonadIO m, IsDBusMessage a) => a -> m (Maybe Text)
- data DBusMessageGetFlagsMethodInfo
- dBusMessageGetFlags :: (HasCallStack, MonadIO m, IsDBusMessage a) => a -> m [DBusMessageFlags]
- data DBusMessageGetHeaderMethodInfo
- dBusMessageGetHeader :: (HasCallStack, MonadIO m, IsDBusMessage a) => a -> DBusMessageHeaderField -> m (Maybe GVariant)
- data DBusMessageGetHeaderFieldsMethodInfo
- dBusMessageGetHeaderFields :: (HasCallStack, MonadIO m, IsDBusMessage a) => a -> m ByteString
- data DBusMessageGetInterfaceMethodInfo
- dBusMessageGetInterface :: (HasCallStack, MonadIO m, IsDBusMessage a) => a -> m (Maybe Text)
- data DBusMessageGetLockedMethodInfo
- dBusMessageGetLocked :: (HasCallStack, MonadIO m, IsDBusMessage a) => a -> m Bool
- data DBusMessageGetMemberMethodInfo
- dBusMessageGetMember :: (HasCallStack, MonadIO m, IsDBusMessage a) => a -> m (Maybe Text)
- data DBusMessageGetMessageTypeMethodInfo
- dBusMessageGetMessageType :: (HasCallStack, MonadIO m, IsDBusMessage a) => a -> m DBusMessageType
- data DBusMessageGetNumUnixFdsMethodInfo
- dBusMessageGetNumUnixFds :: (HasCallStack, MonadIO m, IsDBusMessage a) => a -> m Word32
- data DBusMessageGetPathMethodInfo
- dBusMessageGetPath :: (HasCallStack, MonadIO m, IsDBusMessage a) => a -> m (Maybe Text)
- data DBusMessageGetReplySerialMethodInfo
- dBusMessageGetReplySerial :: (HasCallStack, MonadIO m, IsDBusMessage a) => a -> m Word32
- data DBusMessageGetSenderMethodInfo
- dBusMessageGetSender :: (HasCallStack, MonadIO m, IsDBusMessage a) => a -> m (Maybe Text)
- data DBusMessageGetSerialMethodInfo
- dBusMessageGetSerial :: (HasCallStack, MonadIO m, IsDBusMessage a) => a -> m Word32
- data DBusMessageGetSignatureMethodInfo
- dBusMessageGetSignature :: (HasCallStack, MonadIO m, IsDBusMessage a) => a -> m Text
- data DBusMessageGetUnixFdListMethodInfo
- dBusMessageGetUnixFdList :: (HasCallStack, MonadIO m, IsDBusMessage a) => a -> m (Maybe UnixFDList)
- data DBusMessageLockMethodInfo
- dBusMessageLock :: (HasCallStack, MonadIO m, IsDBusMessage a) => a -> m ()
- dBusMessageNew :: (HasCallStack, MonadIO m) => m DBusMessage
- dBusMessageNewFromBlob :: (HasCallStack, MonadIO m) => ByteString -> [DBusCapabilityFlags] -> m DBusMessage
- dBusMessageNewMethodCall :: (HasCallStack, MonadIO m) => Maybe Text -> Text -> Maybe Text -> Text -> m DBusMessage
- data DBusMessageNewMethodErrorLiteralMethodInfo
- dBusMessageNewMethodErrorLiteral :: (HasCallStack, MonadIO m, IsDBusMessage a) => a -> Text -> Text -> m DBusMessage
- data DBusMessageNewMethodReplyMethodInfo
- dBusMessageNewMethodReply :: (HasCallStack, MonadIO m, IsDBusMessage a) => a -> m DBusMessage
- dBusMessageNewSignal :: (HasCallStack, MonadIO m) => Text -> Text -> Text -> m DBusMessage
- data DBusMessagePrintMethodInfo
- dBusMessagePrint :: (HasCallStack, MonadIO m, IsDBusMessage a) => a -> Word32 -> m Text
- data DBusMessageSetBodyMethodInfo
- dBusMessageSetBody :: (HasCallStack, MonadIO m, IsDBusMessage a) => a -> GVariant -> m ()
- data DBusMessageSetByteOrderMethodInfo
- dBusMessageSetByteOrder :: (HasCallStack, MonadIO m, IsDBusMessage a) => a -> DBusMessageByteOrder -> m ()
- data DBusMessageSetDestinationMethodInfo
- dBusMessageSetDestination :: (HasCallStack, MonadIO m, IsDBusMessage a) => a -> Maybe Text -> m ()
- data DBusMessageSetErrorNameMethodInfo
- dBusMessageSetErrorName :: (HasCallStack, MonadIO m, IsDBusMessage a) => Maybe a -> Text -> m ()
- data DBusMessageSetFlagsMethodInfo
- dBusMessageSetFlags :: (HasCallStack, MonadIO m, IsDBusMessage a) => a -> [DBusMessageFlags] -> m ()
- data DBusMessageSetHeaderMethodInfo
- dBusMessageSetHeader :: (HasCallStack, MonadIO m, IsDBusMessage a) => a -> DBusMessageHeaderField -> Maybe GVariant -> m ()
- data DBusMessageSetInterfaceMethodInfo
- dBusMessageSetInterface :: (HasCallStack, MonadIO m, IsDBusMessage a) => a -> Maybe Text -> m ()
- data DBusMessageSetMemberMethodInfo
- dBusMessageSetMember :: (HasCallStack, MonadIO m, IsDBusMessage a) => a -> Maybe Text -> m ()
- data DBusMessageSetMessageTypeMethodInfo
- dBusMessageSetMessageType :: (HasCallStack, MonadIO m, IsDBusMessage a) => a -> DBusMessageType -> m ()
- data DBusMessageSetNumUnixFdsMethodInfo
- dBusMessageSetNumUnixFds :: (HasCallStack, MonadIO m, IsDBusMessage a) => a -> Word32 -> m ()
- data DBusMessageSetPathMethodInfo
- dBusMessageSetPath :: (HasCallStack, MonadIO m, IsDBusMessage a) => a -> Maybe Text -> m ()
- data DBusMessageSetReplySerialMethodInfo
- dBusMessageSetReplySerial :: (HasCallStack, MonadIO m, IsDBusMessage a) => a -> Word32 -> m ()
- data DBusMessageSetSenderMethodInfo
- dBusMessageSetSender :: (HasCallStack, MonadIO m, IsDBusMessage a) => a -> Maybe Text -> m ()
- data DBusMessageSetSerialMethodInfo
- dBusMessageSetSerial :: (HasCallStack, MonadIO m, IsDBusMessage a) => a -> Word32 -> m ()
- data DBusMessageSetSignatureMethodInfo
- dBusMessageSetSignature :: (HasCallStack, MonadIO m, IsDBusMessage a) => a -> Maybe Text -> m ()
- data DBusMessageSetUnixFdListMethodInfo
- dBusMessageSetUnixFdList :: (HasCallStack, MonadIO m, IsDBusMessage a, IsUnixFDList b) => a -> Maybe b -> m ()
- data DBusMessageToBlobMethodInfo
- dBusMessageToBlob :: (HasCallStack, MonadIO m, IsDBusMessage a) => a -> [DBusCapabilityFlags] -> m ByteString
- data DBusMessageToGerrorMethodInfo
- dBusMessageToGerror :: (HasCallStack, MonadIO m, IsDBusMessage a) => a -> m ()
- data DBusMessageLockedPropertyInfo
- dBusMessageLocked :: AttrLabelProxy "locked"
- getDBusMessageLocked :: (MonadIO m, IsDBusMessage o) => o -> m Bool
Exported types
newtype DBusMessage Source #
Memory-managed wrapper type.
Constructors
DBusMessage (ManagedPtr DBusMessage) |
Instances
class (GObject o, IsDescendantOf DBusMessage o) => IsDBusMessage o Source #
Type class for types which can be safely cast to DBusMessage
, for instance with toDBusMessage
.
Instances
(GObject o, IsDescendantOf DBusMessage o) => IsDBusMessage o Source # | |
Defined in GI.Gio.Objects.DBusMessage |
toDBusMessage :: (MonadIO m, IsDBusMessage o) => o -> m DBusMessage Source #
Cast to DBusMessage
, for types for which this is known to be safe. For general casts, use castTo
.
Methods
Click to display all available methods, including inherited ones
Methods
bindProperty, bindPropertyFull, copy, forceFloating, freezeNotify, getv, isFloating, lock, newMethodErrorLiteral, newMethodReply, notify, notifyByPspec, print, ref, refSink, runDispose, stealData, stealQdata, thawNotify, toBlob, toGerror, unref, watchClosure.
Getters
getArg0, getArg0Path, getBody, getByteOrder, getData, getDestination, getErrorName, getFlags, getHeader, getHeaderFields, getInterface, getLocked, getMember, getMessageType, getNumUnixFds, getPath, getProperty, getQdata, getReplySerial, getSender, getSerial, getSignature, getUnixFdList.
Setters
setBody, setByteOrder, setData, setDataFull, setDestination, setErrorName, setFlags, setHeader, setInterface, setMember, setMessageType, setNumUnixFds, setPath, setProperty, setReplySerial, setSender, setSerial, setSignature, setUnixFdList.
type family ResolveDBusMessageMethod (t :: Symbol) o where ... Source #
Equations
bytesNeeded
dBusMessageBytesNeeded Source #
Arguments
:: (HasCallStack, MonadIO m) | |
=> ByteString |
|
-> m Int64 | Returns: Number of bytes needed or -1 if |
Utility function to calculate how many bytes are needed to
completely deserialize the D-Bus message stored at blob
.
Since: 2.26
copy
data DBusMessageCopyMethodInfo Source #
Instances
(signature ~ m DBusMessage, MonadIO m, IsDBusMessage a) => OverloadedMethod DBusMessageCopyMethodInfo a signature Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods overloadedMethod :: a -> signature # | |
OverloadedMethodInfo DBusMessageCopyMethodInfo (a :: Type) Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods |
Arguments
:: (HasCallStack, MonadIO m, IsDBusMessage a) | |
=> a |
|
-> m DBusMessage | Returns: A new |
Copies message
. The copy is a deep copy and the returned
DBusMessage
is completely identical except that it is guaranteed
to not be locked.
This operation can fail if e.g. message
contains file descriptors
and the per-process or system-wide open files limit is reached.
Since: 2.26
getArg0
data DBusMessageGetArg0MethodInfo Source #
Instances
(signature ~ m (Maybe Text), MonadIO m, IsDBusMessage a) => OverloadedMethod DBusMessageGetArg0MethodInfo a signature Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods overloadedMethod :: a -> signature # | |
OverloadedMethodInfo DBusMessageGetArg0MethodInfo (a :: Type) Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods |
Arguments
:: (HasCallStack, MonadIO m, IsDBusMessage a) | |
=> a |
|
-> m (Maybe Text) | Returns: The string item or |
Convenience to get the first item in the body of message
.
See dBusMessageGetArg0Path
for returning object-path-typed
arg0 values.
Since: 2.26
getArg0Path
data DBusMessageGetArg0PathMethodInfo Source #
Instances
(signature ~ m (Maybe Text), MonadIO m, IsDBusMessage a) => OverloadedMethod DBusMessageGetArg0PathMethodInfo a signature Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods overloadedMethod :: a -> signature # | |
OverloadedMethodInfo DBusMessageGetArg0PathMethodInfo (a :: Type) Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods |
dBusMessageGetArg0Path Source #
Arguments
:: (HasCallStack, MonadIO m, IsDBusMessage a) | |
=> a |
|
-> m (Maybe Text) | Returns: The object path item or |
Convenience to get the first item in the body of message
.
See dBusMessageGetArg0
for returning string-typed arg0 values.
Since: 2.80
getBody
data DBusMessageGetBodyMethodInfo Source #
Instances
(signature ~ m (Maybe GVariant), MonadIO m, IsDBusMessage a) => OverloadedMethod DBusMessageGetBodyMethodInfo a signature Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods overloadedMethod :: a -> signature # | |
OverloadedMethodInfo DBusMessageGetBodyMethodInfo (a :: Type) Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods |
Arguments
:: (HasCallStack, MonadIO m, IsDBusMessage a) | |
=> a |
|
-> m (Maybe GVariant) | Returns: A |
Gets the body of a message.
Since: 2.26
getByteOrder
data DBusMessageGetByteOrderMethodInfo Source #
Instances
(signature ~ m DBusMessageByteOrder, MonadIO m, IsDBusMessage a) => OverloadedMethod DBusMessageGetByteOrderMethodInfo a signature Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods overloadedMethod :: a -> signature # | |
OverloadedMethodInfo DBusMessageGetByteOrderMethodInfo (a :: Type) Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods |
dBusMessageGetByteOrder Source #
Arguments
:: (HasCallStack, MonadIO m, IsDBusMessage a) | |
=> a |
|
-> m DBusMessageByteOrder | Returns: The byte order. |
Gets the byte order of message
.
getDestination
data DBusMessageGetDestinationMethodInfo Source #
Instances
(signature ~ m (Maybe Text), MonadIO m, IsDBusMessage a) => OverloadedMethod DBusMessageGetDestinationMethodInfo a signature Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods overloadedMethod :: a -> signature # | |
OverloadedMethodInfo DBusMessageGetDestinationMethodInfo (a :: Type) Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods |
dBusMessageGetDestination Source #
Arguments
:: (HasCallStack, MonadIO m, IsDBusMessage a) | |
=> a |
|
-> m (Maybe Text) | Returns: The value. |
Convenience getter for the DBusMessageHeaderFieldDestination
header field.
Since: 2.26
getErrorName
data DBusMessageGetErrorNameMethodInfo Source #
Instances
(signature ~ m (Maybe Text), MonadIO m, IsDBusMessage a) => OverloadedMethod DBusMessageGetErrorNameMethodInfo a signature Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods overloadedMethod :: a -> signature # | |
OverloadedMethodInfo DBusMessageGetErrorNameMethodInfo (a :: Type) Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods |
dBusMessageGetErrorName Source #
Arguments
:: (HasCallStack, MonadIO m, IsDBusMessage a) | |
=> a |
|
-> m (Maybe Text) | Returns: The value. |
Convenience getter for the DBusMessageHeaderFieldErrorName
header field.
Since: 2.26
getFlags
data DBusMessageGetFlagsMethodInfo Source #
Instances
(signature ~ m [DBusMessageFlags], MonadIO m, IsDBusMessage a) => OverloadedMethod DBusMessageGetFlagsMethodInfo a signature Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods overloadedMethod :: a -> signature # | |
OverloadedMethodInfo DBusMessageGetFlagsMethodInfo (a :: Type) Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods |
Arguments
:: (HasCallStack, MonadIO m, IsDBusMessage a) | |
=> a |
|
-> m [DBusMessageFlags] | Returns: Flags that are set (typically values from the |
Gets the flags for message
.
Since: 2.26
getHeader
data DBusMessageGetHeaderMethodInfo Source #
Instances
(signature ~ (DBusMessageHeaderField -> m (Maybe GVariant)), MonadIO m, IsDBusMessage a) => OverloadedMethod DBusMessageGetHeaderMethodInfo a signature Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods overloadedMethod :: a -> signature # | |
OverloadedMethodInfo DBusMessageGetHeaderMethodInfo (a :: Type) Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods |
Arguments
:: (HasCallStack, MonadIO m, IsDBusMessage a) | |
=> a |
|
-> DBusMessageHeaderField |
|
-> m (Maybe GVariant) | Returns: A |
Gets a header field on message
.
The caller is responsible for checking the type of the returned GVariant
matches what is expected.
Since: 2.26
getHeaderFields
data DBusMessageGetHeaderFieldsMethodInfo Source #
Instances
(signature ~ m ByteString, MonadIO m, IsDBusMessage a) => OverloadedMethod DBusMessageGetHeaderFieldsMethodInfo a signature Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods overloadedMethod :: a -> signature # | |
OverloadedMethodInfo DBusMessageGetHeaderFieldsMethodInfo (a :: Type) Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods |
dBusMessageGetHeaderFields Source #
Arguments
:: (HasCallStack, MonadIO m, IsDBusMessage a) | |
=> a |
|
-> m ByteString | Returns: An array of header fields
terminated by |
Gets an array of all header fields on message
that are set.
Since: 2.26
getInterface
data DBusMessageGetInterfaceMethodInfo Source #
Instances
(signature ~ m (Maybe Text), MonadIO m, IsDBusMessage a) => OverloadedMethod DBusMessageGetInterfaceMethodInfo a signature Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods overloadedMethod :: a -> signature # | |
OverloadedMethodInfo DBusMessageGetInterfaceMethodInfo (a :: Type) Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods |
dBusMessageGetInterface Source #
Arguments
:: (HasCallStack, MonadIO m, IsDBusMessage a) | |
=> a |
|
-> m (Maybe Text) | Returns: The value. |
Convenience getter for the DBusMessageHeaderFieldInterface
header field.
Since: 2.26
getLocked
data DBusMessageGetLockedMethodInfo Source #
Instances
(signature ~ m Bool, MonadIO m, IsDBusMessage a) => OverloadedMethod DBusMessageGetLockedMethodInfo a signature Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods overloadedMethod :: a -> signature # | |
OverloadedMethodInfo DBusMessageGetLockedMethodInfo (a :: Type) Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods |
Arguments
:: (HasCallStack, MonadIO m, IsDBusMessage a) | |
=> a |
|
-> m Bool |
Checks whether message
is locked. To monitor changes to this
value, conncet to the Object::notify signal to listen for changes
on the DBusMessage:locked property.
Since: 2.26
getMember
data DBusMessageGetMemberMethodInfo Source #
Instances
(signature ~ m (Maybe Text), MonadIO m, IsDBusMessage a) => OverloadedMethod DBusMessageGetMemberMethodInfo a signature Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods overloadedMethod :: a -> signature # | |
OverloadedMethodInfo DBusMessageGetMemberMethodInfo (a :: Type) Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods |
Arguments
:: (HasCallStack, MonadIO m, IsDBusMessage a) | |
=> a |
|
-> m (Maybe Text) | Returns: The value. |
Convenience getter for the DBusMessageHeaderFieldMember
header field.
Since: 2.26
getMessageType
data DBusMessageGetMessageTypeMethodInfo Source #
Instances
(signature ~ m DBusMessageType, MonadIO m, IsDBusMessage a) => OverloadedMethod DBusMessageGetMessageTypeMethodInfo a signature Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods overloadedMethod :: a -> signature # | |
OverloadedMethodInfo DBusMessageGetMessageTypeMethodInfo (a :: Type) Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods |
dBusMessageGetMessageType Source #
Arguments
:: (HasCallStack, MonadIO m, IsDBusMessage a) | |
=> a |
|
-> m DBusMessageType | Returns: A 8-bit unsigned integer (typically a value from the |
Gets the type of message
.
Since: 2.26
getNumUnixFds
data DBusMessageGetNumUnixFdsMethodInfo Source #
Instances
(signature ~ m Word32, MonadIO m, IsDBusMessage a) => OverloadedMethod DBusMessageGetNumUnixFdsMethodInfo a signature Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods overloadedMethod :: a -> signature # | |
OverloadedMethodInfo DBusMessageGetNumUnixFdsMethodInfo (a :: Type) Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods |
dBusMessageGetNumUnixFds Source #
Arguments
:: (HasCallStack, MonadIO m, IsDBusMessage a) | |
=> a |
|
-> m Word32 | Returns: The value. |
Convenience getter for the DBusMessageHeaderFieldNumUnixFds
header field.
Since: 2.26
getPath
data DBusMessageGetPathMethodInfo Source #
Instances
(signature ~ m (Maybe Text), MonadIO m, IsDBusMessage a) => OverloadedMethod DBusMessageGetPathMethodInfo a signature Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods overloadedMethod :: a -> signature # | |
OverloadedMethodInfo DBusMessageGetPathMethodInfo (a :: Type) Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods |
Arguments
:: (HasCallStack, MonadIO m, IsDBusMessage a) | |
=> a |
|
-> m (Maybe Text) | Returns: The value. |
Convenience getter for the DBusMessageHeaderFieldPath
header field.
Since: 2.26
getReplySerial
data DBusMessageGetReplySerialMethodInfo Source #
Instances
(signature ~ m Word32, MonadIO m, IsDBusMessage a) => OverloadedMethod DBusMessageGetReplySerialMethodInfo a signature Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods overloadedMethod :: a -> signature # | |
OverloadedMethodInfo DBusMessageGetReplySerialMethodInfo (a :: Type) Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods |
dBusMessageGetReplySerial Source #
Arguments
:: (HasCallStack, MonadIO m, IsDBusMessage a) | |
=> a |
|
-> m Word32 | Returns: The value. |
Convenience getter for the DBusMessageHeaderFieldReplySerial
header field.
Since: 2.26
getSender
data DBusMessageGetSenderMethodInfo Source #
Instances
(signature ~ m (Maybe Text), MonadIO m, IsDBusMessage a) => OverloadedMethod DBusMessageGetSenderMethodInfo a signature Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods overloadedMethod :: a -> signature # | |
OverloadedMethodInfo DBusMessageGetSenderMethodInfo (a :: Type) Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods |
Arguments
:: (HasCallStack, MonadIO m, IsDBusMessage a) | |
=> a |
|
-> m (Maybe Text) | Returns: The value. |
Convenience getter for the DBusMessageHeaderFieldSender
header field.
Since: 2.26
getSerial
data DBusMessageGetSerialMethodInfo Source #
Instances
(signature ~ m Word32, MonadIO m, IsDBusMessage a) => OverloadedMethod DBusMessageGetSerialMethodInfo a signature Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods overloadedMethod :: a -> signature # | |
OverloadedMethodInfo DBusMessageGetSerialMethodInfo (a :: Type) Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods |
Arguments
:: (HasCallStack, MonadIO m, IsDBusMessage a) | |
=> a |
|
-> m Word32 | Returns: A |
Gets the serial for message
.
Since: 2.26
getSignature
data DBusMessageGetSignatureMethodInfo Source #
Instances
(signature ~ m Text, MonadIO m, IsDBusMessage a) => OverloadedMethod DBusMessageGetSignatureMethodInfo a signature Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods overloadedMethod :: a -> signature # | |
OverloadedMethodInfo DBusMessageGetSignatureMethodInfo (a :: Type) Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods |
dBusMessageGetSignature Source #
Arguments
:: (HasCallStack, MonadIO m, IsDBusMessage a) | |
=> a |
|
-> m Text | Returns: The value. |
Convenience getter for the DBusMessageHeaderFieldSignature
header field.
This will always be non-Nothing
, but may be an empty string.
Since: 2.26
getUnixFdList
data DBusMessageGetUnixFdListMethodInfo Source #
Instances
(signature ~ m (Maybe UnixFDList), MonadIO m, IsDBusMessage a) => OverloadedMethod DBusMessageGetUnixFdListMethodInfo a signature Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods overloadedMethod :: a -> signature # | |
OverloadedMethodInfo DBusMessageGetUnixFdListMethodInfo (a :: Type) Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods |
dBusMessageGetUnixFdList Source #
Arguments
:: (HasCallStack, MonadIO m, IsDBusMessage a) | |
=> a |
|
-> m (Maybe UnixFDList) | Returns: A |
Gets the UNIX file descriptors associated with message
, if any.
This method is only available on UNIX.
The file descriptors normally correspond to G_VARIANT_TYPE_HANDLE
values in the body of the message. For example,
if variantGetHandle
returns 5, that is intended to be a reference
to the file descriptor that can be accessed by
g_unix_fd_list_get (list, 5, ...)
.
Since: 2.26
lock
data DBusMessageLockMethodInfo Source #
Instances
(signature ~ m (), MonadIO m, IsDBusMessage a) => OverloadedMethod DBusMessageLockMethodInfo a signature Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods overloadedMethod :: a -> signature # | |
OverloadedMethodInfo DBusMessageLockMethodInfo (a :: Type) Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods |
Arguments
:: (HasCallStack, MonadIO m, IsDBusMessage a) | |
=> a |
|
-> m () |
If message
is locked, does nothing. Otherwise locks the message.
Since: 2.26
new
Arguments
:: (HasCallStack, MonadIO m) | |
=> m DBusMessage | Returns: A |
Creates a new empty DBusMessage
.
Since: 2.26
newFromBlob
dBusMessageNewFromBlob Source #
Arguments
:: (HasCallStack, MonadIO m) | |
=> ByteString |
|
-> [DBusCapabilityFlags] |
|
-> m DBusMessage | Returns: A new |
Creates a new DBusMessage
from the data stored at blob
. The byte
order that the message was in can be retrieved using
dBusMessageGetByteOrder
.
If the blob
cannot be parsed, contains invalid fields, or contains invalid
headers, IOErrorEnumInvalidArgument
will be returned.
Since: 2.26
newMethodCall
dBusMessageNewMethodCall Source #
Arguments
:: (HasCallStack, MonadIO m) | |
=> Maybe Text |
|
-> Text |
|
-> Maybe Text |
|
-> Text |
|
-> m DBusMessage | Returns: A |
Creates a new DBusMessage
for a method call.
Since: 2.26
newMethodErrorLiteral
data DBusMessageNewMethodErrorLiteralMethodInfo Source #
Instances
(signature ~ (Text -> Text -> m DBusMessage), MonadIO m, IsDBusMessage a) => OverloadedMethod DBusMessageNewMethodErrorLiteralMethodInfo a signature Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods overloadedMethod :: a -> signature # | |
OverloadedMethodInfo DBusMessageNewMethodErrorLiteralMethodInfo (a :: Type) Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods |
dBusMessageNewMethodErrorLiteral Source #
Arguments
:: (HasCallStack, MonadIO m, IsDBusMessage a) | |
=> a |
|
-> Text |
|
-> Text |
|
-> m DBusMessage | Returns: A |
Creates a new DBusMessage
that is an error reply to methodCallMessage
.
Since: 2.26
newMethodReply
data DBusMessageNewMethodReplyMethodInfo Source #
Instances
(signature ~ m DBusMessage, MonadIO m, IsDBusMessage a) => OverloadedMethod DBusMessageNewMethodReplyMethodInfo a signature Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods overloadedMethod :: a -> signature # | |
OverloadedMethodInfo DBusMessageNewMethodReplyMethodInfo (a :: Type) Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods |
dBusMessageNewMethodReply Source #
Arguments
:: (HasCallStack, MonadIO m, IsDBusMessage a) | |
=> a |
|
-> m DBusMessage | Returns: |
Creates a new DBusMessage
that is a reply to methodCallMessage
.
Since: 2.26
newSignal
Arguments
:: (HasCallStack, MonadIO m) | |
=> Text |
|
-> Text |
|
-> Text |
|
-> m DBusMessage | Returns: A |
Creates a new DBusMessage
for a signal emission.
Since: 2.26
data DBusMessagePrintMethodInfo Source #
Instances
(signature ~ (Word32 -> m Text), MonadIO m, IsDBusMessage a) => OverloadedMethod DBusMessagePrintMethodInfo a signature Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods overloadedMethod :: a -> signature # | |
OverloadedMethodInfo DBusMessagePrintMethodInfo (a :: Type) Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods |
Arguments
:: (HasCallStack, MonadIO m, IsDBusMessage a) | |
=> a |
|
-> Word32 |
|
-> m Text | Returns: A string that should be freed with |
Produces a human-readable multi-line description of message
.
The contents of the description has no ABI guarantees, the contents and formatting is subject to change at any time. Typical output looks something like this:
Flags: none Version: 0 Serial: 4 Headers: path -> objectpath '/org/gtk/GDBus/TestObject' interface -> 'org.gtk.GDBus.TestInterface' member -> 'GimmeStdout' destination -> ':1.146' Body: () UNIX File Descriptors: (none)
or
Flags: no-reply-expected Version: 0 Serial: 477 Headers: reply-serial -> uint32 4 destination -> ':1.159' sender -> ':1.146' num-unix-fds -> uint32 1 Body: () UNIX File Descriptors: fd 12: dev=0:10,mode=020620,ino=5,uid=500,gid=5,rdev=136:2,size=0,atime=1273085037,mtime=1273085851,ctime=1272982635
Since: 2.26
setBody
data DBusMessageSetBodyMethodInfo Source #
Instances
(signature ~ (GVariant -> m ()), MonadIO m, IsDBusMessage a) => OverloadedMethod DBusMessageSetBodyMethodInfo a signature Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods overloadedMethod :: a -> signature # | |
OverloadedMethodInfo DBusMessageSetBodyMethodInfo (a :: Type) Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods |
Arguments
:: (HasCallStack, MonadIO m, IsDBusMessage a) | |
=> a |
|
-> GVariant | |
-> m () |
Sets the body message
. As a side-effect the
DBusMessageHeaderFieldSignature
header field is set to the
type string of body
(or cleared if body
is Nothing
).
If body
is floating, message
assumes ownership of body
.
Since: 2.26
setByteOrder
data DBusMessageSetByteOrderMethodInfo Source #
Instances
(signature ~ (DBusMessageByteOrder -> m ()), MonadIO m, IsDBusMessage a) => OverloadedMethod DBusMessageSetByteOrderMethodInfo a signature Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods overloadedMethod :: a -> signature # | |
OverloadedMethodInfo DBusMessageSetByteOrderMethodInfo (a :: Type) Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods |
dBusMessageSetByteOrder Source #
Arguments
:: (HasCallStack, MonadIO m, IsDBusMessage a) | |
=> a |
|
-> DBusMessageByteOrder |
|
-> m () |
Sets the byte order of message
.
setDestination
data DBusMessageSetDestinationMethodInfo Source #
Instances
(signature ~ (Maybe Text -> m ()), MonadIO m, IsDBusMessage a) => OverloadedMethod DBusMessageSetDestinationMethodInfo a signature Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods overloadedMethod :: a -> signature # | |
OverloadedMethodInfo DBusMessageSetDestinationMethodInfo (a :: Type) Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods |
dBusMessageSetDestination Source #
Arguments
:: (HasCallStack, MonadIO m, IsDBusMessage a) | |
=> a |
|
-> Maybe Text |
|
-> m () |
Convenience setter for the DBusMessageHeaderFieldDestination
header field.
Since: 2.26
setErrorName
data DBusMessageSetErrorNameMethodInfo Source #
Instances
(signature ~ (Text -> m ()), MonadIO m, IsDBusMessage a) => OverloadedMethod DBusMessageSetErrorNameMethodInfo a signature Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods overloadedMethod :: a -> signature # | |
OverloadedMethodInfo DBusMessageSetErrorNameMethodInfo (a :: Type) Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods |
dBusMessageSetErrorName Source #
Arguments
:: (HasCallStack, MonadIO m, IsDBusMessage a) | |
=> Maybe a |
|
-> Text |
|
-> m () |
Convenience setter for the DBusMessageHeaderFieldErrorName
header field.
Since: 2.26
setFlags
data DBusMessageSetFlagsMethodInfo Source #
Instances
(signature ~ ([DBusMessageFlags] -> m ()), MonadIO m, IsDBusMessage a) => OverloadedMethod DBusMessageSetFlagsMethodInfo a signature Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods overloadedMethod :: a -> signature # | |
OverloadedMethodInfo DBusMessageSetFlagsMethodInfo (a :: Type) Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods |
Arguments
:: (HasCallStack, MonadIO m, IsDBusMessage a) | |
=> a |
|
-> [DBusMessageFlags] |
|
-> m () |
Sets the flags to set on message
.
Since: 2.26
setHeader
data DBusMessageSetHeaderMethodInfo Source #
Instances
(signature ~ (DBusMessageHeaderField -> Maybe GVariant -> m ()), MonadIO m, IsDBusMessage a) => OverloadedMethod DBusMessageSetHeaderMethodInfo a signature Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods overloadedMethod :: a -> signature # | |
OverloadedMethodInfo DBusMessageSetHeaderMethodInfo (a :: Type) Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods |
Arguments
:: (HasCallStack, MonadIO m, IsDBusMessage a) | |
=> a |
|
-> DBusMessageHeaderField |
|
-> Maybe GVariant |
|
-> m () |
Sets a header field on message
.
If value
is floating, message
assumes ownership of value
.
Since: 2.26
setInterface
data DBusMessageSetInterfaceMethodInfo Source #
Instances
(signature ~ (Maybe Text -> m ()), MonadIO m, IsDBusMessage a) => OverloadedMethod DBusMessageSetInterfaceMethodInfo a signature Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods overloadedMethod :: a -> signature # | |
OverloadedMethodInfo DBusMessageSetInterfaceMethodInfo (a :: Type) Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods |
dBusMessageSetInterface Source #
Arguments
:: (HasCallStack, MonadIO m, IsDBusMessage a) | |
=> a |
|
-> Maybe Text |
|
-> m () |
Convenience setter for the DBusMessageHeaderFieldInterface
header field.
Since: 2.26
setMember
data DBusMessageSetMemberMethodInfo Source #
Instances
(signature ~ (Maybe Text -> m ()), MonadIO m, IsDBusMessage a) => OverloadedMethod DBusMessageSetMemberMethodInfo a signature Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods overloadedMethod :: a -> signature # | |
OverloadedMethodInfo DBusMessageSetMemberMethodInfo (a :: Type) Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods |
Arguments
:: (HasCallStack, MonadIO m, IsDBusMessage a) | |
=> a |
|
-> Maybe Text |
|
-> m () |
Convenience setter for the DBusMessageHeaderFieldMember
header field.
Since: 2.26
setMessageType
data DBusMessageSetMessageTypeMethodInfo Source #
Instances
(signature ~ (DBusMessageType -> m ()), MonadIO m, IsDBusMessage a) => OverloadedMethod DBusMessageSetMessageTypeMethodInfo a signature Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods overloadedMethod :: a -> signature # | |
OverloadedMethodInfo DBusMessageSetMessageTypeMethodInfo (a :: Type) Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods |
dBusMessageSetMessageType Source #
Arguments
:: (HasCallStack, MonadIO m, IsDBusMessage a) | |
=> a |
|
-> DBusMessageType |
|
-> m () |
Sets message
to be of type
.
Since: 2.26
setNumUnixFds
data DBusMessageSetNumUnixFdsMethodInfo Source #
Instances
(signature ~ (Word32 -> m ()), MonadIO m, IsDBusMessage a) => OverloadedMethod DBusMessageSetNumUnixFdsMethodInfo a signature Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods overloadedMethod :: a -> signature # | |
OverloadedMethodInfo DBusMessageSetNumUnixFdsMethodInfo (a :: Type) Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods |
dBusMessageSetNumUnixFds Source #
Arguments
:: (HasCallStack, MonadIO m, IsDBusMessage a) | |
=> a |
|
-> Word32 |
|
-> m () |
Convenience setter for the DBusMessageHeaderFieldNumUnixFds
header field.
Since: 2.26
setPath
data DBusMessageSetPathMethodInfo Source #
Instances
(signature ~ (Maybe Text -> m ()), MonadIO m, IsDBusMessage a) => OverloadedMethod DBusMessageSetPathMethodInfo a signature Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods overloadedMethod :: a -> signature # | |
OverloadedMethodInfo DBusMessageSetPathMethodInfo (a :: Type) Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods |
Arguments
:: (HasCallStack, MonadIO m, IsDBusMessage a) | |
=> a |
|
-> Maybe Text |
|
-> m () |
Convenience setter for the DBusMessageHeaderFieldPath
header field.
Since: 2.26
setReplySerial
data DBusMessageSetReplySerialMethodInfo Source #
Instances
(signature ~ (Word32 -> m ()), MonadIO m, IsDBusMessage a) => OverloadedMethod DBusMessageSetReplySerialMethodInfo a signature Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods overloadedMethod :: a -> signature # | |
OverloadedMethodInfo DBusMessageSetReplySerialMethodInfo (a :: Type) Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods |
dBusMessageSetReplySerial Source #
Arguments
:: (HasCallStack, MonadIO m, IsDBusMessage a) | |
=> a |
|
-> Word32 |
|
-> m () |
Convenience setter for the DBusMessageHeaderFieldReplySerial
header field.
Since: 2.26
setSender
data DBusMessageSetSenderMethodInfo Source #
Instances
(signature ~ (Maybe Text -> m ()), MonadIO m, IsDBusMessage a) => OverloadedMethod DBusMessageSetSenderMethodInfo a signature Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods overloadedMethod :: a -> signature # | |
OverloadedMethodInfo DBusMessageSetSenderMethodInfo (a :: Type) Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods |
Arguments
:: (HasCallStack, MonadIO m, IsDBusMessage a) | |
=> a |
|
-> Maybe Text |
|
-> m () |
Convenience setter for the DBusMessageHeaderFieldSender
header field.
Since: 2.26
setSerial
data DBusMessageSetSerialMethodInfo Source #
Instances
(signature ~ (Word32 -> m ()), MonadIO m, IsDBusMessage a) => OverloadedMethod DBusMessageSetSerialMethodInfo a signature Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods overloadedMethod :: a -> signature # | |
OverloadedMethodInfo DBusMessageSetSerialMethodInfo (a :: Type) Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods |
Arguments
:: (HasCallStack, MonadIO m, IsDBusMessage a) | |
=> a |
|
-> Word32 |
|
-> m () |
Sets the serial for message
.
The D-Bus specification
does not allow the serial
to be zero.
Since: 2.26
setSignature
data DBusMessageSetSignatureMethodInfo Source #
Instances
(signature ~ (Maybe Text -> m ()), MonadIO m, IsDBusMessage a) => OverloadedMethod DBusMessageSetSignatureMethodInfo a signature Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods overloadedMethod :: a -> signature # | |
OverloadedMethodInfo DBusMessageSetSignatureMethodInfo (a :: Type) Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods |
dBusMessageSetSignature Source #
Arguments
:: (HasCallStack, MonadIO m, IsDBusMessage a) | |
=> a |
|
-> Maybe Text |
|
-> m () |
Convenience setter for the DBusMessageHeaderFieldSignature
header field.
Since: 2.26
setUnixFdList
data DBusMessageSetUnixFdListMethodInfo Source #
Instances
(signature ~ (Maybe b -> m ()), MonadIO m, IsDBusMessage a, IsUnixFDList b) => OverloadedMethod DBusMessageSetUnixFdListMethodInfo a signature Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods overloadedMethod :: a -> signature # | |
OverloadedMethodInfo DBusMessageSetUnixFdListMethodInfo (a :: Type) Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods |
dBusMessageSetUnixFdList Source #
Arguments
:: (HasCallStack, MonadIO m, IsDBusMessage a, IsUnixFDList b) | |
=> a |
|
-> Maybe b |
|
-> m () |
Sets the UNIX file descriptors associated with message
. As a
side-effect the DBusMessageHeaderFieldNumUnixFds
header
field is set to the number of fds in fdList
(or cleared if
fdList
is Nothing
).
This method is only available on UNIX.
When designing D-Bus APIs that are intended to be interoperable,
please note that non-GDBus implementations of D-Bus can usually only
access file descriptors if they are referenced by a value of type
G_VARIANT_TYPE_HANDLE
in the body of the message.
Since: 2.26
toBlob
data DBusMessageToBlobMethodInfo Source #
Instances
(signature ~ ([DBusCapabilityFlags] -> m ByteString), MonadIO m, IsDBusMessage a) => OverloadedMethod DBusMessageToBlobMethodInfo a signature Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods overloadedMethod :: a -> signature # | |
OverloadedMethodInfo DBusMessageToBlobMethodInfo (a :: Type) Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods |
Arguments
:: (HasCallStack, MonadIO m, IsDBusMessage a) | |
=> a |
|
-> [DBusCapabilityFlags] |
|
-> m ByteString | Returns: A pointer to a
valid binary D-Bus message of |
Serializes message
to a blob. The byte order returned by
dBusMessageGetByteOrder
will be used.
Since: 2.26
toGerror
data DBusMessageToGerrorMethodInfo Source #
Instances
(signature ~ m (), MonadIO m, IsDBusMessage a) => OverloadedMethod DBusMessageToGerrorMethodInfo a signature Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods overloadedMethod :: a -> signature # | |
OverloadedMethodInfo DBusMessageToGerrorMethodInfo (a :: Type) Source # | |
Defined in GI.Gio.Objects.DBusMessage Methods |
Arguments
:: (HasCallStack, MonadIO m, IsDBusMessage a) | |
=> a |
|
-> m () | (Can throw |
If message
is not of type DBusMessageTypeError
does
nothing and returns False
.
Otherwise this method encodes the error in message
as a GError
using g_dbus_error_set_dbus_error()
using the information in the
DBusMessageHeaderFieldErrorName
header field of message
as
well as the first string item in message
's body.
Since: 2.26
Properties
locked
No description available in the introspection data.
data DBusMessageLockedPropertyInfo Source #
Instances
dBusMessageLocked :: AttrLabelProxy "locked" Source #
getDBusMessageLocked :: (MonadIO m, IsDBusMessage o) => o -> m Bool Source #
Get the value of the “locked
” property.
When overloading is enabled, this is equivalent to
get
dBusMessage #locked