DBusString implementation details
[D-Bus secret internal implementation details]

DBusString implementation details. More...

Defines

#define _DBUS_STRING_MAX_MAX_LENGTH   (_DBUS_INT32_MAX - _DBUS_STRING_ALLOCATION_PADDING)
 This is the maximum max length (and thus also the maximum length) of a DBusString.
#define DBUS_GENERIC_STRING_PREAMBLE(real)   _dbus_assert ((real) != NULL); _dbus_assert (!(real)->invalid); _dbus_assert ((real)->len >= 0); _dbus_assert ((real)->allocated >= 0); _dbus_assert ((real)->max_length >= 0); _dbus_assert ((real)->len <= ((real)->allocated - _DBUS_STRING_ALLOCATION_PADDING)); _dbus_assert ((real)->len <= (real)->max_length)
 Checks a bunch of assertions about a string object.
#define DBUS_STRING_PREAMBLE(str)
 Checks assertions about a string object that needs to be modifiable - may not be locked or const.
#define DBUS_LOCKED_STRING_PREAMBLE(str)
 Checks assertions about a string object that may be locked but can't be const.
#define DBUS_CONST_STRING_PREAMBLE(str)
 Checks assertions about a string that may be const or locked.
#define DBUS_IS_ASCII_BLANK(c)   ((c) == ' ' || (c) == '\t')
 Checks for ASCII blank byte.
#define DBUS_IS_ASCII_WHITE(c)   ((c) == ' ' || (c) == '\t' || (c) == '\n' || (c) == '\r')
 Checks for ASCII whitespace byte.

Detailed Description

DBusString implementation details.

The guts of DBusString.


Define Documentation

#define DBUS_CONST_STRING_PREAMBLE ( str   ) 

Value:

Checks assertions about a string that may be const or locked.

Also declares the "real" variable pointing to DBusRealString.

Parameters:
str the string.

Definition at line 107 of file dbus-string-private.h.

Referenced by _dbus_string_copy_data(), _dbus_string_copy_to_buffer(), _dbus_string_copy_to_buffer_with_nul(), _dbus_string_find_blank(), _dbus_string_find_byte_backward(), _dbus_string_find_eol(), _dbus_string_find_to(), _dbus_string_skip_blank(), _dbus_string_skip_white(), _dbus_string_skip_white_reverse(), _dbus_string_validate_ascii(), _dbus_string_validate_nul(), and _dbus_string_validate_utf8().

#define DBUS_GENERIC_STRING_PREAMBLE ( real   )     _dbus_assert ((real) != NULL); _dbus_assert (!(real)->invalid); _dbus_assert ((real)->len >= 0); _dbus_assert ((real)->allocated >= 0); _dbus_assert ((real)->max_length >= 0); _dbus_assert ((real)->len <= ((real)->allocated - _DBUS_STRING_ALLOCATION_PADDING)); _dbus_assert ((real)->len <= (real)->max_length)

Checks a bunch of assertions about a string object.

Parameters:
real the DBusRealString

Definition at line 78 of file dbus-string-private.h.

Referenced by _dbus_string_ends_with_c_str(), _dbus_string_equal(), _dbus_string_equal_c_str(), _dbus_string_equal_substring(), and _dbus_string_free().

#define DBUS_IS_ASCII_BLANK (  )     ((c) == ' ' || (c) == '\t')

Checks for ASCII blank byte.

Parameters:
c the byte

Definition at line 114 of file dbus-string-private.h.

Referenced by _dbus_string_skip_blank().

#define DBUS_IS_ASCII_WHITE (  )     ((c) == ' ' || (c) == '\t' || (c) == '\n' || (c) == '\r')

Checks for ASCII whitespace byte.

Parameters:
c the byte

Definition at line 120 of file dbus-string-private.h.

Referenced by _dbus_string_skip_blank(), _dbus_string_skip_white(), and _dbus_string_skip_white_reverse().

#define DBUS_LOCKED_STRING_PREAMBLE ( str   ) 

Value:

DBusRealString *real = (DBusRealString*) str; \
  DBUS_GENERIC_STRING_PREAMBLE (real);                                                 \
  _dbus_assert (!(real)->constant)
Checks assertions about a string object that may be locked but can't be const.

i.e. a string object that we can free. Also declares the "real" variable pointing to DBusRealString.

Parameters:
str the string

Definition at line 98 of file dbus-string-private.h.

#define DBUS_STRING_PREAMBLE ( str   ) 

Value:

DBusRealString *real = (DBusRealString*) str; \
  DBUS_GENERIC_STRING_PREAMBLE (real);                                          \
  _dbus_assert (!(real)->constant);                                             \
  _dbus_assert (!(real)->locked)
Checks assertions about a string object that needs to be modifiable - may not be locked or const.

Also declares the "real" variable pointing to DBusRealString.

Parameters:
str the string

Definition at line 86 of file dbus-string-private.h.

Referenced by _dbus_string_append(), _dbus_string_append_byte(), _dbus_string_append_len(), _dbus_string_append_printf_valist(), _dbus_string_compact(), _dbus_string_delete(), _dbus_string_get_data_len(), _dbus_string_insert_2_aligned(), _dbus_string_insert_4_aligned(), _dbus_string_insert_8_aligned(), _dbus_string_insert_alignment(), _dbus_string_insert_byte(), _dbus_string_insert_bytes(), _dbus_string_lengthen(), _dbus_string_set_length(), _dbus_string_shorten(), _dbus_string_steal_data(), and _dbus_string_zero().


Generated on Tue Feb 24 16:40:41 2009 for D-Bus by  doxygen 1.5.1