1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
|
/* -*- mode: C; c-file-style: "gnu" -*- */
/* dbus-internals.c random utility stuff (internal to D-BUS implementation)
*
* Copyright (C) 2002 Red Hat, Inc.
*
* Licensed under the Academic Free License version 1.2
*
* 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*
*/
#include "dbus-internals.h"
#include <stdio.h>
#include <stdarg.h>
/**
* @defgroup DBusInternals D-BUS internal implementation details
* @brief Documentation useful when developing or debugging D-BUS itself.
*
*/
/**
* @defgroup DBusInternalsUtils Utilities
* @ingroup DBusInternals
* @brief Utility functions (_dbus_assert(), _dbus_warn(), etc.)
* @{
*/
/**
* @def _dbus_assert
*
* Aborts with an error message if the condition is false.
*
* @param condition condition which must be true.
*/
/**
* @def _dbus_assert_not_reached
*
* Aborts with an error message if called.
* The given explanation will be printed.
*
* @param explanation explanation of what happened if the code was reached.
*/
/**
* @def _DBUS_N_ELEMENTS
*
* Computes the number of elements in a fixed-size array using
* sizeof().
*
* @param array the array to count elements in.
*/
/**
* @def _DBUS_POINTER_TO_INT
*
* Safely casts a void* to an integer; should only be used on void*
* that actually contain integers, for example one created with
* _DBUS_INT_TO_POINTER. Only guaranteed to preserve 32 bits.
* (i.e. it's used to store 32-bit ints in pointers, but
* can't be used to store 64-bit pointers in ints.)
*
* @param pointer pointer to extract an integer from.
*/
/**
* @def _DBUS_INT_TO_POINTER
*
* Safely stuffs an integer into a pointer, to be extracted later with
* _DBUS_POINTER_TO_INT. Only guaranteed to preserve 32 bits.
*
* @param integer the integer to stuff into a pointer.
*/
/**
* @def _DBUS_INT_MIN
*
* Minimum value of type "int"
*/
/**
* @def _DBUS_INT_MAX
*
* Maximum value of type "int"
*/
/**
* Prints a warning message to stderr.
*
* @param format printf-style format string.
*/
void
_dbus_warn (const char *format,
...)
{
/* FIXME not portable enough? */
va_list args;
va_start (args, format);
vfprintf (stderr, format, args);
va_end (args);
}
/**
* Duplicates a string. Result must be freed with
* dbus_free(). Returns #NULL if memory allocation fails.
* If the string to be duplicated is #NULL, returns #NULL.
*
* @param str string to duplicate.
* @returns newly-allocated copy.
*/
char*
_dbus_strdup (const char *str)
{
int len;
char *copy;
if (str == NULL)
return NULL;
len = strlen (str);
copy = dbus_malloc (len + 1);
if (copy == NULL)
return NULL;
memcpy (copy, str, len + 1);
return copy;
}
/** @} */
|
