1 bits shared by the stringobject and unicodeobject implementations (and

     2 possibly other modules, in a not too distant future).

     3 

     4 the stuff in here is included into relevant places; see the individual

     5 source files for details.

     6 

     7 --------------------------------------------------------------------

     8 the following defines used by the different modules:

     9 

    10 STRINGLIB_CHAR

    11 

    12     the type used to hold a character (char or Py_UNICODE)

    13 

    14 STRINGLIB_EMPTY

    15 

    16     a PyObject representing the empty string

    17 

    18 int STRINGLIB_CMP(STRINGLIB_CHAR*, STRINGLIB_CHAR*, Py_ssize_t)

    19 

    20     compares two strings. returns 0 if they match, and non-zero if not.

    21 

    22 Py_ssize_t STRINGLIB_LEN(PyObject*)

    23 

    24     returns the length of the given string object (which must be of the

    25     right type)

    26 

    27 PyObject* STRINGLIB_NEW(STRINGLIB_CHAR*, Py_ssize_t)

    28 

    29     creates a new string object

    30 

    31 STRINGLIB_CHAR* STRINGLIB_STR(PyObject*)

    32 

    33     returns the pointer to the character data for the given string

    34     object (which must be of the right type)