Byte-Array-Objekte

type PyByteArrayObject

Dieser Subtyp von PyObject repräsentiert ein Python-Bytearray-Objekt.

PyTypeObject PyByteArray_Type

Teil der Stable ABI.

Diese Instanz von PyTypeObject repräsentiert den Python-Bytearray-Typ; sie ist dasselbe Objekt wie bytearray in der Python-Schicht.

Typüberprüfungs-Makros

int PyByteArray_Check(PyObject *o)

Gibt wahr zurück, wenn das Objekt o ein Bytearray-Objekt oder eine Instanz eines Subtyps des Bytearray-Typs ist. Diese Funktion ist immer erfolgreich.

int PyByteArray_CheckExact(PyObject *o)

Gibt wahr zurück, wenn das Objekt o ein Bytearray-Objekt ist, aber keine Instanz eines Subtyps des Bytearray-Typs. Diese Funktion ist immer erfolgreich.

Direkte API-Funktionen

PyObject *PyByteArray_FromObject(PyObject *o)

Rückgabewert: Neue Referenz. Teil der Stabilen ABI.

Gibt ein neues Bytearray-Objekt aus jedem Objekt o zurück, das das Buffer-Protokoll implementiert.

Bei einem Fehler wird NULL mit einer gesetzten Ausnahme zurückgegeben.

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

Rückgabewert: Neue Referenz. Teil der Stabilen ABI.

Erstellt ein neues Bytearray-Objekt aus string und seiner Länge len.

Bei einem Fehler wird NULL mit einer gesetzten Ausnahme zurückgegeben.

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

Rückgabewert: Neue Referenz. Teil der Stabilen ABI.

Verknüpft die Bytearrays a und b und gibt ein neues Bytearray mit dem Ergebnis zurück.

Bei einem Fehler wird NULL mit einer gesetzten Ausnahme zurückgegeben.

Py_ssize_t PyByteArray_Size(PyObject *bytearray)

Teil der Stable ABI.

Gibt die Größe von bytearray zurück, nachdem auf einen NULL-Zeiger geprüft wurde.

char *PyByteArray_AsString(PyObject *bytearray)

Teil der Stable ABI.

Gibt den Inhalt von bytearray als Zeichen-Array zurück, nachdem auf einen NULL-Zeiger geprüft wurde. Das zurückgegebene Array hat immer ein zusätzliches Nullzeichen angehängt.

int PyByteArray_Resize(PyObject *bytearray, Py_ssize_t len)

Teil der Stable ABI.

Ändert die Größe des internen Puffers von bytearray auf len. Ein Fehler wird mit der Rückgabe von -1 und einer gesetzten Ausnahme angezeigt.

Geändert in Version 3.14: Ein negatives len führt nun zu einer gesetzten Ausnahme und der Rückgabe von -1.

Makros

Diese Makros tauschen Sicherheit gegen Geschwindigkeit und überprüfen keine Zeiger.

char *PyByteArray_AS_STRING(PyObject *bytearray)

Ähnlich wie PyByteArray_AsString(), aber ohne Fehlerprüfung.

Py_ssize_t PyByteArray_GET_SIZE(PyObject *bytearray)

Ähnlich wie PyByteArray_Size(), aber ohne Fehlerprüfung.