Byte Array Objects¶

type PyByteArrayObject¶: This subtype of PyObject represents a Python bytearray object.

PyTypeObject PyByteArray_Type¶: Parte del ABI Stabile.
This instance of PyTypeObject represents the Python bytearray type; it is the same object as bytearray in the Python layer.

Type check macros¶

int PyByteArray_Check(PyObject *o)¶: Return true if the object o is a bytearray object or an instance of a subtype of the bytearray type. This function always succeeds.

int PyByteArray_CheckExact(PyObject *o)¶: Return true if the object o is a bytearray object, but not an instance of a subtype of the bytearray type. This function always succeeds.

PyObject *PyByteArray_FromObject(PyObject *o)¶

Valore di ritorno: Nuovo riferimento. Parte del ABI Stabile. Thread safety: Safe for concurrent use on the same object.

Return a new bytearray object from any object, o, that implements the buffer protocol.

On failure, return NULL with an exception set.

Nota

If the object implements the buffer protocol, then the buffer must not be mutated while the bytearray object is being created.

PyObject *PyByteArray_FromStringAndSize(const char *string, Py_ssize_t len)¶

Valore di ritorno: Nuovo riferimento. Parte del ABI Stabile. Thread safety: Atomic.

Create a new bytearray object from string and its length, len.

On failure, return NULL with an exception set.

PyObject *PyByteArray_Concat(PyObject *a, PyObject *b)¶

Valore di ritorno: Nuovo riferimento. Parte del ABI Stabile. Thread safety: Safe for concurrent use on the same object.

Concat bytearrays a and b and return a new bytearray with the result.

On failure, return NULL with an exception set.

Nota

If the object implements the buffer protocol, then the buffer must not be mutated while the bytearray object is being created.

Py_ssize_t PyByteArray_Size(PyObject *bytearray)¶: Parte del ABI Stabile. Thread safety: Atomic.
Return the size of bytearray after checking for a NULL pointer.

char *PyByteArray_AsString(PyObject *bytearray)¶: Parte del ABI Stabile. Thread safety: Safe to call from multiple threads with external synchronization only.
Return the contents of bytearray as a char array after checking for a NULL pointer. The returned array always has an extra null byte appended.

Nota

It is not thread-safe to mutate the bytearray object while using the returned char array.

int PyByteArray_Resize(PyObject *bytearray, Py_ssize_t len)¶: Parte del ABI Stabile.
Resize the internal buffer of bytearray to len. Failure is a -1 return with an exception set.

Cambiato nella versione 3.14: A negative len will now result in an exception being set and -1 returned.

These macros trade safety for speed and they don’t check pointers.

char *PyByteArray_AS_STRING(PyObject *bytearray)¶: Thread safety: Safe to call from multiple threads with external synchronization only.
Similar to PyByteArray_AsString(), but without error checking.

Nota

It is not thread-safe to mutate the bytearray object while using the returned char array.

Py_ssize_t PyByteArray_GET_SIZE(PyObject *bytearray)¶: Thread safety: Atomic.
Similar to PyByteArray_Size(), but without error checking.