mirror of
https://gitlab.freedesktop.org/dbus/dbus.git
synced 2026-05-03 21:48:24 +02:00
39ea37b587
We don't usually mass-remove trailing whitespace from the actual source code because it would complicate cherry-picking bug fixes to older branches, but that reasoning doesn't really apply to the comments containing copyright and licensing notices. Removing trailing whitespace makes it much easier to move code around: we have a commit hook that rejects commits containing trailing whitespace, but that commit hook counts moving a file as a delete + add pair, so it objects to moving code that contains trailing whitespace. Signed-off-by: Simon McVittie <smcv@collabora.com>
86 lines
2.7 KiB
C
86 lines
2.7 KiB
C
/* -*- mode: C; c-file-style: "gnu"; indent-tabs-mode: nil; -*- */
|
|
/* dbus-address.h Server address parser.
|
|
*
|
|
* Copyright (C) 2003 CodeFactory AB
|
|
*
|
|
* Licensed under the Academic Free License version 2.1
|
|
*
|
|
* This program is free software; you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation; either version 2 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with this program; if not, write to the Free Software
|
|
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
|
|
*
|
|
*/
|
|
#if !defined (DBUS_INSIDE_DBUS_H) && !defined (DBUS_COMPILATION)
|
|
#error "Only <dbus/dbus.h> can be included directly, this file may disappear or change contents."
|
|
#endif
|
|
|
|
#ifndef DBUS_ADDRESS_H
|
|
#define DBUS_ADDRESS_H
|
|
|
|
#include <dbus/dbus-types.h>
|
|
#include <dbus/dbus-errors.h>
|
|
|
|
DBUS_BEGIN_DECLS
|
|
|
|
/**
|
|
* @addtogroup DBusAddress
|
|
* @{
|
|
*/
|
|
|
|
/** Opaque type representing one of the semicolon-separated items in an address */
|
|
typedef struct DBusAddressEntry DBusAddressEntry;
|
|
|
|
DBUS_EXPORT
|
|
dbus_bool_t dbus_parse_address (const char *address,
|
|
DBusAddressEntry ***entry_result,
|
|
int *array_len,
|
|
DBusError *error);
|
|
DBUS_EXPORT
|
|
const char *dbus_address_entry_get_value (DBusAddressEntry *entry,
|
|
const char *key);
|
|
DBUS_EXPORT
|
|
const char *dbus_address_entry_get_method (DBusAddressEntry *entry);
|
|
DBUS_EXPORT
|
|
void dbus_address_entries_free (DBusAddressEntry **entries);
|
|
|
|
DBUS_EXPORT
|
|
char* dbus_address_escape_value (const char *value);
|
|
DBUS_EXPORT
|
|
char* dbus_address_unescape_value (const char *value,
|
|
DBusError *error);
|
|
|
|
/**
|
|
* Clear a variable or struct member that contains an array of #DBusAddressEntry.
|
|
* If it does not contain #NULL, the entries that were previously
|
|
* there are freed with dbus_address_entries_free().
|
|
*
|
|
* This is similar to dbus_clear_connection(): see that function
|
|
* for more details.
|
|
*
|
|
* @param pointer_to_entries A pointer to a variable or struct member.
|
|
* pointer_to_entries must not be #NULL, but *pointer_to_entries
|
|
* may be #NULL.
|
|
*/
|
|
static inline void
|
|
dbus_clear_address_entries (DBusAddressEntry ***pointer_to_entries)
|
|
{
|
|
_dbus_clear_pointer_impl (DBusAddressEntry *, pointer_to_entries,
|
|
dbus_address_entries_free);
|
|
}
|
|
|
|
/** @} */
|
|
|
|
DBUS_END_DECLS
|
|
|
|
#endif /* DBUS_ADDRESS_H */
|
|
|