Byte Array Objects¶

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

PyTypeObject PyByteArray_Type¶: Bir parçası Kararlı ABI.
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)¶

Döndürdüğü değer: Yeni referans. Bir parçası Kararlı ABI. 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.

Not

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)¶

Döndürdüğü değer: Yeni referans. Bir parçası Kararlı ABI. 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)¶

Döndürdüğü değer: Yeni referans. Bir parçası Kararlı ABI. 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.

Not

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)¶: Bir parçası Kararlı ABI. Thread safety: Atomic.
Return the size of bytearray after checking for a NULL pointer.

char *PyByteArray_AsString(PyObject *bytearray)¶: Bir parçası Kararlı ABI. 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.

Not

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)¶: Bir parçası Kararlı ABI.
Resize the internal buffer of bytearray to len. Failure is a -1 return with an exception set.

3.14 sürümünde değişti: 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.

Not

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.