Ce document est relatif à une vieille version de Python qui n'est plus soutenue. Mettez à jour votre version et lisez Bienvenue sur la documentation de la version stable actuelle de Python.

# Ancien Protocole Tampon

Obsolète depuis la version 3.0.

Ces fonctions faisaient partie de l'API de l'ancien protocole de tampons dans Python 2. Dans Python 3, ce protocole n'existe plus, mais les fonctions sont toujours exposées pour simplifier le portage de code Python 2.x. Elles se comportent comme une abstraction de compatibilité du nouveau protocole de tampons, mais sans vous donner de contrôle sur la durée de vie des ressources acquises lorsqu'un tampon est exporté.

Il est donc recommandé d'appeler `PyObject_GetBuffer()` (ou les codes `y*` ou `w*` à la famille de fonctions `PyArg_ParseTuple()`) pour obtenir une vue d'un tampon sur un objet, et `PyBuffer_Release()` lorsque la vue peut être libérée.

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.

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.

int `PyObject_CheckReadBuffer`(PyObject *o)

  Retourne `1` si o prend en charge l'interface de mémoire tampon lisible à segment unique. Sinon, renvoie `0`. Cette fonction réussit toujours.

  Notez que cette fonction tente d'obtenir et de libérer une mémoire tampon, et les exceptions qui se produisent lors de l'appel des fonctions correspondantes seront supprimées. Pour que les erreurs vous soient signalées, utilisez `PyObject_GetBuffer()` à la place.

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

  Retourne un pointeur vers un emplacement de mémoire accessible en écriture. L'argument obj doit prendre en charge l'interface de mémoire 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. Renvoie `-1` et affecte l'exception `TypeError` en cas d'erreur.