mirror of
https://github.com/python/cpython.git
synced 2026-04-07 04:11:09 +00:00
47a7d70002
svn+ssh://pythondev@svn.python.org/python/trunk ........ r71920 | jeroen.ruigrok | 2009-04-25 21:44:55 +0200 (za, 25 apr 2009) | 5 lines Issue #4129: More documentation pointers about int -> Py_ssize_t. Also fix up the documentation for PyObject_GC_Resize(). It seems that since it first got documented, the documentation was actually for _PyObject_GC_Resize(). ........ r71921 | jeroen.ruigrok | 2009-04-25 21:46:19 +0200 (za, 25 apr 2009) | 2 lines Issue #4129: Documentation notes for int -> Py_ssize_t changes. ........ r71922 | jeroen.ruigrok | 2009-04-25 21:49:05 +0200 (za, 25 apr 2009) | 2 lines Reformat, since I've been busy here anyway. ........ r71923 | jeroen.ruigrok | 2009-04-25 21:54:34 +0200 (za, 25 apr 2009) | 2 lines Issue #4129: Add a versionchanged notice for a few forgotten entries. ........ r71925 | jeroen.ruigrok | 2009-04-25 22:37:39 +0200 (za, 25 apr 2009) | 2 lines Since it's a macro, actually refer to it as such instead of function. ........ r71926 | jeroen.ruigrok | 2009-04-25 22:40:10 +0200 (za, 25 apr 2009) | 2 lines Reformat prior to editing. ........ r71927 | jeroen.ruigrok | 2009-04-25 22:41:40 +0200 (za, 25 apr 2009) | 2 lines Issue #4129: int -> Py_ssize_t documentation. ........ r71928 | jeroen.ruigrok | 2009-04-25 22:43:30 +0200 (za, 25 apr 2009) | 2 lines Reformat prior to editing. ........ r71929 | jeroen.ruigrok | 2009-04-25 22:44:58 +0200 (za, 25 apr 2009) | 2 lines Issue #4129: int -> Py_ssize_t documentation. ........ r71931 | jeroen.ruigrok | 2009-04-25 22:50:27 +0200 (za, 25 apr 2009) | 2 lines Issue #4129: int -> Py_ssize_t documentation. ........ r71932 | jeroen.ruigrok | 2009-04-25 22:55:39 +0200 (za, 25 apr 2009) | 2 lines Issue #4129: more int -> Py_ssize_t documentation. ........ r71933 | jeroen.ruigrok | 2009-04-25 22:58:35 +0200 (za, 25 apr 2009) | 2 lines Issue #4129: more int -> Py_ssize_t documentation. ........ r71934 | jeroen.ruigrok | 2009-04-25 23:02:34 +0200 (za, 25 apr 2009) | 2 lines Issue #4129: field changed from int to Py_ssize_t. ........ r71937 | jeroen.ruigrok | 2009-04-25 23:16:05 +0200 (za, 25 apr 2009) | 2 lines Issue #4129: document int -> Py_ssize_t changes. ........
51 lines
2 KiB
ReStructuredText
51 lines
2 KiB
ReStructuredText
.. highlightlang:: c
|
|
|
|
.. _abstract-buffer:
|
|
|
|
Buffer Protocol
|
|
===============
|
|
|
|
|
|
.. cfunction:: int PyObject_AsCharBuffer(PyObject *obj, const char **buffer, Py_ssize_t *buffer_len)
|
|
|
|
Returns a pointer to a read-only memory location usable as character-based
|
|
input. 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
|
|
:exc:`TypeError` on error.
|
|
|
|
.. versionchanged:: 2.5
|
|
This function used an :ctype:`int *` type for *buffer_len*. This might
|
|
require changes in your code for properly supporting 64-bit systems.
|
|
|
|
|
|
.. cfunction:: int PyObject_AsReadBuffer(PyObject *obj, const void **buffer, Py_ssize_t *buffer_len)
|
|
|
|
Returns a pointer to a read-only memory location containing arbitrary data.
|
|
The *obj* argument must support the single-segment readable buffer
|
|
interface. On success, returns ``0``, sets *buffer* to the memory location
|
|
and *buffer_len* to the buffer length. Returns ``-1`` and sets a
|
|
:exc:`TypeError` on error.
|
|
|
|
.. versionchanged:: 2.5
|
|
This function used an :ctype:`int *` type for *buffer_len*. This might
|
|
require changes in your code for properly supporting 64-bit systems.
|
|
|
|
|
|
.. cfunction:: int PyObject_CheckReadBuffer(PyObject *o)
|
|
|
|
Returns ``1`` if *o* supports the single-segment readable buffer interface.
|
|
Otherwise returns ``0``.
|
|
|
|
|
|
.. cfunction:: int PyObject_AsWriteBuffer(PyObject *obj, void **buffer, Py_ssize_t *buffer_len)
|
|
|
|
Returns a pointer to a writable 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 :exc:`TypeError` on error.
|
|
|
|
.. versionchanged:: 2.5
|
|
This function used an :ctype:`int *` type for *buffer_len*. This might
|
|
require changes in your code for properly supporting 64-bit systems.
|
|
|