# Objetos buffer serializados com pickle

Adicionado na versão 3.8.

Um objeto `pickle.PickleBuffer` encapsula um objeto provedor de buffer para transferência de dados fora de banda com o módulo `pickle`.

PyTypeObject PyPickleBuffer_Type

  Esta instância de `PyTypeObject` representa o tipo de buffer serializado com pickle do Python. Este é o mesmo objeto que `pickle.PickleBuffer` na camada Python.

int PyPickleBuffer_Check( PyObject *op)

  Retorna verdadeiro se op for uma instância de buffer serializado com pickle. Esta função sempre tem sucesso.

PyObject *PyPickleBuffer_FromObject( PyObject *obj)

  Cria um buffer serializado com pickle a partir do objeto obj.

  Esta função falhará se obj não oferecer suporte ao protocolo de buffer.

  Em caso de sucesso, retorna uma nova instância de buffer serializado com pickle. Em caso de falha, define uma exceção e retorna `NULL`.

  Análogo a chamar `pickle.PickleBuffer` com obj em Python.

const Py_buffer *PyPickleBuffer_GetBuffer( PyObject *picklebuf)

  Obtém um ponteiro para o `Py_buffer` subjacente que o buffer serializado com pickle encapsula.

  O ponteiro retornado é válido enquanto picklebuf estiver ativo e não tiver sido liberado. O chamador não deve modificar ou liberar o `Py_buffer` retornado. Se o buffer serializado com pickle tiver sido liberado, levanta uma exceção `ValueError`.

  Em caso de sucesso, retorna um ponteiro para a visualização do buffer. Em caso de falha, define uma exceção e retorna `NULL`.

int PyPickleBuffer_Release( PyObject *picklebuf)

  Libera o buffer subjacente mantido pelo buffer serializado com pickle.

  Retorna `0` em caso de sucesso. Em caso de falha, define uma exceção e retorna `-1`.

  Análogo a chamar `pickle.PickleBuffer.release()` em Python.