diff options
author | Guido van Rossum <guido@python.org> | 2006-04-22 23:28:04 (GMT) |
---|---|---|
committer | Guido van Rossum <guido@python.org> | 2006-04-22 23:28:04 (GMT) |
commit | 4dfe8a1131b551687659b9339eaee163a24f82f1 (patch) | |
tree | 79c967b9e355c0b0a070217a959abcd566aa6989 /Include/bytesobject.h | |
parent | d603f645d99102627c7776ebeb2c3d52eb1d3b4a (diff) | |
download | cpython-4dfe8a1131b551687659b9339eaee163a24f82f1.zip cpython-4dfe8a1131b551687659b9339eaee163a24f82f1.tar.gz cpython-4dfe8a1131b551687659b9339eaee163a24f82f1.tar.bz2 |
Here is a bytes type. It's very minimal but it's a start.
Diffstat (limited to 'Include/bytesobject.h')
-rw-r--r-- | Include/bytesobject.h | 47 |
1 files changed, 47 insertions, 0 deletions
diff --git a/Include/bytesobject.h b/Include/bytesobject.h new file mode 100644 index 0000000..9c11624 --- /dev/null +++ b/Include/bytesobject.h @@ -0,0 +1,47 @@ +/* Bytes object interface */ + +#ifndef Py_BYTESOBJECT_H +#define Py_BYTESOBJECT_H +#ifdef __cplusplus +extern "C" { +#endif + +#include <stdarg.h> + +/* Type PyBytesObject represents a mutable array of bytes. + * The Python API is that of a sequence; + * the bytes are mapped to ints in [0, 256). + * Bytes are not characters; they may be used to encode characters. + * The only way to go between bytes and str/unicode is via encoding + * and decoding. + * For the concenience of C programmers, the bytes type is considered + * to contain a char pointer, not an unsigned char pointer. + */ + +/* Object layout */ +typedef struct { + PyObject_VAR_HEAD + char *ob_sval; +} PyBytesObject; + +/* Type object */ +PyAPI_DATA(PyTypeObject) PyBytes_Type; + +/* Type check macros */ +#define PyBytes_Check(self) PyObject_TypeCheck(self, &PyBytes_Type) +#define PyBytes_CheckExact(self) ((self)->ob_type == &PyBytes_Type) + +/* Direct API functions */ +PyAPI_FUNC(PyObject *) PyBytes_FromStringAndSize(const char *, Py_ssize_t); +PyAPI_FUNC(Py_ssize_t) PyBytes_Size(PyObject *); +PyAPI_FUNC(char *) PyBytes_AsString(PyObject *); +PyAPI_FUNC(int) PyBytes_Resize(PyObject *, Py_ssize_t); + +/* Macros, trading safety for speed */ +#define PyBytes_AS_STRING(self) (((PyBytesObject *)(self))->ob_sval) +#define PyBytes_GET_SIZE(self) (((PyBytesObject *)(self))->ob_size) + +#ifdef __cplusplus +} +#endif +#endif /* !Py_BYTESOBJECT_H */ |