Functions
Eldbus_Message *	eldbus_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_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.
Eldbus_Message *	eldbus_message_signal_new (const char path, const char interface, const char *name)
	Create a new signal message.
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.
Eldbus_Message *	eldbus_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.

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:

msg	The message in which arguments are being appended.
signature	Signature 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

Examples:: complex-types-server.c, and server.c.

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 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:

msg	The message to get the arguments from.
signature	The 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

Examples:: banshee.c, client.c, complex-types-server.c, complex-types.c, connman-list-services.c, ofono-dial.c, and server.c.

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:

msg	The message in which arguments are being appended.
signature	Signature of the arguments that are being appended.
ap	The 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.

Parameters:

msg	The message to get the arguments from.
signature	The signature user is expecting to read from param msg.
ap	The 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 )

Get the Eldbus message destination.

Parameters:

msg	The 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.

If

Parameters:

msg	is an error message return EINA_TRUE and fill in the name and text of the error.
msg	The message containing the error
name	Variable in which to store the error name or `NULL` if it's not desired.
text	Variable 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

Examples:: banshee.c, client.c, complex-types-client-eina-value.c, complex-types-server.c, complex-types.c, connman-list-services.c, ofono-dial.c, and server.c.

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:

msg	the message we're replying to
error_name	the error name
error_msg	the error message string

Returns:: a new Eldbus_Message, free with eldbus_message_unref()

Since :: 3.0

Examples:: complex-types-server.c.

const char* eldbus_message_interface_get ( const Eldbus_Message * msg )

Get the Eldbus message interface.

Parameters:

msg	The Eldbus_Message object.

Returns:: A string containing the dbus message interface.

Since :: 3.0

const char* eldbus_message_member_get ( const Eldbus_Message * msg )

Get the Eldbus message member.

Parameters:

msg	The 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.

Parameters:

dest	bus name or unique id of the remote application
path	object path
iface	interface name
method	name of the method to be called

Returns:: a new Eldbus_Message, free with eldbus_message_unref()

Since :: 3.0

Eldbus_Message* eldbus_message_method_return_new ( const Eldbus_Message * msg )

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

Parameters:

msg	the message we're replying to

Returns:: new Eldbus_Message, free with eldbus_message_unref()

Since :: 3.0

Examples:: complex-types-server.c, and server.c.

const char* eldbus_message_path_get ( const Eldbus_Message * msg )

Get the Eldbus message path.

Parameters:

msg	The Eldbus_Message object.

Returns:: A string containing the dbus message path.

Since :: 3.0

Eldbus_Message* eldbus_message_ref ( Eldbus_Message * msg )

Increase message reference.

Parameters:

msg	The Eldbus_Message object.

Returns:: The previous Eldbus_Message with incremented refcount.

Since :: 3.0

const char* eldbus_message_sender_get ( const Eldbus_Message * msg )

Get the Eldbus message sender.

Parameters:

msg	The 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.

Parameters:

path	object path
iface	interface name
name	name 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 )

Get the Eldbus message signature.

Parameters:

msg	The Eldbus_Message object.

Returns:: A string containing the dbus message signature.

Since :: 3.0

void eldbus_message_unref ( Eldbus_Message * msg )

Decrease message reference.

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

Parameters:

msg	The Eldbus_Message object.

Since :: 3.0

Functions

Function Documentation