1:
2:
3:
4:
5:
6:
7:
8:
9:
10:
11:
12:
13:
14:
15:
16:
17:
18:
19:
20:
21:
22:
23:
24: #ifndef DBUS_STRING_H
25: #define DBUS_STRING_H
26:
27: #include <config.h>
28:
29: #include <dbus/dbus-memory.h>
30: #include <dbus/dbus-types.h>
31: #include <dbus/dbus-sysdeps.h>
32:
33: #include <stdarg.h>
34:
35: DBUS_BEGIN_DECLS
36:
37:
38:
39:
40: struct DBusString
41: {
42: const void *dummy1;
43: int dummy2;
44: int dummy3;
45: int dummy4;
46: unsigned int dummy5 : 1;
47: unsigned int dummy6 : 1;
48: unsigned int dummy7 : 1;
49: unsigned int dummy8 : 3;
50: };
51:
52: #ifdef DBUS_DISABLE_ASSERT
53:
54:
55:
56:
57: #define _dbus_string_get_data(s) ((char*)(((DBusString*)(s))->dummy1))
58: #define _dbus_string_get_length(s) (((DBusString*)(s))->dummy2)
59: #define _dbus_string_set_byte(s, i, b) ((((unsigned char*)(((DBusString*)(s))->dummy1))[(i)]) = (unsigned char) (b))
60: #define _dbus_string_get_byte(s, i) (((const unsigned char*)(((DBusString*)(s))->dummy1))[(i)])
61: #define _dbus_string_get_const_data(s) ((const char*)(((DBusString*)(s))->dummy1))
62: #define _dbus_string_get_const_data_len(s,start,len) (((const char*)(((DBusString*)(s))->dummy1)) + (start))
63: #endif
64:
65: dbus_bool_t _dbus_string_init (DBusString *str);
66: void _dbus_string_init_const (DBusString *str,
67: const char *value);
68: void _dbus_string_init_const_len (DBusString *str,
69: const char *value,
70: int len);
71: dbus_bool_t _dbus_string_init_preallocated (DBusString *str,
72: int allocate_size);
73: void _dbus_string_free (DBusString *str);
74: void _dbus_string_lock (DBusString *str);
75: #ifndef _dbus_string_get_data
76: char* _dbus_string_get_data (DBusString *str);
77: #endif
78: #ifndef _dbus_string_get_const_data
79: const char* _dbus_string_get_const_data (const DBusString *str);
80: #endif
81: char* _dbus_string_get_data_len (DBusString *str,
82: int start,
83: int len);
84: #ifndef _dbus_string_get_const_data_len
85: const char* _dbus_string_get_const_data_len (const DBusString *str,
86: int start,
87: int len);
88: #endif
89: #ifndef _dbus_string_set_byte
90: void _dbus_string_set_byte (DBusString *str,
91: int i,
92: unsigned char byte);
93: #endif
94: #ifndef _dbus_string_get_byte
95: unsigned char _dbus_string_get_byte (const DBusString *str,
96: int start);
97: #endif
98: dbus_bool_t _dbus_string_insert_bytes (DBusString *str,
99: int i,
100: int n_bytes,
101: unsigned char byte);
102: dbus_bool_t _dbus_string_insert_byte (DBusString *str,
103: int i,
104: unsigned char byte);
105: dbus_bool_t _dbus_string_steal_data (DBusString *str,
106: char **data_return);
107: dbus_bool_t _dbus_string_steal_data_len (DBusString *str,
108: char **data_return,
109: int start,
110: int len);
111: dbus_bool_t _dbus_string_copy_data (const DBusString *str,
112: char **data_return);
113: dbus_bool_t _dbus_string_copy_data_len (const DBusString *str,
114: char **data_return,
115: int start,
116: int len);
117: void _dbus_string_copy_to_buffer (const DBusString *str,
118: char *buffer,
119: int len);
120: #ifndef _dbus_string_get_length
121: int _dbus_string_get_length (const DBusString *str);
122: #endif
123:
124: dbus_bool_t _dbus_string_lengthen (DBusString *str,
125: int additional_length);
126: void _dbus_string_shorten (DBusString *str,
127: int length_to_remove);
128: dbus_bool_t _dbus_string_set_length (DBusString *str,
129: int length);
130: dbus_bool_t _dbus_string_align_length (DBusString *str,
131: int alignment);
132: dbus_bool_t _dbus_string_alloc_space (DBusString *str,
133: int extra_bytes);
134: dbus_bool_t _dbus_string_append (DBusString *str,
135: const char *buffer);
136: dbus_bool_t _dbus_string_append_len (DBusString *str,
137: const char *buffer,
138: int len);
139: dbus_bool_t _dbus_string_append_int (DBusString *str,
140: long value);
141: dbus_bool_t _dbus_string_append_uint (DBusString *str,
142: unsigned long value);
143: dbus_bool_t _dbus_string_append_double (DBusString *str,
144: double value);
145: dbus_bool_t _dbus_string_append_byte (DBusString *str,
146: unsigned char byte);
147: dbus_bool_t _dbus_string_append_unichar (DBusString *str,
148: dbus_unichar_t ch);
149: dbus_bool_t _dbus_string_append_4_aligned (DBusString *str,
150: const unsigned char octets[4]);
151: dbus_bool_t _dbus_string_append_8_aligned (DBusString *str,
152: const unsigned char octets[8]);
153: dbus_bool_t _dbus_string_append_printf (DBusString *str,
154: const char *format,
155: ...) _DBUS_GNUC_PRINTF (2, 3);
156: dbus_bool_t _dbus_string_append_printf_valist (DBusString *str,
157: const char *format,
158: va_list args);
159: dbus_bool_t _dbus_string_insert_2_aligned (DBusString *str,
160: int insert_at,
161: const unsigned char octets[2]);
162: dbus_bool_t _dbus_string_insert_4_aligned (DBusString *str,
163: int insert_at,
164: const unsigned char octets[4]);
165: dbus_bool_t _dbus_string_insert_8_aligned (DBusString *str,
166: int insert_at,
167: const unsigned char octets[8]);
168: dbus_bool_t _dbus_string_insert_alignment (DBusString *str,
169: int *insert_at,
170: int alignment);
171: void _dbus_string_delete (DBusString *str,
172: int start,
173: int len);
174: dbus_bool_t _dbus_string_move (DBusString *source,
175: int start,
176: DBusString *dest,
177: int insert_at);
178: dbus_bool_t _dbus_string_copy (const DBusString *source,
179: int start,
180: DBusString *dest,
181: int insert_at);
182: dbus_bool_t _dbus_string_move_len (DBusString *source,
183: int start,
184: int len,
185: DBusString *dest,
186: int insert_at);
187: dbus_bool_t _dbus_string_copy_len (const DBusString *source,
188: int start,
189: int len,
190: DBusString *dest,
191: int insert_at);
192: dbus_bool_t _dbus_string_replace_len (const DBusString *source,
193: int start,
194: int len,
195: DBusString *dest,
196: int replace_at,
197: int replace_len);
198: void _dbus_string_get_unichar (const DBusString *str,
199: int start,
200: dbus_unichar_t *ch_return,
201: int *end_return);
202: dbus_bool_t _dbus_string_parse_int (const DBusString *str,
203: int start,
204: long *value_return,
205: int *end_return);
206: dbus_bool_t _dbus_string_parse_uint (const DBusString *str,
207: int start,
208: unsigned long *value_return,
209: int *end_return);
210: dbus_bool_t _dbus_string_parse_double (const DBusString *str,
211: int start,
212: double *value,
213: int *end_return);
214: dbus_bool_t _dbus_string_find (const DBusString *str,
215: int start,
216: const char *substr,
217: int *found);
218: dbus_bool_t _dbus_string_find_to (const DBusString *str,
219: int start,
220: int end,
221: const char *substr,
222: int *found);
223: dbus_bool_t _dbus_string_find_byte_backward (const DBusString *str,
224: int start,
225: unsigned char byte,
226: int *found);
227: dbus_bool_t _dbus_string_find_blank (const DBusString *str,
228: int start,
229: int *found);
230: void _dbus_string_skip_blank (const DBusString *str,
231: int start,
232: int *end);
233: void _dbus_string_skip_white (const DBusString *str,
234: int start,
235: int *end);
236: void _dbus_string_skip_white_reverse (const DBusString *str,
237: int end,
238: int *start);
239: dbus_bool_t _dbus_string_equal (const DBusString *a,
240: const DBusString *b);
241: dbus_bool_t _dbus_string_equal_c_str (const DBusString *a,
242: const char *c_str);
243: dbus_bool_t _dbus_string_equal_len (const DBusString *a,
244: const DBusString *b,
245: int len);
246: dbus_bool_t _dbus_string_equal_substring (const DBusString *a,
247: int a_start,
248: int a_len,
249: const DBusString *b,
250: int b_start);
251: dbus_bool_t _dbus_string_starts_with_c_str (const DBusString *a,
252: const char *c_str);
253: dbus_bool_t _dbus_string_ends_with_c_str (const DBusString *a,
254: const char *c_str);
255: dbus_bool_t _dbus_string_pop_line (DBusString *source,
256: DBusString *dest);
257: void _dbus_string_delete_first_word (DBusString *str);
258: void _dbus_string_delete_leading_blanks (DBusString *str);
259: void _dbus_string_chop_white (DBusString *str);
260: dbus_bool_t _dbus_string_append_byte_as_hex (DBusString *str,
261: int byte);
262: dbus_bool_t _dbus_string_hex_encode (const DBusString *source,
263: int start,
264: DBusString *dest,
265: int insert_at);
266: dbus_bool_t _dbus_string_hex_decode (const DBusString *source,
267: int start,
268: int *end_return,
269: DBusString *dest,
270: int insert_at);
271: dbus_bool_t _dbus_string_validate_ascii (const DBusString *str,
272: int start,
273: int len);
274: dbus_bool_t _dbus_string_validate_utf8 (const DBusString *str,
275: int start,
276: int len);
277: dbus_bool_t _dbus_string_validate_nul (const DBusString *str,
278: int start,
279: int len);
280: void _dbus_string_zero (DBusString *str);
281:
282:
283:
284:
285:
286:
287:
288: #define _DBUS_STRING_ALLOCATION_PADDING 8
289:
290:
291:
292:
293:
294:
295:
296:
297: #define _DBUS_STRING_DEFINE_STATIC(name, str) \
298: static const char _dbus_static_string_##name[] = str; \
299: static const DBusString name = { _dbus_static_string_##name, \
300: sizeof(_dbus_static_string_##name), \
301: sizeof(_dbus_static_string_##name) + \
302: _DBUS_STRING_ALLOCATION_PADDING, \
303: sizeof(_dbus_static_string_##name), \
304: TRUE, TRUE, FALSE, 0 }
305:
306: DBUS_END_DECLS
307:
308: #endif
