6.4 マップ型プロトコル (mapping protocol)

int PyMapping_Check( PyObject *o): オブジェクトがマップ型プロトコルを提供している場合に 1 を返し、そうでないときには 0 を返します。この関数呼び出しは常に成功します。

Py_ssize_t PyMapping_Length( PyObject *o): 成功するとオブジェクト o 中のキーの数を返し、失敗すると -1 を返します。マップ型プロトコルを提供していないオブジェクトに対しては、 Python の式 "len(o)" と同じになります。

int PyMapping_DelItemString( PyObject *o, char *key): オブジェクト o から key に関する対応付けを削除します。失敗すると -1 を返します。 Python の文 "del o[key]" と同じです。

int PyMapping_DelItem( PyObject *o, PyObject *key): オブジェクト o から key に対する対応付けを削除します。失敗すると -1 を返します。 Python の文 "del o[key]" と同じです。

int PyMapping_HasKeyString( PyObject *o, char *key): 成功すると、マップ型オブジェクトがキー key を持つ場合に 1 を返し、そうでないときには 0 を返します。 Python の式 "o.has_key(key)" と同じです。この関数呼び出しは常に成功します。

int PyMapping_HasKey( PyObject *o, PyObject *key): マップ型オブジェクトがキー key を持つ場合に 1 を返し、そうでないときには 0 を返します。 Python の式 "o.has_key(key)" と同じです。この関数呼び出しは常に成功します。

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 に対応するo の要素を返します。失敗すると NULLを返します。 Python の式 "o[key]" と同じです。

int PyMapping_SetItemString( PyObject *o, char *key, PyObject *v): オブジェクトo で key を値 v に対応付けます。失敗すると -1 を返します。 Python の文 "o[key] = v" と同じです。

ご意見やご指摘をお寄せになりたい方は、 このドキュメントについて... をご覧ください。