diff options
| author | Benjamin Peterson <benjamin@python.org> | 2015-08-18 06:38:55 (GMT) |
|---|---|---|
| committer | Benjamin Peterson <benjamin@python.org> | 2015-08-18 06:38:55 (GMT) |
| commit | ac48a4173dc4f96ec26a3816945cfcc3f7293a4e (patch) | |
| tree | 928715617884bab98dff4e08d6b58941fa639b62 /Doc/c-api/buffer.rst | |
| parent | 5b798abf5b56887d8dcde4e9fa82e405ef4b1dd3 (diff) | |
| parent | 8e205f7b4f852d903db223d98b96721c4bc19644 (diff) | |
| download | cpython-ac48a4173dc4f96ec26a3816945cfcc3f7293a4e.zip cpython-ac48a4173dc4f96ec26a3816945cfcc3f7293a4e.tar.gz cpython-ac48a4173dc4f96ec26a3816945cfcc3f7293a4e.tar.bz2 | |
Merge 3.5 (#24883)
Diffstat (limited to 'Doc/c-api/buffer.rst')
| -rw-r--r-- | Doc/c-api/buffer.rst | 8 |
1 files changed, 4 insertions, 4 deletions
diff --git a/Doc/c-api/buffer.rst b/Doc/c-api/buffer.rst index 6cb474e..46c19d3 100644 --- a/Doc/c-api/buffer.rst +++ b/Doc/c-api/buffer.rst @@ -133,15 +133,15 @@ a buffer, see :c:func:`PyObject_GetBuffer`. called on non-NULL :c:member:`~Py_buffer.format` values. Important exception: If a consumer requests a buffer without the - :c:macro:`PyBUF_FORMAT` flag, :c:member:`~Py_Buffer.format` will + :c:macro:`PyBUF_FORMAT` flag, :c:member:`~Py_buffer.format` will be set to *NULL*, but :c:member:`~Py_buffer.itemsize` still has the value for the original format. - If :c:member:`~Py_Buffer.shape` is present, the equality + If :c:member:`~Py_buffer.shape` is present, the equality ``product(shape) * itemsize == len`` still holds and the consumer can use :c:member:`~Py_buffer.itemsize` to navigate the buffer. - If :c:member:`~Py_Buffer.shape` is *NULL* as a result of a :c:macro:`PyBUF_SIMPLE` + If :c:member:`~Py_buffer.shape` is *NULL* as a result of a :c:macro:`PyBUF_SIMPLE` or a :c:macro:`PyBUF_WRITABLE` request, the consumer must disregard :c:member:`~Py_buffer.itemsize` and assume ``itemsize == 1``. @@ -156,7 +156,7 @@ a buffer, see :c:func:`PyObject_GetBuffer`. .. c:member:: int ndim The number of dimensions the memory represents as an n-dimensional array. - If it is 0, :c:member:`~Py_Buffer.buf` points to a single item representing + If it is 0, :c:member:`~Py_buffer.buf` points to a single item representing a scalar. In this case, :c:member:`~Py_buffer.shape`, :c:member:`~Py_buffer.strides` and :c:member:`~Py_buffer.suboffsets` MUST be *NULL*. |
