This document is for an old version of Python that is no longer supported. You should upgrade and read the Python documentation for the current stable release.

# Ancien Buffer Protocol

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 Objets de type MemoryView for more information.

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

  Retourne un pointeur vers un emplacement de mémoire en lecture seule utilisable en tant qu’entrée basée sur des caractères. L’argument obj doit prendre en charge l’interface de tampon de caractère à segment unique. En cas de succès, retourne `0`, définit buffer à l’emplacement de la mémoire et buffer_len à la longueur de la mémoire tampon. Retourne `-1` et affecte une exception `TypeError` en cas d’erreur.

  Nouveau dans la version 1.6.

  Modifié dans la version 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)

  Retourne un pointeur vers un emplacement de mémoire en lecture seule contenant des données arbitraires. L’argument obj doit prendre en charge l’interface de tampon lisible à segment unique. En cas de succès, retourne `0`, définit buffer à l’emplacement de la mémoire et buffer_len à la longueur de la mémoire tampon. Renvoie `-1` et affecte l’exception `TypeError` en cas d’erreur.

  Nouveau dans la version 1.6.

  Modifié dans la version 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)

  Renvoie `1` si o gère l’interface single-segment readable buffer, `0` sinon.

  Nouveau dans la version 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.

  Nouveau dans la version 1.6.

  Modifié dans la version 2.5: This function used an `int *` type for buffer_len. This might require changes in your code for properly supporting 64-bit systems.