D-Bus: dbus-string.h Source File

D-Bus 1.12.2

dbus-string.h
1 /* -*- mode: C; c-file-style: "gnu"; indent-tabs-mode: nil; -*- */
2 /* dbus-string.h String utility class (internal to D-Bus implementation)
3 *
4 * Copyright (C) 2002, 2003 Red Hat, Inc.
5 * Copyright (C) 2006 Ralf Habacker <ralf.habacker@freenet.de>
6 *
7 * Licensed under the Academic Free License version 2.1
8 *
9 * This program is free software; you can redistribute it and/or modify
10 * it under the terms of the GNU General Public License as published by
11 * the Free Software Foundation; either version 2 of the License, or
12 * (at your option) any later version.
13 *
14 * This program is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 * GNU General Public License for more details.
18 *
19 * You should have received a copy of the GNU General Public License
20 * along with this program; if not, write to the Free Software
21 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
22 *
23 */
24
25 #ifndef DBUS_STRING_H
26 #define DBUS_STRING_H
27
28 #include <dbus/dbus-macros.h>
29 #include <dbus/dbus-types.h>
30 #include <dbus/dbus-memory.h>
31
32 #include <stdarg.h>
33
34 DBUS_BEGIN_DECLS
35
40 typedef struct DBusString DBusString;
41
42 struct DBusString
43 {
44 #if defined(DBUS_WIN) && defined(_DEBUG)
45 const char *dummy1;
46 #else
47 const void *dummy1;
48 #endif
49 int dummy2;
50 int dummy3;
51 unsigned int dummy_bit1 : 1;
52 unsigned int dummy_bit2 : 1;
53 unsigned int dummy_bit3 : 1;
54 unsigned int dummy_bits : 3;
55 };
56
57 #ifdef DBUS_DISABLE_ASSERT
58 /* Some simple inlining hacks; the current linker is not smart enough
59 * to inline non-exported symbols across files in the library.
60 * Note that these break type safety (due to the casts)
61 */
62 #define _dbus_string_get_data(s) ((char*)(((DBusString*)(s))->dummy1))
63 #define _dbus_string_get_length(s) (((DBusString*)(s))->dummy2)
64 #define _dbus_string_set_byte(s, i, b) ((((unsigned char*)(((DBusString*)(s))->dummy1))[(i)]) = (unsigned char) (b))
65 #define _dbus_string_get_byte(s, i) (((const unsigned char*)(((DBusString*)(s))->dummy1))[(i)])
66 #define _dbus_string_get_const_data(s) ((const char*)(((DBusString*)(s))->dummy1))
67 #define _dbus_string_get_const_data_len(s,start,len) (((const char*)(((DBusString*)(s))->dummy1)) + (start))
68 #endif
69
70 DBUS_PRIVATE_EXPORT
71 dbus_bool_t _dbus_string_init (DBusString *str);
72 DBUS_PRIVATE_EXPORT
73 void _dbus_string_init_const (DBusString *str,
74 const char *value);
75 DBUS_PRIVATE_EXPORT
76 void _dbus_string_init_const_len (DBusString *str,
77 const char *value,
78 int len);
79 dbus_bool_t _dbus_string_init_preallocated (DBusString *str,
80 int allocate_size);
81
82 DBUS_PRIVATE_EXPORT
83 dbus_bool_t _dbus_string_init_from_string (DBusString *str,
84 const DBusString *from);
85 DBUS_PRIVATE_EXPORT
86 void _dbus_string_free (DBusString *str);
87 void _dbus_string_lock (DBusString *str);
88 DBUS_PRIVATE_EXPORT
89 dbus_bool_t _dbus_string_compact (DBusString *str,
90 int max_waste);
91 #ifndef _dbus_string_get_data
92 DBUS_PRIVATE_EXPORT
93 char* _dbus_string_get_data (DBusString *str);
94 #endif /* _dbus_string_get_data */
95 #ifndef _dbus_string_get_const_data
96 DBUS_PRIVATE_EXPORT
97 const char* _dbus_string_get_const_data (const DBusString *str);
98 #endif /* _dbus_string_get_const_data */
99 char* _dbus_string_get_data_len (DBusString *str,
100 int start,
101 int len);
102 #ifndef _dbus_string_get_const_data_len
103 DBUS_PRIVATE_EXPORT
104 const char* _dbus_string_get_const_data_len (const DBusString *str,
105 int start,
106 int len);
107 #endif
108 #ifndef _dbus_string_set_byte
109 DBUS_PRIVATE_EXPORT
110 void _dbus_string_set_byte (DBusString *str,
111 int i,
112 unsigned char byte);
113 #endif
114 #ifndef _dbus_string_get_byte
115 DBUS_PRIVATE_EXPORT
116 unsigned char _dbus_string_get_byte (const DBusString *str,
117 int start);
118 #endif /* _dbus_string_get_byte */
119 DBUS_PRIVATE_EXPORT
120 dbus_bool_t _dbus_string_insert_bytes (DBusString *str,
121 int i,
122 int n_bytes,
123 unsigned char byte);
124 DBUS_PRIVATE_EXPORT
125 dbus_bool_t _dbus_string_insert_byte (DBusString *str,
126 int i,
127 unsigned char byte);
128 DBUS_PRIVATE_EXPORT
129 dbus_bool_t _dbus_string_steal_data (DBusString *str,
130 char **data_return);
131 dbus_bool_t _dbus_string_steal_data_len (DBusString *str,
132 char **data_return,
133 int start,
134 int len);
135 DBUS_PRIVATE_EXPORT
136 dbus_bool_t _dbus_string_copy_data (const DBusString *str,
137 char **data_return);
138 dbus_bool_t _dbus_string_copy_data_len (const DBusString *str,
139 char **data_return,
140 int start,
141 int len);
142 void _dbus_string_copy_to_buffer (const DBusString *str,
143 char *buffer,
144 int len);
145 DBUS_PRIVATE_EXPORT
146 void _dbus_string_copy_to_buffer_with_nul (const DBusString *str,
147 char *buffer,
148 int avail_len);
149 #ifndef _dbus_string_get_length
150 DBUS_PRIVATE_EXPORT
151 int _dbus_string_get_length (const DBusString *str);
152 #endif /* !_dbus_string_get_length */
153
164 static inline unsigned int
165 _dbus_string_get_length_uint (const DBusString *str)
166 {
167 return (unsigned int) _dbus_string_get_length (str);
168 }
169
170 DBUS_PRIVATE_EXPORT
171 dbus_bool_t _dbus_string_lengthen (DBusString *str,
172 int additional_length);
173 DBUS_PRIVATE_EXPORT
174 void _dbus_string_shorten (DBusString *str,
175 int length_to_remove);
176 DBUS_PRIVATE_EXPORT
177 dbus_bool_t _dbus_string_set_length (DBusString *str,
178 int length);
179 dbus_bool_t _dbus_string_align_length (DBusString *str,
180 int alignment);
181 dbus_bool_t _dbus_string_alloc_space (DBusString *str,
182 int extra_bytes);
183 DBUS_PRIVATE_EXPORT
184 dbus_bool_t _dbus_string_append (DBusString *str,
185 const char *buffer);
186 DBUS_PRIVATE_EXPORT
187 dbus_bool_t _dbus_string_append_len (DBusString *str,
188 const char *buffer,
189 int len);
190 DBUS_PRIVATE_EXPORT
191 dbus_bool_t _dbus_string_append_int (DBusString *str,
192 long value);
193 DBUS_PRIVATE_EXPORT
194 dbus_bool_t _dbus_string_append_uint (DBusString *str,
195 unsigned long value);
196 DBUS_PRIVATE_EXPORT
197 dbus_bool_t _dbus_string_append_byte (DBusString *str,
198 unsigned char byte);
199 DBUS_PRIVATE_EXPORT
200 dbus_bool_t _dbus_string_append_printf (DBusString *str,
201 const char *format,
202 ...) _DBUS_GNUC_PRINTF (2, 3);
203 DBUS_PRIVATE_EXPORT
204 dbus_bool_t _dbus_string_append_printf_valist (DBusString *str,
205 const char *format,
206 va_list args) _DBUS_GNUC_PRINTF (2, 0);
207 dbus_bool_t _dbus_string_insert_2_aligned (DBusString *str,
208 int insert_at,
209 const unsigned char octets[2]);
210 dbus_bool_t _dbus_string_insert_4_aligned (DBusString *str,
211 int insert_at,
212 const unsigned char octets[4]);
213 dbus_bool_t _dbus_string_insert_8_aligned (DBusString *str,
214 int insert_at,
215 const unsigned char octets[8]);
216 dbus_bool_t _dbus_string_insert_alignment (DBusString *str,
217 int *insert_at,
218 int alignment);
219 DBUS_PRIVATE_EXPORT
220 void _dbus_string_delete (DBusString *str,
221 int start,
222 int len);
223 DBUS_PRIVATE_EXPORT
224 dbus_bool_t _dbus_string_move (DBusString *source,
225 int start,
226 DBusString *dest,
227 int insert_at);
228 DBUS_PRIVATE_EXPORT
229 dbus_bool_t _dbus_string_copy (const DBusString *source,
230 int start,
231 DBusString *dest,
232 int insert_at);
233 dbus_bool_t _dbus_string_move_len (DBusString *source,
234 int start,
235 int len,
236 DBusString *dest,
237 int insert_at);
238 DBUS_PRIVATE_EXPORT
239 dbus_bool_t _dbus_string_copy_len (const DBusString *source,
240 int start,
241 int len,
242 DBusString *dest,
243 int insert_at);
244 DBUS_PRIVATE_EXPORT
245 dbus_bool_t _dbus_string_replace_len (const DBusString *source,
246 int start,
247 int len,
248 DBusString *dest,
249 int replace_at,
250 int replace_len);
251 DBUS_PRIVATE_EXPORT
252 dbus_bool_t _dbus_string_split_on_byte (DBusString *source,
253 unsigned char byte,
254 DBusString *tail);
255 DBUS_PRIVATE_EXPORT
256 dbus_bool_t _dbus_string_parse_int (const DBusString *str,
257 int start,
258 long *value_return,
259 int *end_return);
260 DBUS_PRIVATE_EXPORT
261 dbus_bool_t _dbus_string_parse_uint (const DBusString *str,
262 int start,
263 unsigned long *value_return,
264 int *end_return);
265 DBUS_PRIVATE_EXPORT
266 dbus_bool_t _dbus_string_find (const DBusString *str,
267 int start,
268 const char *substr,
269 int *found);
270 DBUS_PRIVATE_EXPORT
271 dbus_bool_t _dbus_string_find_eol (const DBusString *str,
272 int start,
273 int *found,
274 int *found_len);
275 DBUS_PRIVATE_EXPORT
276 dbus_bool_t _dbus_string_find_to (const DBusString *str,
277 int start,
278 int end,
279 const char *substr,
280 int *found);
281 dbus_bool_t _dbus_string_find_byte_backward (const DBusString *str,
282 int start,
283 unsigned char byte,
284 int *found);
285 DBUS_PRIVATE_EXPORT
286 dbus_bool_t _dbus_string_find_blank (const DBusString *str,
287 int start,
288 int *found);
289 DBUS_PRIVATE_EXPORT
290 void _dbus_string_skip_blank (const DBusString *str,
291 int start,
292 int *end);
293 DBUS_PRIVATE_EXPORT
294 void _dbus_string_skip_white (const DBusString *str,
295 int start,
296 int *end);
297 void _dbus_string_skip_white_reverse (const DBusString *str,
298 int end,
299 int *start);
300 DBUS_PRIVATE_EXPORT
301 dbus_bool_t _dbus_string_equal (const DBusString *a,
302 const DBusString *b);
303 DBUS_PRIVATE_EXPORT
304 dbus_bool_t _dbus_string_equal_c_str (const DBusString *a,
305 const char *c_str);
306 DBUS_PRIVATE_EXPORT
307 dbus_bool_t _dbus_string_equal_len (const DBusString *a,
308 const DBusString *b,
309 int len);
310 DBUS_PRIVATE_EXPORT
311 dbus_bool_t _dbus_string_equal_substring (const DBusString *a,
312 int a_start,
313 int a_len,
314 const DBusString *b,
315 int b_start);
316 DBUS_PRIVATE_EXPORT
317 dbus_bool_t _dbus_string_starts_with_c_str (const DBusString *a,
318 const char *c_str);
319 dbus_bool_t _dbus_string_ends_with_c_str (const DBusString *a,
320 const char *c_str);
321 DBUS_PRIVATE_EXPORT
322 dbus_bool_t _dbus_string_pop_line (DBusString *source,
323 DBusString *dest);
324 DBUS_PRIVATE_EXPORT
325 void _dbus_string_delete_first_word (DBusString *str);
326 DBUS_PRIVATE_EXPORT
327 void _dbus_string_delete_leading_blanks (DBusString *str);
328 DBUS_PRIVATE_EXPORT
329 void _dbus_string_chop_white (DBusString *str);
330 dbus_bool_t _dbus_string_append_byte_as_hex (DBusString *str,
331 unsigned char byte);
332 DBUS_PRIVATE_EXPORT
333 dbus_bool_t _dbus_string_hex_encode (const DBusString *source,
334 int start,
335 DBusString *dest,
336 int insert_at);
337 DBUS_PRIVATE_EXPORT
338 dbus_bool_t _dbus_string_hex_decode (const DBusString *source,
339 int start,
340 int *end_return,
341 DBusString *dest,
342 int insert_at);
343 DBUS_PRIVATE_EXPORT
344 void _dbus_string_tolower_ascii (const DBusString *str,
345 int start,
346 int len);
347 DBUS_PRIVATE_EXPORT
348 void _dbus_string_toupper_ascii (const DBusString *str,
349 int start,
350 int len);
351 dbus_bool_t _dbus_string_validate_ascii (const DBusString *str,
352 int start,
353 int len);
354 DBUS_PRIVATE_EXPORT
355 dbus_bool_t _dbus_string_validate_utf8 (const DBusString *str,
356 int start,
357 int len);
358 DBUS_PRIVATE_EXPORT
359 dbus_bool_t _dbus_string_validate_nul (const DBusString *str,
360 int start,
361 int len);
362 void _dbus_string_zero (DBusString *str);
363
364 static inline unsigned char *
365 _dbus_string_get_udata (DBusString *str)
366 {
367 return (unsigned char *) _dbus_string_get_data (str);
368 }
369
370 static inline unsigned char *
371 _dbus_string_get_udata_len (DBusString *str, int start, int len)
372 {
373 return (unsigned char *) _dbus_string_get_data_len (str, start, len);
374 }
375
376 static inline const unsigned char *
377 _dbus_string_get_const_udata (const DBusString *str)
378 {
379 return (const unsigned char *) _dbus_string_get_const_data (str);
380 }
381
382 static inline const unsigned char *
383 _dbus_string_get_const_udata_len (const DBusString *str, int start, int len)
384 {
385 return (const unsigned char *) _dbus_string_get_const_data_len (str, start, len);
386 }
387
393 #define _DBUS_STRING_ALLOCATION_PADDING 8
394
402 #define _DBUS_STRING_DEFINE_STATIC(name, str) \
403 static const char _dbus_static_string_##name[] = str; \
404 static const DBusString name = { _dbus_static_string_##name, \
405 sizeof(_dbus_static_string_##name), \
406 sizeof(_dbus_static_string_##name) + \
407 _DBUS_STRING_ALLOCATION_PADDING, \
408 TRUE, TRUE, FALSE, 0 }
409
410 DBUS_END_DECLS
411
412 #endif /* DBUS_STRING_H */
_dbus_string_insert_bytes
DBUS_PRIVATE_EXPORT dbus_bool_t _dbus_string_insert_bytes(DBusString *str, int i, int n_bytes, unsigned char byte)
Inserts a number of bytes of a given value at the given position.
Definition: dbus-string.c:584
_dbus_string_append
DBUS_PRIVATE_EXPORT dbus_bool_t _dbus_string_append(DBusString *str, const char *buffer)
Appends a nul-terminated C-style string to a DBusString.
Definition: dbus-string.c:935
_dbus_string_parse_int
DBUS_PRIVATE_EXPORT dbus_bool_t _dbus_string_parse_int(const DBusString *str, int start, long *value_return, int *end_return)
Parses an integer contained in a DBusString.
Definition: dbus-sysdeps.c:437
_dbus_string_copy_to_buffer
void _dbus_string_copy_to_buffer(const DBusString *str, char *buffer, int len)
Copies the contents of a DBusString into a different buffer.
Definition: dbus-string.c:697
DBusString::dummy1
const void * dummy1
placeholder
Definition: dbus-string.h:47
_dbus_string_append_uint
DBUS_PRIVATE_EXPORT dbus_bool_t _dbus_string_append_uint(DBusString *str, unsigned long value)
Appends an unsigned integer to a DBusString.
Definition: dbus-sysdeps.c:394
_dbus_string_equal
DBUS_PRIVATE_EXPORT dbus_bool_t _dbus_string_equal(const DBusString *a, const DBusString *b)
Tests two DBusString for equality.
Definition: dbus-string.c:2013
_dbus_string_find_eol
DBUS_PRIVATE_EXPORT dbus_bool_t _dbus_string_find_eol(const DBusString *str, int start, int *found, int *found_len)
Finds end of line ("\r\n" or "\n") in the string, returning TRUE and filling in the byte index where ...
Definition: dbus-string.c:1627
_dbus_string_lengthen
DBUS_PRIVATE_EXPORT dbus_bool_t _dbus_string_lengthen(DBusString *str, int additional_length)
Makes a string longer by the given number of bytes.
Definition: dbus-string.c:760
DBusString::dummy_bits
unsigned int dummy_bits
placeholder
Definition: dbus-string.h:54
_dbus_string_copy_to_buffer_with_nul
DBUS_PRIVATE_EXPORT void _dbus_string_copy_to_buffer_with_nul(const DBusString *str, char *buffer, int avail_len)
Copies the contents of a DBusString into a different buffer.
Definition: dbus-string.c:719
DBUS_BEGIN_DECLS
#define DBUS_BEGIN_DECLS
Macro used prior to declaring functions in the D-Bus header files.
_dbus_string_hex_encode
DBUS_PRIVATE_EXPORT dbus_bool_t _dbus_string_hex_encode(const DBusString *source, int start, DBusString *dest, int insert_at)
Encodes a string in hex, the way MD5 and SHA-1 are usually encoded.
Definition: dbus-string.c:2259
_dbus_string_append_int
DBUS_PRIVATE_EXPORT dbus_bool_t _dbus_string_append_int(DBusString *str, long value)
Appends an integer to a DBusString.
Definition: dbus-sysdeps.c:356
_dbus_string_starts_with_c_str
DBUS_PRIVATE_EXPORT dbus_bool_t _dbus_string_starts_with_c_str(const DBusString *a, const char *c_str)
Checks whether a string starts with the given C string.
Definition: dbus-string.c:2188
_dbus_string_chop_white
DBUS_PRIVATE_EXPORT void _dbus_string_chop_white(DBusString *str)
Deletes leading and trailing whitespace.
Definition: dbus-string.c:1989
_dbus_string_insert_8_aligned
dbus_bool_t _dbus_string_insert_8_aligned(DBusString *str, int insert_at, const unsigned char octets[8])
Inserts 8 bytes aligned on an 8 byte boundary with any alignment padding initialized to 0...
Definition: dbus-string.c:1020
_dbus_string_tolower_ascii
DBUS_PRIVATE_EXPORT void _dbus_string_tolower_ascii(const DBusString *str, int start, int len)
Converts the given range of the string to lower case.
Definition: dbus-string.c:2485
DBusString::dummy3
int dummy3
placeholder
Definition: dbus-string.h:50
DBusString::dummy_bit1
unsigned int dummy_bit1
placeholder
Definition: dbus-string.h:51
DBusString::dummy_bit2
unsigned int dummy_bit2
placeholder
Definition: dbus-string.h:52
_dbus_string_get_data_len
char * _dbus_string_get_data_len(DBusString *str, int start, int len)
Gets a sub-portion of the raw character buffer from the string.
Definition: dbus-string.c:490
_dbus_string_init
DBUS_PRIVATE_EXPORT dbus_bool_t _dbus_string_init(DBusString *str)
Initializes a string.
Definition: dbus-string.c:175
_dbus_string_append_printf_valist
DBUS_PRIVATE_EXPORT dbus_bool_t _dbus_string_append_printf_valist(DBusString *str, const char *format, va_list args)
Appends a printf-style formatted string to the DBusString.
Definition: dbus-string.c:1072
_dbus_string_shorten
DBUS_PRIVATE_EXPORT void _dbus_string_shorten(DBusString *str, int length_to_remove)
Makes a string shorter by the given number of bytes.
Definition: dbus-string.c:780
_dbus_string_copy
DBUS_PRIVATE_EXPORT dbus_bool_t _dbus_string_copy(const DBusString *source, int start, DBusString *dest, int insert_at)
Like _dbus_string_move(), but does not delete the section of the source string that&#39;s copied to the d...
Definition: dbus-string.c:1283
_dbus_string_ends_with_c_str
dbus_bool_t _dbus_string_ends_with_c_str(const DBusString *a, const char *c_str)
Returns whether a string ends with the given suffix.
Definition: dbus-string-util.c:46
_dbus_string_find
DBUS_PRIVATE_EXPORT dbus_bool_t _dbus_string_find(const DBusString *str, int start, const char *substr, int *found)
Finds the given substring in the string, returning TRUE and filling in the byte index where the subst...
Definition: dbus-string.c:1604
_dbus_string_skip_white
DBUS_PRIVATE_EXPORT void _dbus_string_skip_white(const DBusString *str, int start, int *end)
Skips whitespace from start, storing the first non-whitespace in *end.
Definition: dbus-string.c:1837
_dbus_string_move
DBUS_PRIVATE_EXPORT dbus_bool_t _dbus_string_move(DBusString *source, int start, DBusString *dest, int insert_at)
Moves the end of one string into another string.
Definition: dbus-string.c:1259
_dbus_string_equal_c_str
DBUS_PRIVATE_EXPORT dbus_bool_t _dbus_string_equal_c_str(const DBusString *a, const char *c_str)
Checks whether a string is equal to a C string.
Definition: dbus-string.c:2152
_dbus_string_compact
DBUS_PRIVATE_EXPORT dbus_bool_t _dbus_string_compact(DBusString *str, int max_waste)
Compacts the string to avoid wasted memory.
Definition: dbus-string.c:389
_dbus_string_copy_data
DBUS_PRIVATE_EXPORT dbus_bool_t _dbus_string_copy_data(const DBusString *str, char **data_return)
Copies the data from the string into a char*.
Definition: dbus-string.c:672
DBusString
Definition: dbus-string.h:42
dbus_bool_t
dbus_uint32_t dbus_bool_t
A boolean, valid values are TRUE and FALSE.
Definition: dbus-types.h:35
_dbus_string_init_const
DBUS_PRIVATE_EXPORT void _dbus_string_init_const(DBusString *str, const char *value)
Initializes a constant string.
Definition: dbus-string.c:190
_dbus_string_replace_len
DBUS_PRIVATE_EXPORT dbus_bool_t _dbus_string_replace_len(const DBusString *source, int start, int len, DBusString *dest, int replace_at, int replace_len)
Replaces a segment of dest string with a segment of source string.
Definition: dbus-string.c:1404
_dbus_string_skip_blank
DBUS_PRIVATE_EXPORT void _dbus_string_skip_blank(const DBusString *str, int start, int *end)
Skips blanks from start, storing the first non-blank in *end (blank is space or tab).
Definition: dbus-string.c:1803
_dbus_string_pop_line
DBUS_PRIVATE_EXPORT dbus_bool_t _dbus_string_pop_line(DBusString *source, DBusString *dest)
Assigns a newline-terminated or \r\n-terminated line from the front of the string to the given dest s...
Definition: dbus-string.c:1909
_dbus_string_delete
DBUS_PRIVATE_EXPORT void _dbus_string_delete(DBusString *str, int start, int len)
Deletes a segment of a DBusString with length len starting at start.
Definition: dbus-string.c:1193
_dbus_string_init_preallocated
dbus_bool_t _dbus_string_init_preallocated(DBusString *str, int allocate_size)
Initializes a string that can be up to the given allocation size before it has to realloc...
Definition: dbus-string.c:132
_dbus_string_append_printf
DBUS_PRIVATE_EXPORT dbus_bool_t _dbus_string_append_printf(DBusString *str, const char *format,...)
Appends a printf-style formatted string to the DBusString.
Definition: dbus-string.c:1114
_dbus_string_zero
void _dbus_string_zero(DBusString *str)
Clears all allocated bytes in the string to zero.
Definition: dbus-string.c:2685
_dbus_string_validate_utf8
DBUS_PRIVATE_EXPORT dbus_bool_t _dbus_string_validate_utf8(const DBusString *str, int start, int len)
Checks that the given range of the string is valid UTF-8.
Definition: dbus-string.c:2555
_dbus_string_align_length
dbus_bool_t _dbus_string_align_length(DBusString *str, int alignment)
Align the length of a string to a specific alignment (typically 4 or 8) by appending nul bytes to the...
Definition: dbus-string.c:883
_dbus_string_equal_substring
DBUS_PRIVATE_EXPORT dbus_bool_t _dbus_string_equal_substring(const DBusString *a, int a_start, int a_len, const DBusString *b, int b_start)
Tests two sub-parts of two DBusString for equality.
Definition: dbus-string.c:2104
_dbus_string_equal_len
DBUS_PRIVATE_EXPORT dbus_bool_t _dbus_string_equal_len(const DBusString *a, const DBusString *b, int len)
Tests two DBusString for equality up to the given length.
Definition: dbus-string.c:2056
_dbus_string_init_from_string
DBUS_PRIVATE_EXPORT dbus_bool_t _dbus_string_init_from_string(DBusString *str, const DBusString *from)
Initializes a string from another string.
Definition: dbus-string.c:245
_dbus_string_insert_byte
DBUS_PRIVATE_EXPORT dbus_bool_t _dbus_string_insert_byte(DBusString *str, int i, unsigned char byte)
Inserts a single byte at the given position.
Definition: dbus-string.c:614
_dbus_string_append_byte
DBUS_PRIVATE_EXPORT dbus_bool_t _dbus_string_append_byte(DBusString *str, unsigned char byte)
Appends a single byte to the string, returning FALSE if not enough memory.
Definition: dbus-string.c:1157
_dbus_string_free
DBUS_PRIVATE_EXPORT void _dbus_string_free(DBusString *str)
Frees a string created by _dbus_string_init().
Definition: dbus-string.c:259
DBusString::dummy_bit3
unsigned int dummy_bit3
placeholder
Definition: dbus-string.h:53
_dbus_string_find_byte_backward
dbus_bool_t _dbus_string_find_byte_backward(const DBusString *str, int start, unsigned char byte, int *found)
Find the given byte scanning backward from the given start.
Definition: dbus-string-util.c:90
_dbus_string_find_blank
DBUS_PRIVATE_EXPORT dbus_bool_t _dbus_string_find_blank(const DBusString *str, int start, int *found)
Finds a blank (space or tab) in the string.
Definition: dbus-string.c:1765
_dbus_string_alloc_space
dbus_bool_t _dbus_string_alloc_space(DBusString *str, int extra_bytes)
Preallocate extra_bytes such that a future lengthening of the string by extra_bytes is guaranteed to ...
Definition: dbus-string.c:899
_dbus_string_hex_decode
DBUS_PRIVATE_EXPORT dbus_bool_t _dbus_string_hex_decode(const DBusString *source, int start, int *end_return, DBusString *dest, int insert_at)
Decodes a string from hex encoding.
Definition: dbus-string.c:2309
_dbus_string_append_byte_as_hex
dbus_bool_t _dbus_string_append_byte_as_hex(DBusString *str, unsigned char byte)
Appends a two-character hex digit to a string, where the hex digit has the value of the given byte...
Definition: dbus-string.c:2225
_dbus_string_parse_uint
DBUS_PRIVATE_EXPORT dbus_bool_t _dbus_string_parse_uint(const DBusString *str, int start, unsigned long *value_return, int *end_return)
Parses an unsigned integer contained in a DBusString.
Definition: dbus-sysdeps.c:476
_dbus_string_append_len
DBUS_PRIVATE_EXPORT dbus_bool_t _dbus_string_append_len(DBusString *str, const char *buffer, int len)
Appends block of bytes with the given length to a DBusString.
Definition: dbus-string.c:1137
_dbus_string_find_to
DBUS_PRIVATE_EXPORT dbus_bool_t _dbus_string_find_to(const DBusString *str, int start, int end, const char *substr, int *found)
Finds the given substring in the string, up to a certain position, returning TRUE and filling in the ...
Definition: dbus-string.c:1697
_dbus_string_validate_nul
DBUS_PRIVATE_EXPORT dbus_bool_t _dbus_string_validate_nul(const DBusString *str, int start, int len)
Checks that the given range of the string is all nul bytes.
Definition: dbus-string.c:2653
_dbus_string_insert_4_aligned
dbus_bool_t _dbus_string_insert_4_aligned(DBusString *str, int insert_at, const unsigned char octets[4])
Inserts 4 bytes aligned on a 4 byte boundary with any alignment padding initialized to 0...
Definition: dbus-string.c:996
_dbus_string_skip_white_reverse
void _dbus_string_skip_white_reverse(const DBusString *str, int end, int *start)
Skips whitespace from end, storing the start index of the trailing whitespace in *start.
Definition: dbus-string.c:1870
DBusString::dummy2
int dummy2
placeholder
Definition: dbus-string.h:49
_dbus_string_set_length
DBUS_PRIVATE_EXPORT dbus_bool_t _dbus_string_set_length(DBusString *str, int length)
Sets the length of a string.
Definition: dbus-string.c:802
_dbus_string_insert_2_aligned
dbus_bool_t _dbus_string_insert_2_aligned(DBusString *str, int insert_at, const unsigned char octets[2])
Inserts 2 bytes aligned on a 2 byte boundary with any alignment padding initialized to 0...
Definition: dbus-string.c:972
_dbus_string_copy_len
DBUS_PRIVATE_EXPORT dbus_bool_t _dbus_string_copy_len(const DBusString *source, int start, int len, DBusString *dest, int insert_at)
Like _dbus_string_copy(), but can copy a segment from the middle of the source string.
Definition: dbus-string.c:1375
_dbus_string_steal_data
DBUS_PRIVATE_EXPORT dbus_bool_t _dbus_string_steal_data(DBusString *str, char **data_return)
Like _dbus_string_get_data(), but removes the gotten data from the original string.
Definition: dbus-string.c:641
_dbus_string_toupper_ascii
DBUS_PRIVATE_EXPORT void _dbus_string_toupper_ascii(const DBusString *str, int start, int len)
Converts the given range of the string to upper case.
Definition: dbus-string.c:2516
_dbus_string_insert_alignment
dbus_bool_t _dbus_string_insert_alignment(DBusString *str, int *insert_at, int alignment)
Inserts padding at *insert_at such to align it to the given boundary.
Definition: dbus-string.c:1048
_dbus_string_validate_ascii
dbus_bool_t _dbus_string_validate_ascii(const DBusString *str, int start, int len)
Checks that the given range of the string is valid ASCII with no nul bytes.
Definition: dbus-string.c:2450
_dbus_string_init_const_len
DBUS_PRIVATE_EXPORT void _dbus_string_init_const_len(DBusString *str, const char *value, int len)
Initializes a constant string with a length.
Definition: dbus-string.c:210
_dbus_string_move_len
dbus_bool_t _dbus_string_move_len(DBusString *source, int start, int len, DBusString *dest, int insert_at)
Like _dbus_string_move(), but can move a segment from the middle of the source string.
Definition: dbus-string.c:1308
_dbus_string_split_on_byte
DBUS_PRIVATE_EXPORT dbus_bool_t _dbus_string_split_on_byte(DBusString *source, unsigned char byte, DBusString *tail)
Looks for the first occurance of a byte, deletes that byte, and moves everything after the byte to th...
Definition: dbus-string.c:1467
DBUS_END_DECLS
#define DBUS_END_DECLS
Macro used after declaring functions in the D-Bus header files.