對映協定¶
另請參閱 PyObject_GetItem()、PyObject_SetItem() 和 PyObject_DelItem()。
-
int PyMapping_Check(PyObject *o)¶
- 為 穩定 ABI 的一部分.
如果物件有提供對映協定或支援切片 (slicing) 則回傳
1，否則回傳0。請注意，對於具有__getitem__()方法的 Python 類別，它會回傳1，因為通常無法確定該類別支援什麼類型的鍵。這個函式總會是成功的。
-
Py_ssize_t PyMapping_Size(PyObject *o)¶
-
Py_ssize_t PyMapping_Length(PyObject *o)¶
- 為 穩定 ABI 的一部分.
成功時回傳物件 o 中的鍵數，失敗時回傳
-1。這相當於 Python 運算式len(o)。
-
PyObject *PyMapping_GetItemString(PyObject *o, const char *key)¶
- 回傳值：新的參照。 為 穩定 ABI 的一部分.
這與
PyObject_GetItem()相同，但 key 被指定為 const char* UTF-8 編碼位元組字串，而不是 PyObject*。
-
int PyMapping_SetItemString(PyObject *o, const char *key, PyObject *v)¶
- 為 穩定 ABI 的一部分.
這與
PyObject_SetItem()相同，但 key 被指定為 const char* UTF-8 編碼位元組字串，而不是 PyObject*。
-
int PyMapping_DelItem(PyObject *o, PyObject *key)¶
這是
PyObject_DelItem()的別名。
-
int PyMapping_DelItemString(PyObject *o, const char *key)¶
這與
PyObject_DelItem()相同，但 key 被指定為 const char* UTF-8 編碼位元組字串，而不是 PyObject*。
-
int PyMapping_HasKey(PyObject *o, PyObject *key)¶
- 為 穩定 ABI 的一部分.
如果對映物件具有鍵 key 則回傳
1，否則回傳0。這相當於 Python 運算式key in o。這個函式總會是成功的。備註
當它呼叫
__getitem__()方法時發生的例外將被默默忽略。為了適當地處理錯誤，請改用PyObject_GetItem()。
-
int PyMapping_HasKeyString(PyObject *o, const char *key)¶
- 為 穩定 ABI 的一部分.
這與
PyMapping_HasKey()相同，但 key 被指定為 const char* UTF-8 編碼位元組字串，而不是 PyObject*。備註
當它呼叫
__getitem__()方法或建立臨時str物件時發生的例外將被默默忽略。為了適當地處理錯誤，請改用PyMapping_GetItemString()。
-
PyObject *PyMapping_Keys(PyObject *o)¶
- 回傳值：新的參照。 為 穩定 ABI 的一部分.
成功時回傳一個物件 o 內之鍵的串列，失敗時回傳
NULL。在 3.7 版的變更: 在以前，該函式會回傳串列或元組。
-
PyObject *PyMapping_Values(PyObject *o)¶
- 回傳值：新的參照。 為 穩定 ABI 的一部分.
成功時回傳物件 o 中值的串列。失敗時回傳
NULL。在 3.7 版的變更: 在以前，該函式會回傳串列或元組。
-
PyObject *PyMapping_Items(PyObject *o)¶
- 回傳值：新的參照。 為 穩定 ABI 的一部分.
成功時回傳物件 o 內之項目的串列，其中每個項目都是包含鍵值對的元組。失敗時回傳
NULL。在 3.7 版的變更: 在以前，該函式會回傳串列或元組。