diff options
| author | Erlend E. Aasland <erlend@python.org> | 2023-08-11 16:03:53 (GMT) |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2023-08-11 16:03:53 (GMT) |
| commit | 637f7ff2c60f262659da0334f1cb672bd361f398 (patch) | |
| tree | 2dc3a5b6b96fc1f25373228b2269a02ee9fbb64f /Doc/c-api/buffer.rst | |
| parent | 3901c991e169da6fba8c0033a86a6f2e6146bb7f (diff) | |
| download | cpython-637f7ff2c60f262659da0334f1cb672bd361f398.zip cpython-637f7ff2c60f262659da0334f1cb672bd361f398.tar.gz cpython-637f7ff2c60f262659da0334f1cb672bd361f398.tar.bz2 | |
Docs: Document PyBUF_MAX_NDIM (#107865)
Diffstat (limited to 'Doc/c-api/buffer.rst')
| -rw-r--r-- | Doc/c-api/buffer.rst | 10 |
1 files changed, 7 insertions, 3 deletions
diff --git a/Doc/c-api/buffer.rst b/Doc/c-api/buffer.rst index 8ca1c19..ba391a5 100644 --- a/Doc/c-api/buffer.rst +++ b/Doc/c-api/buffer.rst @@ -161,10 +161,14 @@ a buffer, see :c:func:`PyObject_GetBuffer`. 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``. + The maximum number of dimensions is given by :c:macro:`PyBUF_MAX_NDIM`. - The macro :c:macro:`PyBUF_MAX_NDIM` limits the maximum number of dimensions - to 64. Exporters MUST respect this limit, consumers of multi-dimensional - buffers SHOULD be able to handle up to :c:macro:`PyBUF_MAX_NDIM` dimensions. + .. :c:macro:: PyBUF_MAX_NDIM + + The maximum number of dimensions the memory represents. + Exporters MUST respect this limit, consumers of multi-dimensional + buffers SHOULD be able to handle up to :c:macro:`!PyBUF_MAX_NDIM` dimensions. + Currently set to 64. .. c:member:: Py_ssize_t *shape |