Protocolo de Mapeamento¶
Veja também PyObject_GetItem()
, PyObject_SetItem()
e PyObject_DelItem()
.
-
int
PyMapping_Check
(PyObject *o)¶ Return
1
if the object provides mapping protocol or supports slicing, and0
otherwise. Note that it returns1
for Python classes with a__getitem__()
method since in general case it is impossible to determine what the type of keys it supports. This function always succeeds.
-
Py_ssize_t
PyMapping_Size
(PyObject *o)¶ -
Py_ssize_t
PyMapping_Length
(PyObject *o)¶ Retorna o número de chaves no objeto o em caso de sucesso e
-1
em caso de falha. Isso é equivalente à expressão 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 expression
o[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()
.
-
int
PyMapping_DelItem
(PyObject *o, PyObject *key)¶ Remove o mapeamento para o objeto key do objeto o. Retorna
-1
em caso de falha. Isso é equivalente à instrução Pythondel o[key]
. Este é um alias dePyObject_DelItem()
.
-
int
PyMapping_DelItemString
(PyObject *o, const char *key)¶ Remove o mapeamento para a string key do objeto o. Retorna
-1
em caso de falha. Isso é equivalente à instrução Pythondel o[key]
.
-
int
PyMapping_HasKey
(PyObject *o, PyObject *key)¶ Retorna
1
se o objeto de mapeamento tiver a chave key e0
caso contrário. Isso é equivalente à expressão Pythonkey in o
. Esta função sempre tem sucesso.Observe que as exceções que ocorrem ao chamar o método
__getitem__()
serão suprimidas. Para obter relatórios de erros, usePyObject_GetItem()
.
-
int
PyMapping_HasKeyString
(PyObject *o, const char *key)¶ Retorna
1
se o objeto de mapeamento tiver a chave key e0
caso contrário. Isso é equivalente à expressão Pythonkey in o
. Esta função sempre tem sucesso.Observe que as exceções que ocorrem ao chamar o método
__getitem__()
e criar um objeto string temporário serão suprimidas. Para obter relatórios de erros, usePyMapping_GetItemString()
.
-
PyObject*
PyMapping_Keys
(PyObject *o)¶ - Return value: New reference.
On success, return a list or tuple of the keys in object o. On failure, return NULL.