Main Page   Modules   Data Structures   File List   Data Fields   Related Pages  

Address parsing
[D-BUS message system public API]

Parsing addresses of D-BUS servers. More...

Functions

void dbus_address_entries_free (DBusAddressEntry **entries)
 Frees a NULL-terminated array of address entries. More...

const char * dbus_address_entry_get_method (DBusAddressEntry *entry)
 Returns the method string of an address entry. More...

const char * dbus_address_entry_get_value (DBusAddressEntry *entry, const char *key)
 Returns a value from a key of an entry. More...

dbus_bool_t dbus_parse_address (const char *address, DBusAddressEntry ***entry, int *array_len, DBusError *error)
 Parses an address string of the form:. More...


Detailed Description

Parsing addresses of D-BUS servers.


Function Documentation

void dbus_address_entries_free DBusAddressEntry **    entries
 

Frees a NULL-terminated array of address entries.

Parameters:
entries  the array.

Definition at line 95 of file dbus-address.c.

const char* dbus_address_entry_get_method DBusAddressEntry   entry
 

Returns the method string of an address entry.

Parameters:
entry  the entry.
Returns:
a string describing the method. This string must not be freed.

Definition at line 131 of file dbus-address.c.

References DBusAddressEntry::method.

const char* dbus_address_entry_get_value DBusAddressEntry   entry,
const char *    key
 

Returns a value from a key of an entry.

Parameters:
entry  the entry.
key  the key.
Returns:
the key value. This string must not be fred.

Definition at line 144 of file dbus-address.c.

References DBusList::data, DBusAddressEntry::keys, and DBusAddressEntry::values.

dbus_bool_t dbus_parse_address const char *    address,
DBusAddressEntry ***    entry,
int *    array_len,
DBusError   error
 

Parses an address string of the form:.

method:key=value,key=value;method:key=value

Todo:
document address format in the specification

need to be able to escape ';' and ',' in the key values, and the parsing needs to handle that.

Parameters:
address  the address.
entry  return location to an array of entries.
array_len  return location for array length.
error  address where an error can be returned.
Returns:
TRUE on success, FALSE otherwise.

Definition at line 183 of file dbus-address.c.

References DBusList::data, DBusAddressEntry::keys, DBusAddressEntry::method, and DBusAddressEntry::values.


Generated on Wed Jun 9 05:01:27 2004 for D-BUS by doxygen1.2.15