From: Pieter Eendebak Date: Wed, 22 May 2024 12:52:36 +0000 (+0200) Subject: gh-119391: Amend comment description of PyMapping_Items, PyMapping_Values and PyMappi... X-Git-Tag: v3.14.0a1~1805 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=d472b4f9fa4fb6061588d421f33a0388a2005bc6;p=thirdparty%2FPython%2Fcpython.git gh-119391: Amend comment description of PyMapping_Items, PyMapping_Values and PyMapping_Keys (#119392) The behaviour was changed in 0ccc0f6c7. --- diff --git a/Include/abstract.h b/Include/abstract.h index bd12a54963c1..f0e49c1afb81 100644 --- a/Include/abstract.h +++ b/Include/abstract.h @@ -852,15 +852,15 @@ PyAPI_FUNC(int) PyMapping_HasKeyWithError(PyObject *o, PyObject *key); PyAPI_FUNC(int) PyMapping_HasKeyStringWithError(PyObject *o, const char *key); -/* On success, return a list or tuple of the keys in mapping object 'o'. +/* On success, return a list of the keys in mapping object 'o'. On failure, return NULL. */ PyAPI_FUNC(PyObject *) PyMapping_Keys(PyObject *o); -/* On success, return a list or tuple of the values in mapping object 'o'. +/* On success, return a list of the values in mapping object 'o'. On failure, return NULL. */ PyAPI_FUNC(PyObject *) PyMapping_Values(PyObject *o); -/* On success, return a list or tuple of the items in mapping object 'o', +/* On success, return a list of the items in mapping object 'o', where each item is a tuple containing a key-value pair. On failure, return NULL. */ PyAPI_FUNC(PyObject *) PyMapping_Items(PyObject *o);