Pickle 버퍼 객체들¶

Added in version 3.8.

pickle.PickleBuffer 객체는 pickle 모듈을 사용하여 아웃 오브 밴드 데이터 전송을 위한 :ref:`버퍼 제공 객체 <bufferobjects>`를 래핑합니다.

PyTypeObject PyPickleBuffer_Type¶: 이 PyTypeObject 인스턴스는 파이썬 피클 버퍼 타입을 나타냅니다. 이것은 파이썬 계층의 :class:`pickle.PickleBuffer`와 같은 객체입니다.

int PyPickleBuffer_Check(PyObject *op)¶: op 이 피클 버퍼 인스턴스인 경우 true를 반환합니다. 이 함수는 항상 성공합니다.

PyObject *PyPickleBuffer_FromObject(PyObject *obj)¶

객체 obj 로부터 피클 버퍼를 생성합니다.

obj 가 버퍼 프로토콜 를 지원하지 않으면 이 함수는 실패합니다.

성공하면 새 피클 버퍼 인스턴스를 반환합니다. 실패하면 예외를 설정하고 NULL 을 반환합니다.

파이썬에서 pickle.PickleBuffer 를 obj 로 호출하는 것에 비유됩니다.

const Py_buffer *PyPickleBuffer_GetBuffer(PyObject *picklebuf)¶

피클 버퍼가 래핑하는 하부 :c:type:`Py_buffer`에 대한 포인터를 가져옵니다.

반환된 포인터는 picklebuf 가 살아 있고 해제되지 않은 동안 유효합니다. 호출자는 반환된 Py_buffer 를 수정하거나 해제해서는 안 됩니다. 피클 버퍼가 해제된 경우, ValueError 를 발생시키십시오.

성공하면 버퍼 뷰에 대한 포인터를 반환합니다. 실패하면 예외를 설정하고 NULL 을 반환합니다.

int PyPickleBuffer_Release(PyObject *picklebuf)¶

피클 버퍼가 보유한 하부 버퍼를 해제합니다.

성공하면 0 을 반환합니다. 실패하면 예외를 설정하고 -1 을 반환합니다.

파이썬에서 :meth:`pickle.PickleBuffer.release`를 호출하는 것에 비유됩니다.