1 /* -*- mode: C; c-file-style: "gnu" -*- */
2 /* dbus-string.h String utility class (internal to D-BUS implementation)
4 * Copyright (C) 2002 Red Hat, Inc.
6 * Licensed under the Academic Free License version 1.2
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.
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.
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
29 #include <dbus/dbus-memory.h>
30 #include <dbus/dbus-types.h>
31 #include <dbus/dbus-sysdeps.h>
39 void *dummy1; /**< placeholder */
40 int dummy2; /**< placeholder */
41 int dummy3; /**< placeholder */
42 int dummy4; /**< placeholder */
43 unsigned int dummy5 : 1; /**< placeholder */
44 unsigned int dummy6 : 1; /**< placeholder */
45 unsigned int dummy7 : 1; /**< placeholder */
46 unsigned int dummy8 : 3; /**< placeholder */
49 dbus_bool_t _dbus_string_init (DBusString *str);
50 void _dbus_string_init_const (DBusString *str,
52 void _dbus_string_init_const_len (DBusString *str,
55 dbus_bool_t _dbus_string_init_preallocated (DBusString *str,
57 void _dbus_string_free (DBusString *str);
58 void _dbus_string_lock (DBusString *str);
59 char* _dbus_string_get_data (DBusString *str);
60 const char* _dbus_string_get_const_data (const DBusString *str);
61 char* _dbus_string_get_data_len (DBusString *str,
64 const char* _dbus_string_get_const_data_len (const DBusString *str,
67 void _dbus_string_set_byte (DBusString *str,
70 unsigned char _dbus_string_get_byte (const DBusString *str,
72 dbus_bool_t _dbus_string_insert_byte (DBusString *str,
75 dbus_bool_t _dbus_string_steal_data (DBusString *str,
77 dbus_bool_t _dbus_string_steal_data_len (DBusString *str,
81 dbus_bool_t _dbus_string_copy_data (const DBusString *str,
83 dbus_bool_t _dbus_string_copy_data_len (const DBusString *str,
87 int _dbus_string_get_length (const DBusString *str);
88 dbus_bool_t _dbus_string_lengthen (DBusString *str,
89 int additional_length);
90 void _dbus_string_shorten (DBusString *str,
91 int length_to_remove);
92 dbus_bool_t _dbus_string_set_length (DBusString *str,
94 dbus_bool_t _dbus_string_align_length (DBusString *str,
96 dbus_bool_t _dbus_string_append (DBusString *str,
98 dbus_bool_t _dbus_string_append_len (DBusString *str,
101 dbus_bool_t _dbus_string_append_int (DBusString *str,
103 dbus_bool_t _dbus_string_append_uint (DBusString *str,
104 unsigned long value);
105 dbus_bool_t _dbus_string_append_double (DBusString *str,
107 dbus_bool_t _dbus_string_append_byte (DBusString *str,
109 dbus_bool_t _dbus_string_append_unichar (DBusString *str,
111 dbus_bool_t _dbus_string_append_4_aligned (DBusString *str,
112 const unsigned char octets[4]);
113 dbus_bool_t _dbus_string_append_8_aligned (DBusString *str,
114 const unsigned char octets[8]);
115 dbus_bool_t _dbus_string_append_printf (DBusString *str,
117 ...) _DBUS_GNUC_PRINTF (2, 3);
118 dbus_bool_t _dbus_string_append_printf_valist (DBusString *str,
121 void _dbus_string_delete (DBusString *str,
124 dbus_bool_t _dbus_string_move (DBusString *source,
128 dbus_bool_t _dbus_string_copy (const DBusString *source,
132 dbus_bool_t _dbus_string_move_len (DBusString *source,
137 dbus_bool_t _dbus_string_copy_len (const DBusString *source,
142 dbus_bool_t _dbus_string_replace_len (const DBusString *source,
148 void _dbus_string_get_unichar (const DBusString *str,
150 dbus_unichar_t *ch_return,
152 dbus_bool_t _dbus_string_parse_int (const DBusString *str,
156 dbus_bool_t _dbus_string_parse_uint (const DBusString *str,
158 unsigned long *value_return,
160 dbus_bool_t _dbus_string_parse_double (const DBusString *str,
164 dbus_bool_t _dbus_string_find (const DBusString *str,
168 dbus_bool_t _dbus_string_find_to (const DBusString *str,
173 dbus_bool_t _dbus_string_find_byte_backward (const DBusString *str,
177 dbus_bool_t _dbus_string_find_blank (const DBusString *str,
180 void _dbus_string_skip_blank (const DBusString *str,
183 void _dbus_string_skip_white (const DBusString *str,
186 dbus_bool_t _dbus_string_equal (const DBusString *a,
187 const DBusString *b);
188 dbus_bool_t _dbus_string_equal_c_str (const DBusString *a,
190 dbus_bool_t _dbus_string_equal_len (const DBusString *a,
193 dbus_bool_t _dbus_string_starts_with_c_str (const DBusString *a,
195 dbus_bool_t _dbus_string_ends_with_c_str (const DBusString *a,
197 dbus_bool_t _dbus_string_pop_line (DBusString *source,
199 void _dbus_string_delete_first_word (DBusString *str);
200 void _dbus_string_delete_leading_blanks (DBusString *str);
201 dbus_bool_t _dbus_string_base64_encode (const DBusString *source,
205 dbus_bool_t _dbus_string_base64_decode (const DBusString *source,
209 dbus_bool_t _dbus_string_hex_encode (const DBusString *source,
213 dbus_bool_t _dbus_string_hex_decode (const DBusString *source,
217 dbus_bool_t _dbus_string_validate_ascii (const DBusString *str,
220 dbus_bool_t _dbus_string_validate_utf8 (const DBusString *str,
223 dbus_bool_t _dbus_string_validate_nul (const DBusString *str,
226 dbus_bool_t _dbus_string_validate_name (const DBusString *str,
229 dbus_bool_t _dbus_string_validate_service (const DBusString *str,
232 void _dbus_string_zero (DBusString *str);
237 #endif /* DBUS_STRING_H */