Протокол відображення¶
Дивіться також PyObject_GetItem()
, PyObject_SetItem()
і PyObject_DelItem()
.
-
int
PyMapping_Check
(PyObject *o)¶ Return
1
if the object provides the mapping protocol or supports slicing, and0
otherwise. Note that it returns1
for Python classes with a__getitem__()
method, since in general it is impossible to determine what type of keys the class supports. This function always succeeds.
-
Py_ssize_t
PyMapping_Size
(PyObject *o)¶ -
Py_ssize_t
PyMapping_Length
(PyObject *o)¶ Повертає кількість ключів в об’єкті o в разі успіху та
-1
у разі невдачі. Це еквівалентно виразу Pythonlen(o)
.
-
PyObject*
PyMapping_GetItemString
(PyObject *o, const char *key)¶ - Return value: New reference.
Return element of o corresponding to the string key or
NULL
on failure. This is the equivalent of the Python expressiono[key]
. See alsoPyObject_GetItem()
.
-
int
PyMapping_SetItemString
(PyObject *o, const char *key, PyObject *v)¶ Map the string key to the value v in object o. Returns
-1
on failure. This is the equivalent of the Python statemento[key] = v
. See alsoPyObject_SetItem()
. This function does not steal a reference to v.
-
int
PyMapping_DelItem
(PyObject *o, PyObject *key)¶ Remove the mapping for the object key from the object o. Return
-1
on failure. This is equivalent to the Python statementdel o[key]
. This is an alias ofPyObject_DelItem()
.
-
int
PyMapping_DelItemString
(PyObject *o, const char *key)¶ Remove the mapping for the string key from the object o. Return
-1
on failure. This is equivalent to the Python statementdel o[key]
.
-
int
PyMapping_HasKey
(PyObject *o, PyObject *key)¶ Повертає
1
, якщо об’єкт зіставлення має ключ key, і0
інакше. Це еквівалентно виразу Pythonkey in o
. Ця функція завжди успішна.Note that exceptions which occur while calling the
__getitem__()
method will get suppressed. To get error reporting usePyObject_GetItem()
instead.
-
int
PyMapping_HasKeyString
(PyObject *o, const char *key)¶ Повертає
1
, якщо об’єкт зіставлення має ключ key, і0
інакше. Це еквівалентно виразу Pythonkey in o
. Ця функція завжди успішна.Note that exceptions which occur while calling the
__getitem__()
method and creating a temporary string object will get suppressed. To get error reporting usePyMapping_GetItemString()
instead.
-
PyObject*
PyMapping_Keys
(PyObject *o)¶ - Return value: New reference.
У разі успіху повертає список ключів в об’єкті o. У разі помилки поверніть
NULL
.Змінено в версії 3.7: Раніше функція повертала список або кортеж.