Mirror
/
cpython
mirror of https://github.com/python/cpython
4
1
Fork 0
Code Issues Releases Wiki Activity

Reformat paragraph.

This commit is contained in:
Jeroen Ruigrok van der Werven 2009-04-25 14:28:02 +00:00
parent 325a997efb
commit 6f1d543133
1 changed files with 10 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
Doc/c-api/dict.rst
View File

@ -146,16 +146,16 @@ Dictionary Objects
.. cfunction:: int PyDict_Next(PyObject *p, Py_ssize_t *ppos, PyObject **pkey, PyObject **pvalue)
Iterate over all key-value pairs in the dictionary *p*. The :ctype:`Py_ssize_t`
referred to by *ppos* must be initialized to ``0`` prior to the first call
to this function to start the iteration; the function returns true for each
pair in the dictionary, and false once all pairs have been reported. The
parameters *pkey* and *pvalue* should either point to :ctype:`PyObject\*`
variables that will be filled in with each key and value, respectively, or
may be *NULL*. Any references returned through them are borrowed. *ppos*
should not be altered during iteration. Its value represents offsets within
the internal dictionary structure, and since the structure is sparse, the
offsets are not consecutive.
Iterate over all key-value pairs in the dictionary *p*. The
:ctype:`Py_ssize_t` referred to by *ppos* must be initialized to ``0``
prior to the first call to this function to start the iteration; the
function returns true for each pair in the dictionary, and false once all
pairs have been reported. The parameters *pkey* and *pvalue* should either
point to :ctype:`PyObject\*` variables that will be filled in with each key
and value, respectively, or may be *NULL*. Any references returned through
them are borrowed. *ppos* should not be altered during iteration. Its
value represents offsets within the internal dictionary structure, and
since the structure is sparse, the offsets are not consecutive.
For example::