Protocolo de Buffer Antigo

This section describes the legacy buffer protocol, which has been introduced in Python 1.6. It is still supported but deprecated in the Python 2.x series. Python 3 introduces a new buffer protocol which fixes weaknesses and shortcomings of the protocol, and has been backported to Python 2.6. See Buffers and Memoryview Objects for more information.

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 local da memória e buffer_len com o tamanho do buffer. Retorna -1 e define a TypeError em caso de erro.

Novo na versão 1.6.

Alterado na versão 2.5: This function used an int * type for buffer_len. This might require changes in your code for properly supporting 64-bit systems.

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 à 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 tamanho do buffer. Retorna -1 e define a TypeError em caso de erro.

Novo na versão 1.6.

Alterado na versão 2.5: This function used an int * type for buffer_len. This might require changes in your code for properly supporting 64-bit systems.

int PyObject_CheckReadBuffer(PyObject *o)

Returns 1 if o supports the single-segment readable buffer interface. Otherwise returns 0.

Novo na versão 2.2.

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

Returns a pointer to a writeable memory location. The obj argument must support the single-segment, character buffer interface. On success, returns 0, sets buffer to the memory location and buffer_len to the buffer length. Returns -1 and sets a TypeError on error.

Novo na versão 1.6.

Alterado na versão 2.5: This function used an int * type for buffer_len. This might require changes in your code for properly supporting 64-bit systems.