바이트 배열 객체¶

PyTypeObject PyByteArray_Type¶: 상의 안정 ABI.
이 PyTypeObject 인스턴스는 파이썬 bytearray 형을 나타냅니다; 파이썬 계층의 bytearray와 같은 객체입니다.

형 검사 매크로¶

int PyByteArray_Check(PyObject *o)¶: 객체 o가 bytearray 객체이거나 bytearray 형의 서브 형 인스턴스면 참을 반환합니다. 이 함수는 항상 성공합니다.

int PyByteArray_CheckExact(PyObject *o)¶: 객체 o가 bytearray 객체이지만, bytearray 형의 서브 형 인스턴스는 아니면 참을 반환합니다. 이 함수는 항상 성공합니다.

PyObject *PyByteArray_FromObject(PyObject *o)¶

반환값: 새 참조. 상의 안정 ABI. Thread safety: Safe for concurrent use on the same object.

버퍼 프로토콜을 구현하는 임의의 객체(o)로부터 써서 새로운 bytearray 객체를 돌려줍니다.

실패하면, NULL을 반환하고 예외를 설정합니다.

참고

객체가 버퍼 프로토콜을 구현하는 경우, bytearray 객체가 생성되는 동안 버퍼는 변경되어서는 안 됩니다.

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

반환값: 새 참조. 상의 안정 ABI. Thread safety: Atomic.

string과 그 길이(len)로 새로운 bytearray 객체를 만듭니다.

실패하면, NULL을 반환하고 예외를 설정합니다.

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

반환값: 새 참조. 상의 안정 ABI. Thread safety: Safe for concurrent use on the same object.

바이트 배열 a 와 b를 이어붙여 새로운 bytearray로 반환합니다.

실패하면, NULL을 반환하고 예외를 설정합니다.

참고

객체가 버퍼 프로토콜을 구현하는 경우, bytearray 객체가 생성되는 동안 버퍼는 변경되어서는 안 됩니다.

Py_ssize_t PyByteArray_Size(PyObject *bytearray)¶: 상의 안정 ABI. Thread safety: Atomic.
NULL 포인터를 확인한 후 bytearray의 크기를 반환합니다.

char *PyByteArray_AsString(PyObject *bytearray)¶: 상의 안정 ABI. Thread safety: Safe to call from multiple threads with external synchronization only.
NULL 포인터를 확인한 후 bytearray의 내용을 char 배열로 반환합니다. 반환되는 배열에는 항상 여분의 널 바이트가 추가됩니다.

참고

반환된 문자 배열을 사용하는 동안 bytearray 객체를 변경하는 것은 스레드에 안전하지 않습니다.

int PyByteArray_Resize(PyObject *bytearray, Py_ssize_t len)¶: 상의 안정 ABI.
bytearray의 내부 버퍼의 크기를 len으로 조정합니다. 실패 시 예외와 함께 -1이 반환됩니다.

버전 3.14에서 변경: 음수 len을 사용하면 예외가 발생하고 -1이 반환됩니다.

이 매크로는 속도를 위해 안전을 희생하며 포인터를 확인하지 않습니다.

char *PyByteArray_AS_STRING(PyObject *bytearray)¶: Thread safety: Safe to call from multiple threads with external synchronization only.
PyByteArray_AsString()과 유사하지만 에러를 검사하지 않습니다.

참고

반환된 문자 배열을 사용하는 동안 bytearray 객체를 변경하는 것은 스레드에 안전하지 않습니다.

Py_ssize_t PyByteArray_GET_SIZE(PyObject *bytearray)¶: Thread safety: Atomic.
PyByteArray_Size()와 유사하지만 에러를 검사하지 않습니다.