マッピングプロトコル—Pythonドキュメント

マッピングプロトコル

int PyMapping_Check(PyObject *o)

オブジェクトがマッピングプロトコルを提供する場合は1を返し、それ以外の場合は0を返します。 この関数は常に成功します。

Py_ssize_t PyMapping_Size(PyObject *o)

Py_ssize_t PyMapping_Length(PyObject *o)

成功した場合はオブジェクト o のキーの数を返し、失敗した場合は-1のキーの数を返します。 マッピングプロトコルを提供しないオブジェクトの場合、これはPython式len(o)と同等です。

バージョン2.5で変更：これらの関数はintタイプを返しました。 これには、64ビットシステムを適切にサポートするためにコードの変更が必要になる場合があります。

int PyMapping_DelItemString(PyObject *o, char *key)

オブジェクトキーのマッピングをオブジェクト o から削除します。 失敗した場合は-1を返します。 これは、Pythonステートメントdel o[key]と同等です。

int PyMapping_DelItem(PyObject *o, PyObject *key)

オブジェクトキーのマッピングをオブジェクト o から削除します。 失敗した場合は-1を返します。 これは、Pythonステートメントdel o[key]と同等です。

int PyMapping_HasKeyString(PyObject *o, char *key)

成功した場合、マッピングオブジェクトにキー key がある場合は1を返し、そうでない場合は0を返します。 これはo[key]と同等であり、成功した場合はTrueを返し、例外の場合はFalseを返します。 この関数は常に成功します。

int PyMapping_HasKey(PyObject *o, PyObject *key)

マッピングオブジェクトにキー key がある場合は1を返し、そうでない場合は0を返します。 これはo[key]と同等であり、成功した場合はTrueを返し、例外の場合はFalseを返します。 この関数は常に成功します。

PyObject *PyMapping_Keys(PyObject *o)

成功すると、オブジェクト o のキーのリストを返します。 失敗した場合は、 NULL を返します。 これは、Python式o.keys()と同等です。

PyObject *PyMapping_Values(PyObject *o)

成功すると、オブジェクト o の値のリストを返します。 失敗した場合は、 NULL を返します。 これは、Python式o.values()と同等です。

PyObject *PyMapping_Items(PyObject *o)

成功すると、オブジェクト o 内のアイテムのリストを返します。各アイテムは、キーと値のペアを含むタプルです。 失敗した場合は、 NULL を返します。 これは、Python式o.items()と同等です。

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

失敗した場合、オブジェクト key または NULL に対応する o の要素を返します。 これは、Python式o[key]と同等です。

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

オブジェクトキーをオブジェクト o の値 v にマップします。 失敗すると-1を返します。 これは、Pythonステートメントo[key] = vと同等です。