mirrors
/
cpython
mirror of https://github.com/python/cpython.git
2
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Merged revisions 85075 via svnmerge from 

svn+ssh://pythondev@svn.python.org/python/branches/py3k

........
  r85075 | antoine.pitrou | 2010-09-28 23:52:30 +0200 (mar., 28 sept. 2010) | 3 lines

  Discourage use of the old buffer API funcs
........
This commit is contained in:
Antoine Pitrou 2010-09-28 21:53:46 +00:00
parent 1ec68b132e
commit 6db43fdb3b
1 changed files with 16 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
Doc/c-api/objbuffer.rst
View File

@ -1,6 +1,21 @@
.. highlightlang:: c
.. _abstract-buffer:
Old buffer API
--------------
.. deprecated:: 3.0
These functions were part of the "old buffer protocol" API in Python 2.
In Python 3, these functions are still exposed for ease of porting code.
They act as a compatibility wrapper around the :ref:`new buffer API
<bufferobjects>`, but they don't give you control over the lifetime of
the resources acquired when a buffer is exported.
Therefore, it is recommended that you call :cfunc:`PyObject_GetBuffer`
(or the ``y*`` or ``w*`` :ref:`format codes <arg-parsing>` with the
:cfunc:`PyArg_ParseTuple` family of functions) to get a buffer view over
an object, and :cfunc:`PyBuffer_Release` when the buffer view can be released.
Buffer Protocol
===============