28 #include <dbus/dbus-macros.h>    29 #include <dbus/dbus-types.h>    30 #include <dbus/dbus-memory.h>    44 #if defined(DBUS_WIN) && defined(_DEBUG)    57 #ifdef DBUS_DISABLE_ASSERT    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))    91 #ifndef _dbus_string_get_data    95 #ifndef _dbus_string_get_const_data    97 const char*   _dbus_string_get_const_data        (
const DBusString  *str);
   102 #ifndef _dbus_string_get_const_data_len   104 const char*   _dbus_string_get_const_data_len    (
const DBusString  *str,
   108 #ifndef _dbus_string_set_byte   114 #ifndef _dbus_string_get_byte   116 unsigned char _dbus_string_get_byte              (
const DBusString  *str,
   149 #ifndef _dbus_string_get_length   151 int           _dbus_string_get_length            (
const DBusString  *str);
   164 static inline unsigned int   165 _dbus_string_get_length_uint (
const DBusString *str)
   167   return (
unsigned int) _dbus_string_get_length (str);
   172                                                   int                additional_length);
   175                                                   int                length_to_remove);
   195                                                   unsigned long      value);
   202                                                   ...) _DBUS_GNUC_PRINTF (2, 3);
   209                                                   const 
unsigned char octets[2]);
   212                                                   const 
unsigned char octets[4]);
   215                                                   const 
unsigned char octets[8]);
   263                                                   unsigned long     *value_return,
   325 void          _dbus_string_delete_first_word     (
DBusString        *str);
   327 void          _dbus_string_delete_leading_blanks (
DBusString        *str);
   370 #define _DBUS_STRING_ALLOCATION_PADDING 8   379 #define _DBUS_STRING_DEFINE_STATIC(name, str)                           \   380   static const char _dbus_static_string_##name[] = str;                 \   381   static const DBusString name = { _dbus_static_string_##name,          \   382                                    sizeof(_dbus_static_string_##name),  \   383                                    sizeof(_dbus_static_string_##name) + \   384                                    _DBUS_STRING_ALLOCATION_PADDING,     \   385                                    TRUE, TRUE, FALSE, 0 } 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. 
DBUS_PRIVATE_EXPORT dbus_bool_t _dbus_string_append(DBusString *str, const char *buffer)
Appends a nul-terminated C-style string to a DBusString. 
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. 
void _dbus_string_copy_to_buffer(const DBusString *str, char *buffer, int len)
Copies the contents of a DBusString into a different buffer. 
const void * dummy1
placeholder 
DBUS_PRIVATE_EXPORT dbus_bool_t _dbus_string_append_uint(DBusString *str, unsigned long value)
Appends an unsigned integer to a DBusString. 
DBUS_PRIVATE_EXPORT dbus_bool_t _dbus_string_equal(const DBusString *a, const DBusString *b)
Tests two DBusString for equality. 
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 ...
DBUS_PRIVATE_EXPORT dbus_bool_t _dbus_string_lengthen(DBusString *str, int additional_length)
Makes a string longer by the given number of bytes. 
unsigned int dummy_bits
placeholder 
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. 
#define DBUS_BEGIN_DECLS
Macro used prior to declaring functions in the D-Bus header files. 
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. 
DBUS_PRIVATE_EXPORT dbus_bool_t _dbus_string_append_int(DBusString *str, long value)
Appends an integer to a DBusString. 
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. 
DBUS_PRIVATE_EXPORT void _dbus_string_chop_white(DBusString *str)
Deletes leading and trailing whitespace. 
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...
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. 
unsigned int dummy_bit1
placeholder 
unsigned int dummy_bit2
placeholder 
char * _dbus_string_get_data_len(DBusString *str, int start, int len)
Gets a sub-portion of the raw character buffer from the string. 
DBUS_PRIVATE_EXPORT dbus_bool_t _dbus_string_init(DBusString *str)
Initializes a string. 
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. 
DBUS_PRIVATE_EXPORT void _dbus_string_shorten(DBusString *str, int length_to_remove)
Makes a string shorter by the given number of bytes. 
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's copied to the d...
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. 
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...
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. 
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. 
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. 
DBUS_PRIVATE_EXPORT dbus_bool_t _dbus_string_compact(DBusString *str, int max_waste)
Compacts the string to avoid wasted memory. 
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*. 
dbus_uint32_t dbus_bool_t
A boolean, valid values are TRUE and FALSE. 
DBUS_PRIVATE_EXPORT void _dbus_string_init_const(DBusString *str, const char *value)
Initializes a constant string. 
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. 
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). 
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...
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. 
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...
DBUS_PRIVATE_EXPORT dbus_bool_t _dbus_string_append_printf(DBusString *str, const char *format,...)
Appends a printf-style formatted string to the DBusString. 
void _dbus_string_zero(DBusString *str)
Clears all allocated bytes in the string to zero. 
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. 
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...
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. 
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. 
DBUS_PRIVATE_EXPORT dbus_bool_t _dbus_string_init_from_string(DBusString *str, const DBusString *from)
Initializes a string from another string. 
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. 
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. 
DBUS_PRIVATE_EXPORT void _dbus_string_free(DBusString *str)
Frees a string created by _dbus_string_init(). 
unsigned int dummy_bit3
placeholder 
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. 
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. 
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 ...
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. 
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...
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. 
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. 
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 ...
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. 
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...
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. 
DBUS_PRIVATE_EXPORT dbus_bool_t _dbus_string_set_length(DBusString *str, int length)
Sets the length of a string. 
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...
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. 
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. 
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. 
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. 
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. 
DBUS_PRIVATE_EXPORT void _dbus_string_init_const_len(DBusString *str, const char *value, int len)
Initializes a constant string with a length. 
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. 
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...
#define DBUS_END_DECLS
Macro used after declaring functions in the D-Bus header files.