Modules

 Iterator
 
 Eina_Value to/from Message
 
 Message Helpers
 

Functions

Eldbus_Messageeldbus_message_ref (Eldbus_Message *msg)
 Increase message reference.
 
void eldbus_message_unref (Eldbus_Message *msg)
 Decrease message reference. More...
 
const char * eldbus_message_path_get (const Eldbus_Message *msg)
 
const char * eldbus_message_interface_get (const Eldbus_Message *msg)
 
const char * eldbus_message_member_get (const Eldbus_Message *msg)
 
const char * eldbus_message_destination_get (const Eldbus_Message *msg)
 
const char * eldbus_message_sender_get (const Eldbus_Message *msg)
 
const char * eldbus_message_signature_get (const Eldbus_Message *msg)
 
Eldbus_Messageeldbus_message_method_call_new (const char *dest, const char *path, const char *iface, const char *method)
 Create a new message to invoke a method on a remote object. More...
 
Eldbus_Messageeldbus_message_error_new (const Eldbus_Message *msg, const char *error_name, const char *error_msg)
 Create a new message that is an error reply to another message. More...
 
Eldbus_Messageeldbus_message_method_return_new (const Eldbus_Message *msg)
 Create a message that is a reply to a method call. More...
 
Eina_Bool eldbus_message_error_get (const Eldbus_Message *msg, const char **name, const char **text)
 Get the error text and name from a Eldbus_Message. More...
 
Eina_Bool eldbus_message_arguments_get (const Eldbus_Message *msg, const char *signature,...)
 Get the arguments from an Eldbus_Message. More...
 
Eina_Bool eldbus_message_arguments_vget (const Eldbus_Message *msg, const char *signature, va_list ap)
 Get the arguments from an Eldbus_Message using a va_list. More...
 
Eina_Bool eldbus_message_arguments_append (Eldbus_Message *msg, const char *signature,...)
 Append arguments into an Eldbus_Message. More...
 
Eina_Bool eldbus_message_arguments_vappend (Eldbus_Message *msg, const char *signature, va_list ap)
 Append arguments into an Eldbus_Message using a va_list. More...
 

Detailed Description

Function Documentation

void eldbus_message_unref ( Eldbus_Message msg)
Eldbus_Message* eldbus_message_method_call_new ( const char *  dest,
const char *  path,
const char *  iface,
const char *  method 
)

Create a new message to invoke a method on a remote object.

Parameters
destbus name or unique id of the remote application
pathobject path
ifaceinterface name
methodname of the method to be called
Returns
a new Eldbus_Message, free with eldbus_message_unref()

References EAPI, EINA_TRUE, and eldbus_message_unref().

Referenced by eldbus_object_signal_handler_add(), and eldbus_proxy_method_call_new().

Eldbus_Message* eldbus_message_error_new ( const Eldbus_Message msg,
const char *  error_name,
const char *  error_msg 
)

Create a new message that is an error reply to another message.

Parameters
msgthe message we're replying to
error_namethe error name
error_msgthe error message string
Returns
a new Eldbus_Message, free with eldbus_message_unref()

References EAPI, and EINA_FALSE.

Referenced by eldbus_connection_send(), and eldbus_service_object_unregister().

Eldbus_Message* eldbus_message_method_return_new ( const Eldbus_Message msg)

Create a message that is a reply to a method call.

Parameters
msgthe message we're replying to
Returns
new Eldbus_Message, free with eldbus_message_unref()

References EAPI, and EINA_TRUE.

Eina_Bool eldbus_message_error_get ( const Eldbus_Message msg,
const char **  name,
const char **  text 
)

Get the error text and name from a Eldbus_Message.

If

Parameters
msgis an error message return EINA_TRUE and fill in the name and text of the error.
msgThe message containing the error
nameVariable in which to store the error name or NULL if it's not desired.
textVariable in which to store the error text or NULL if it's not desired.

References EAPI, EINA_FALSE, EINA_TRUE, eldbus_message_iter_arguments_vget(), and eldbus_message_iter_get().

Referenced by eldbus_proxy_signal_handler_add(), eldbus_shutdown(), ethumb_client_ethumb_setup(), and ethumb_client_on_server_die_callback_set().

Eina_Bool eldbus_message_arguments_get ( const Eldbus_Message msg,
const char *  signature,
  ... 
)

Get the arguments from an Eldbus_Message.

Get the arguments of an Eldbus_Message storing them in the locations pointed to by the pointer arguments that follow

Parameters
signature.Each pointer argument must be of a type that is appropriate for the correspondent complete type in
signature.For complex types such as arrays, structs, dictionaries or variants, a pointer to Eldbus_Message_Iter* must be provided.
msgThe message to get the arguments from.
signatureThe signature of the arguments user is expecting to read from
msg
...The pointers in which to store the message arguments
Returns
EINA_TRUE if the arguments were read succesfully and stored in the respective pointer arguments.

References EAPI, and EINA_FALSE.

Referenced by eldbus_object_free_cb_del(), eldbus_proxy_free_cb_del(), eldbus_proxy_signal_handler_add(), eldbus_shutdown(), ethumb_client_ethumb_setup(), and ethumb_client_on_server_die_callback_set().

Eina_Bool eldbus_message_arguments_vget ( const Eldbus_Message msg,
const char *  signature,
va_list  ap 
)

Get the arguments from an Eldbus_Message using a va_list.

Parameters
msgThe message to get the arguments from.
signatureThe signature user is expecting to read from
msg.
apThe va_list containing the pointer arguments.
See also
eldbus_message_arguments_get()
Returns
EINA_TRUE if the arguments were read succesfully and stored in the respective pointer arguments.

References EAPI, EINA_FALSE, eina_inlist_append(), EINA_INLIST_GET, and EINA_TRUE.

Eina_Bool eldbus_message_arguments_append ( Eldbus_Message msg,
const char *  signature,
  ... 
)

Append arguments into an Eldbus_Message.

Append arguments into an Eldbus_Message according to the

Parameters
signatureprovided. For each complete type in
signature,avalue of the corresponding type must be provided.

This function supports only basic types. For complex types use eldbus_message_iter_* family of functions.

Parameters
msgThe message in which arguments are being appended.
signatureSignature of the arguments that are being appended.
...Values of each argument to append in
msg.
Returns
EINA_TRUE on success, EINA_FALSE otherwise.

References EAPI, and EINA_FALSE.

Eina_Bool eldbus_message_arguments_vappend ( Eldbus_Message msg,
const char *  signature,
va_list  ap 
)

Append arguments into an Eldbus_Message using a va_list.

Parameters
msgThe message in which arguments are being appended.
signatureSignature of the arguments that are being appended.
apThe va_list containing the arguments to append.
See also
eldbus_message_arguments_append().
Returns
EINA_TRUE on success, EINA_FALSE otherwise.

References EAPI, and EINA_FALSE.

Referenced by eldbus_proxy_method_call_new(), and eldbus_service_signal_emit().