Tizen Native API  4.0
Message

Functions

Eldbus_Messageeldbus_message_ref (Eldbus_Message *msg)
 Increase message reference.
void eldbus_message_unref (Eldbus_Message *msg)
 Decrease message reference.
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.
Eldbus_Messageeldbus_message_signal_new (const char *path, const char *interface, const char *name)
 Create a new signal message.
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.
Eldbus_Messageeldbus_message_method_return_new (const Eldbus_Message *msg)
 Create a message that is a reply to a method call.
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.
Eina_Bool eldbus_message_arguments_get (const Eldbus_Message *msg, const char *signature,...)
 Get the arguments from an Eldbus_Message.
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.
Eina_Bool eldbus_message_arguments_append (Eldbus_Message *msg, const char *signature,...)
 Append arguments into an Eldbus_Message.
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.

Function Documentation

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

Append arguments into an Eldbus_Message.

Deprecated:
Deprecated since 4.0.

Append arguments into an Eldbus_Message according to the param signature provided. For each complete type in param signature, a value 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 param msg.
Returns:
EINA_TRUE on success, EINA_FALSE otherwise.
Since :
3.0
Eina_Bool eldbus_message_arguments_get ( const Eldbus_Message msg,
const char *  signature,
  ... 
)

Get the arguments from an Eldbus_Message.

Deprecated:
Deprecated since 4.0.

Get the arguments of an Eldbus_Message storing them in the locations pointed to by the pointer arguments that follow param signature. Each pointer argument must be of a type that is appropriate for the correspondent complete type in param signature. For complex types such as arrays, structs, dictionaries or variants, a pointer to Eldbus_Message_Iter* must be provided.

Parameters:
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 successfully and stored in the respective pointer arguments.
Since :
3.0
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.

Deprecated:
Deprecated since 4.0.
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.
Since :
3.0
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.

Deprecated:
Deprecated since 4.0.
Parameters:
msgThe message to get the arguments from.
signatureThe signature user is expecting to read from param msg.
apThe va_list containing the pointer arguments.
See also:
eldbus_message_arguments_get()
Returns:
EINA_TRUE if the arguments were read successfully and stored in the respective pointer arguments.
Since :
3.0
const char* eldbus_message_destination_get ( const Eldbus_Message msg)
Deprecated:
Deprecated since 4.0. Get the Eldbus message destination.
Parameters:
msgThe Eldbus_Message object.
Returns:
A string containing the dbus message destination.
Since :
3.0
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.

Deprecated:
Deprecated since 4.0.

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.
Returns:
EINA_TRUE on success, else EINA_FALSE.
Since :
3.0
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.

Deprecated:
Deprecated since 4.0.
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()
Since :
3.0
const char* eldbus_message_interface_get ( const Eldbus_Message msg)
Deprecated:
Deprecated since 4.0. Get the Eldbus message interface.
Parameters:
msgThe Eldbus_Message object.
Returns:
A string containing the dbus message interface.
Since :
3.0
const char* eldbus_message_member_get ( const Eldbus_Message msg)
Deprecated:
Deprecated since 4.0. Get the Eldbus message member.
Parameters:
msgThe Eldbus_Message object.
Returns:
A string containing the dbus message member.
Since :
3.0
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.

Deprecated:
Deprecated since 4.0.
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()
Since :
3.0

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

Deprecated:
Deprecated since 4.0.
Parameters:
msgthe message we're replying to
Returns:
new Eldbus_Message, free with eldbus_message_unref()
Since :
3.0
const char* eldbus_message_path_get ( const Eldbus_Message msg)
Deprecated:
Deprecated since 4.0. Get the Eldbus message path.
Parameters:
msgThe Eldbus_Message object.
Returns:
A string containing the dbus message path.
Since :
3.0

Increase message reference.

Deprecated:
Deprecated since 4.0.
Parameters:
msgThe Eldbus_Message object.
Returns:
The previous Eldbus_Message with incremented refcount.
Since :
3.0
const char* eldbus_message_sender_get ( const Eldbus_Message msg)
Deprecated:
Deprecated since 4.0. Get the Eldbus message sender.
Parameters:
msgThe Eldbus_Message object.
Returns:
A string containing the dbus message sender.
Since :
3.0
Eldbus_Message* eldbus_message_signal_new ( const char *  path,
const char *  interface,
const char *  name 
)

Create a new signal message.

Deprecated:
Deprecated since 4.0.
Parameters:
pathobject path
ifaceinterface name
namename of the signal to be broadcasted
Returns:
a new Eldbus_Message, free with eldbus_message_unref()
Since (EFL) :
1.16
Since :
3.0
const char* eldbus_message_signature_get ( const Eldbus_Message msg)
Deprecated:
Deprecated since 4.0. Get the Eldbus message signature.
Parameters:
msgThe Eldbus_Message object.
Returns:
A string containing the dbus message signature.
Since :
3.0

Decrease message reference.

Deprecated:
Deprecated since 4.0.

When refcount reaches zero the message and all its resources will be freed.

Parameters:
msgThe Eldbus_Message object.
Since :
3.0