Esta documentação é de uma versão antiga do Python que não é mais atualizada. Você deveria atualizar e ler a Documentação do Python para versão estável atual.

# Protocolo de Buffer Antigo

Obsoleto desde a versão 3.0.

Essas funções faziam parte da API do “protocolo de buffer antigo” no Python 2. No Python 3, esse protocolo não existe mais, mas as funções ainda estão expostas para facilitar a portabilidade do código 2.x. Eles atuam como um wrapper de compatibilidade em torno do novo protocolo de buffer, mas não oferecem controle sobre a vida útil dos recursos adquiridos quando um buffer é exportado.

Portanto, é recomendável que você chame `PyObject_GetBuffer()` (ou os códigos de formatação `y*` ou `w*` com o família de funções de `PyArg_ParseTuple()`) para obter uma visão de buffer sobre um objeto e `PyBuffer_Release()` quando a visão de buffer puder ser liberada.

int `PyObject_AsCharBuffer`(PyObject *obj, const char **buffer, Py_ssize_t *buffer_len)

  Retorna um ponteiro para um local de memória somente leitura utilizável como entrada baseada em caracteres. O argumento obj deve ter suporte a interface do buffer de caracteres de segmento único. Em caso de sucesso, retorna `0`, define buffer com o local da memória e buffer_len com o comprimento do buffer. Retorna `-1` e define a `TypeError` em caso de erro.

int `PyObject_AsReadBuffer`(PyObject *obj, const void **buffer, Py_ssize_t *buffer_len)

  Retorna um ponteiro para um local de memória somente leitura que contém dados arbitrários. O argumento obj deve ter suporte a interface de buffer legível de segmento único. Em caso de sucesso, retorna `0`, define buffer com o local da memória e buffer_len com o comprimento do buffer. Retorna `-1` e define a `TypeError` em caso de erro.

int `PyObject_CheckReadBuffer`(PyObject *o)

  Retorna `1` se o tiver suporte a interface de buffer legível de segmento único. Caso contrário, retorna `0`. Esta função sempre tem sucesso.

  Observe que esta função tenta obter e liberar um buffer, e as exceções que ocorrem ao chamar as funções correspondentes serão suprimidas. Para obter o relatório de erros, use `PyObject_GetBuffer()` em vez disso.

int `PyObject_AsWriteBuffer`(PyObject *obj, void **buffer, Py_ssize_t *buffer_len)

  Retorna um ponteiro para um local de memória gravável. O argumento obj deve ter suporte a interface de buffer de caracteres de segmento único. Em caso de sucesso, retorna `0`, define buffer com o local da memória e buffer_len com o comprimento do buffer. Retorna `-1` e define a `TypeError` em caso de erro.