Objects/stringlib/README.txt

   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)