Include/bytesobject.h

   1 /* Bytes object interface */
   2
   3 #ifndef Py_BYTESOBJECT_H
   4 #define Py_BYTESOBJECT_H
   5 #ifdef __cplusplus
   6 extern "C" {
   7 #endif
   8
   9 #include <stdarg.h>
  10
  11 /* Type PyBytesObject represents a mutable array of bytes.
  12  * The Python API is that of a sequence;
  13  * the bytes are mapped to ints in [0, 256).
  14  * Bytes are not characters; they may be used to encode characters.
  15  * The only way to go between bytes and str/unicode is via encoding
  16  * and decoding.
  17  * For the convenience of C programmers, the bytes type is considered
  18  * to contain a char pointer, not an unsigned char pointer.
  19  */
  20
  21 /* Object layout */
  22 typedef struct {
  23     PyObject_VAR_HEAD
  24     /* XXX(nnorwitz): should ob_exports be Py_ssize_t? */
  25     int ob_exports; /* how many buffer exports */
  26     Py_ssize_t ob_alloc; /* How many bytes allocated */
  27     char *ob_bytes;
  28 } PyBytesObject;
  29
  30 /* Type object */
  31 PyAPI_DATA(PyTypeObject) PyBytes_Type;
  32 PyAPI_DATA(PyTypeObject) PyBytesIter_Type;
  33
  34 /* Type check macros */
  35 #define PyBytes_Check(self) PyObject_TypeCheck(self, &PyBytes_Type)
  36 #define PyBytes_CheckExact(self) (Py_TYPE(self) == &PyBytes_Type)
  37
  38 /* Direct API functions */
  39 PyAPI_FUNC(PyObject *) PyBytes_FromObject(PyObject *);
  40 PyAPI_FUNC(PyObject *) PyBytes_Concat(PyObject *, PyObject *);
  41 PyAPI_FUNC(PyObject *) PyBytes_FromStringAndSize(const char *, Py_ssize_t);
  42 PyAPI_FUNC(Py_ssize_t) PyBytes_Size(PyObject *);
  43 PyAPI_FUNC(char *) PyBytes_AsString(PyObject *);
  44 PyAPI_FUNC(int) PyBytes_Resize(PyObject *, Py_ssize_t);
  45
  46 /* Macros, trading safety for speed */
  47 #define PyBytes_AS_STRING(self) (assert(PyBytes_Check(self)),((PyBytesObject *)(self))->ob_bytes)
  48 #define PyBytes_GET_SIZE(self)  (assert(PyBytes_Check(self)),Py_SIZE(self))
  49
  50 #ifdef __cplusplus
  51 }
  52 #endif
  53 #endif /* !Py_BYTESOBJECT_H */