映射協(xié)議?

參見(jiàn) PyObject_GetItem()、PyObject_SetItem() 與 PyObject_DelItem()。

int PyMapping_Check(PyObject *o)?

Part of the Stable ABI.

Return 1 if the object provides the mapping protocol or supports slicing, and 0 otherwise. Note that it returns 1 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)?

Part of the Stable ABI.

成功時(shí)返回對(duì)象 o 中鍵的數(shù)量，失敗時(shí)返回 -1。 這相當(dāng)于 Python 表達(dá)式 len(o)。

PyObject *PyMapping_GetItemString(PyObject *o, const char *key)?

Return value: New reference. Part of the Stable ABI.

返回 o 中對(duì)應(yīng)于字符串 key 的元素，或者失敗時(shí)返回 NULL。 這相當(dāng)于 Python 表達(dá)式 o[key]。 另請(qǐng)參見(jiàn) also PyObject_GetItem()。

int PyMapping_SetItemString(PyObject *o, const char *key, PyObject *v)?

Part of the Stable ABI.

在對(duì)象 o 中將字符串 key 映射到值 v。 失敗時(shí)返回 -1。 這相當(dāng)于 Python 語(yǔ)句 o[key] = v。 另請(qǐng)參見(jiàn) PyObject_SetItem()。 此函數(shù) 不會(huì) 增加對(duì) v 的引用。

int PyMapping_DelItem(PyObject *o, PyObject *key)?

從對(duì)象 o 中移除對(duì)象 key 的映射。 失敗時(shí)返回 -1。 這相當(dāng)于 Python 語(yǔ)句 del o[key]。 這是 PyObject_DelItem() 的一個(gè)別名。

int PyMapping_DelItemString(PyObject *o, const char *key)?

從對(duì)象 o 中移除字符串 key 的映射。 失敗時(shí)返回 -1。 這相當(dāng)于 Python 語(yǔ)句 del o[key]。

int PyMapping_HasKey(PyObject *o, PyObject *key)?

Part of the Stable ABI.

如果映射對(duì)象具有鍵 key 則返回 1，否則返回 0。 這相當(dāng)于 Python 表達(dá)式 key in o。 此函數(shù)總是會(huì)成功執(zhí)行。

請(qǐng)注意在調(diào)用 __getitem__() 方法期間發(fā)生的異常將會(huì)被屏蔽。 要獲取錯(cuò)誤報(bào)告請(qǐng)改用 PyObject_GetItem()。

int PyMapping_HasKeyString(PyObject *o, const char *key)?

Part of the Stable ABI.

如果映射對(duì)象具有鍵 key 則返回 1，否則返回 0。 這相當(dāng)于 Python 表達(dá)式 key in o。 此函數(shù)總是會(huì)成功執(zhí)行。

請(qǐng)注意在調(diào)用 __getitem__() 方法期間發(fā)生的異常將會(huì)被屏蔽。 要獲取錯(cuò)誤報(bào)告請(qǐng)改用 PyMapping_GetItemString()。

PyObject *PyMapping_Keys(PyObject *o)?

Return value: New reference. Part of the Stable ABI.

成功時(shí)，返回對(duì)象 o 中的鍵的列表。 失敗時(shí)，返回 NULL。

在 3.7 版更改: 在之前版本中，此函數(shù)返回一個(gè)列表或元組。

PyObject *PyMapping_Values(PyObject *o)?

Return value: New reference. Part of the Stable ABI.

成功時(shí)，返回對(duì)象 o 中的值的列表。 失敗時(shí)，返回 NULL。

在 3.7 版更改: 在之前版本中，此函數(shù)返回一個(gè)列表或元組。

PyObject *PyMapping_Items(PyObject *o)?

Return value: New reference. Part of the Stable ABI.

成功時(shí)，返回對(duì)象 o 中條目的列表，其中每個(gè)條目是一個(gè)包含鍵值對(duì)的元組。 失敗時(shí)，返回 NULL。

在 3.7 版更改: 在之前版本中，此函數(shù)返回一個(gè)列表或元組。