1 /* -*- mode: C; c-file-style: "gnu" -*- */

     2 /* dbus-address.h  Server address parser.

     3  *

     4  * Copyright (C) 2003  CodeFactory AB

     5  * Portion Copyright © 2008 Nokia Corporation and/or its subsidiary(-ies). All rights reserved.

     6  * Licensed under the Academic Free License version 2.1

     7  * 

     8  * This program is free software; you can redistribute it and/or modify

     9  * it under the terms of the GNU General Public License as published by

    10  * the Free Software Foundation; either version 2 of the License, or

    11  * (at your option) any later version.

    12  *

    13  * This program is distributed in the hope that it will be useful,

    14  * but WITHOUT ANY WARRANTY; without even the implied warranty of

    15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

    16  * GNU General Public License for more details.

    17  * 

    18  * You should have received a copy of the GNU General Public License

    19  * along with this program; if not, write to the Free Software

    20  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

    21  *

    22  */

    23 #if !defined (DBUS_INSIDE_DBUS_H) && !defined (DBUS_COMPILATION)

    24 #error "Only <dbus/dbus.h> can be included directly, this file may disappear or change contents."

    25 #endif

    26 

    27 #ifndef DBUS_ADDRESS_H

    28 #define DBUS_ADDRESS_H

    29 

    30 #ifdef __SYMBIAN32__

    31 #include <dbus/dbus-types.h>

    32 #include <dbus/dbus-errors.h>

    33 #else

    34 #include "dbus/dbus-types.h"

    35 #include "dbus/dbus-errors.h"

    36 #endif

    37 

    38 DBUS_BEGIN_DECLS

    39 

    40 /**

    41  * @addtogroup DBusAddress

    42  * @{

    43  */

    44 

    45 /** Opaque type representing one of the semicolon-separated items in an address */

    46 typedef struct DBusAddressEntry DBusAddressEntry;

    47 

    48 #ifdef __SYMBIAN32__

    49 IMPORT_C

    50 #endif

    51 dbus_bool_t dbus_parse_address            (const char         *address,

    52 					   DBusAddressEntry ***entry,

    53 					   int                *array_len,

    54 					   DBusError          *error);

    55 #ifdef __SYMBIAN32__

    56 IMPORT_C

    57 #endif

    58 const char *dbus_address_entry_get_value  (DBusAddressEntry   *entry,

    59 					   const char         *key);

    60 #ifdef __SYMBIAN32__

    61 IMPORT_C

    62 #endif

    63 const char *dbus_address_entry_get_method (DBusAddressEntry   *entry);

    64 #ifdef __SYMBIAN32__

    65 IMPORT_C

    66 #endif

    67 void        dbus_address_entries_free     (DBusAddressEntry  **entries);

    68 

    69 #ifdef __SYMBIAN32__

    70 IMPORT_C

    71 #endif

    72 char* dbus_address_escape_value   (const char *value);

    73 #ifdef __SYMBIAN32__

    74 IMPORT_C

    75 #endif

    76 char* dbus_address_unescape_value (const char *value,

    77                                    DBusError  *error);

    78 

    79 /** @} */

    80 

    81 DBUS_END_DECLS

    82 

    83 #endif /* DBUS_ADDRESS_H */

    84