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.
