See also PyObject_GetItem()
, PyObject_SetItem()
and PyObject_DelItem()
.
PyMapping_Check
Return 1
if the object provides mapping protocol or supports slicing, and 0
otherwise. Note that it returns 1
for Python classes with a __getitem__()
method since in general case it is impossible to determine what type of keys it supports. This function always succeeds.
PyMapping_Size
PyMapping_Length
Returns the number of keys in object o on success, and -1
on failure. This is equivalent to the Python expression len(o)
.
PyMapping_GetItemString
Return element of o corresponding to the string key or NULL
on failure. This is the equivalent of the Python expression o[key]
. See also PyObject_GetItem()
.
PyMapping_SetItemString
Map the string key to the value v in object o. Returns -1
on failure. This is the equivalent of the Python statement o[key] = v
. See also PyObject_SetItem()
. This function does not steal a reference to v.
PyMapping_DelItem
Remove the mapping for the object key from the object o. Return -1
on failure. This is equivalent to the Python statement del o[key]
. This is an alias of PyObject_DelItem()
.
PyMapping_DelItemString
Remove the mapping for the string key from the object o. Return -1
on failure. This is equivalent to the Python statement del o[key]
.
PyMapping_HasKey
Return 1
if the mapping object has the key key and 0
otherwise. This is equivalent to the Python expression key in o
. This function always succeeds.
Note that exceptions which occur while calling the __getitem__()
method will get suppressed. To get error reporting use PyObject_GetItem()
instead.
PyMapping_HasKeyString
Return 1
if the mapping object has the key key and 0
otherwise. This is equivalent to the Python expression key in o
. This function always succeeds.
Note that exceptions which occur while calling the __getitem__()
method and creating a temporary string object will get suppressed. To get error reporting use PyMapping_GetItemString()
instead.
PyMapping_Keys
On success, return a list of the keys in object o. On failure, return NULL
.
Changed in version 3.7: Previously, the function returned a list or a tuple.
PyMapping_Values
On success, return a list of the values in object o. On failure, return NULL
.
Changed in version 3.7: Previously, the function returned a list or a tuple.
PyMapping_Items
On success, return a list of the items in object o, where each item is a tuple containing a key-value pair. On failure, return NULL
.
Changed in version 3.7: Previously, the function returned a list or a tuple.