字典對(duì)象

type PyDictObject

創(chuàng)新互聯(lián)公司專(zhuān)注于企業(yè)成都全網(wǎng)營(yíng)銷(xiāo)推廣、網(wǎng)站重做改版、繁昌網(wǎng)站定制設(shè)計(jì)、自適應(yīng)品牌網(wǎng)站建設(shè)、html5、成都商城網(wǎng)站開(kāi)發(fā)、集團(tuán)公司官網(wǎng)建設(shè)、成都外貿(mào)網(wǎng)站建設(shè)公司、高端網(wǎng)站制作、響應(yīng)式網(wǎng)頁(yè)設(shè)計(jì)等建站業(yè)務(wù)，價(jià)格優(yōu)惠性價(jià)比高，為繁昌等各大城市提供網(wǎng)站開(kāi)發(fā)制作服務(wù)。

這個(gè) PyObject 的子類(lèi)型代表一個(gè)python字典對(duì)象。

PyTypeObject PyDict_Type

Part of the Stable ABI.

Python字典類(lèi)型表示為 PyTypeObject 的實(shí)例。這與Python層面的 dict 是相同的對(duì)象。

int PyDict_Check(PyObject *p)

如果 p 是一個(gè) dict 對(duì)象或者 dict 類(lèi)型的子類(lèi)型的實(shí)例則返回真值。 此函數(shù)總是會(huì)成功執(zhí)行。

int PyDict_CheckExact(PyObject *p)

如果 p 是一個(gè) dict 對(duì)象但不是 dict 類(lèi)型的子類(lèi)型的實(shí)例則返回真值。 此函數(shù)總是會(huì)成功執(zhí)行。

PyObject *PyDict_New()

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

返回一個(gè)新的空字典，失敗時(shí)返回 NULL。

PyObject *PyDictProxy_New(PyObject *mapping)

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

返回 types.MappingProxyType 對(duì)象，用于強(qiáng)制執(zhí)行只讀行為的映射。這通常用于創(chuàng)建視圖以防止修改非動(dòng)態(tài)類(lèi)類(lèi)型的字典。

void PyDict_Clear(PyObject *p)

Part of the Stable ABI.

清空現(xiàn)有字典的所有鍵值對(duì)。

int PyDict_Contains(PyObject *p, PyObject *key)

Part of the Stable ABI.

確定 key 是否包含在字典 p 中。如果 key 匹配上 p 的某一項(xiàng)，則返回 1 ，否則返回 0 。返回 -1 表示出錯(cuò)。這等同于Python表達(dá)式 key in p 。

PyObject *PyDict_Copy(PyObject *p)

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

返回與 p 包含相同鍵值對(duì)的新字典。

int PyDict_SetItem(PyObject *p, PyObject *key, PyObject *val)

Part of the Stable ABI.

使用 key 作為鍵將 val 插入字典 p。 key 必須為 hashable；如果不是，則將引發(fā) TypeError。 成功時(shí)返回 0，失敗時(shí)返回 -1。 此函數(shù) 不會(huì) 附帶對(duì) val 的引用。

int PyDict_SetItemString(PyObject *p, const char *key, PyObject *val)

Part of the Stable ABI.

Insert val into the dictionary p using key as a key. key should be a const char*. The key object is created using PyUnicode_FromString(key). Return 0 on success or -1 on failure. This function does not steal a reference to val.

int PyDict_DelItem(PyObject *p, PyObject *key)

Part of the Stable ABI.

移除字典 p 中鍵為 key 的條目。 key 必須是可哈希的；如果不是，則會(huì)引發(fā) TypeError。 如果字典中沒(méi)有 key，則會(huì)引發(fā) KeyError。 成功時(shí)返回 0，失敗時(shí)返回 -1。

int PyDict_DelItemString(PyObject *p, const char *key)

Part of the Stable ABI.

移除字典 p 中由字符串 key 指定的鍵的條目。 如果字典中沒(méi)有 key，則會(huì)引發(fā) KeyError。 成功時(shí)返回 0，失敗時(shí)返回 -1。

PyObject *PyDict_GetItem(PyObject *p, PyObject *key)

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

從字典 p 中返回以 key 為鍵的對(duì)象。 如果鍵名 key 不存在但 沒(méi)有 設(shè)置一個(gè)異常則返回 NULL。

需要注意的是，調(diào)用 __hash__() 和 __eq__() 方法產(chǎn)生的異常不會(huì)被拋出。改用 PyDict_GetItemWithError() 獲得錯(cuò)誤報(bào)告。

在 3.10 版更改: 在不保持 GIL 的情況下調(diào)用此 API 曾因歷史原因而被允許。 現(xiàn)在已不再被允許。

PyObject *PyDict_GetItemWithError(PyObject *p, PyObject *key)

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

PyDict_GetItem() 的變種，它不會(huì)屏蔽異常。 當(dāng)異常發(fā)生時(shí)將返回 NULL 并且 設(shè)置一個(gè)異常。 如果鍵不存在則返回 NULL 并且不會(huì) 設(shè)置一個(gè)異常。

PyObject *PyDict_GetItemString(PyObject *p, const char *key)

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

This is the same as PyDict_GetItem(), but key is specified as a const char*, rather than a PyObject*.

需要注意的是，調(diào)用 __hash__() 、 __eq__() 方法和創(chuàng)建一個(gè)臨時(shí)的字符串對(duì)象時(shí)產(chǎn)生的異常不會(huì)被拋出。改用 PyDict_GetItemWithError() 獲得錯(cuò)誤報(bào)告。

PyObject *PyDict_SetDefault(PyObject *p, PyObject *key, PyObject *defaultobj)

Return value: Borrowed reference.

這跟Python層面的 dict.setdefault() 一樣。如果鍵 key 存在，它返回在字典 p 里面對(duì)應(yīng)的值。如果鍵不存在，它會(huì)和值 defaultobj 一起插入并返回 defaultobj 。這個(gè)函數(shù)只計(jì)算 key 的哈希函數(shù)一次，而不是在查找和插入時(shí)分別計(jì)算它。

3.4 新版功能.

PyObject *PyDict_Items(PyObject *p)

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

返回一個(gè)包含字典中所有鍵值項(xiàng)的 PyListObject。

PyObject *PyDict_Keys(PyObject *p)

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

返回一個(gè)包含字典中所有鍵(keys)的 PyListObject。

PyObject *PyDict_Values(PyObject *p)

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

返回一個(gè)包含字典中所有值(values)的 PyListObject。

Py_ssize_t PyDict_Size(PyObject *p)

Part of the Stable ABI.

返回字典中項(xiàng)目數(shù)，等價(jià)于對(duì)字典 p 使用 len(p)。

int PyDict_Next(PyObject *p, Py_ssize_t *ppos, PyObject **pkey, PyObject **pvalue)

Part of the Stable ABI.

Iterate over all key-value pairs in the dictionary p. The Py_ssize_t referred to by ppos must be initialized to 0 prior to the first call to this function to start the iteration; the function returns true for each pair in the dictionary, and false once all pairs have been reported. The parameters pkey and pvalue should either point to PyObject* variables that will be filled in with each key and value, respectively, or may be NULL. Any references returned through them are borrowed. ppos should not be altered during iteration. Its value represents offsets within the internal dictionary structure, and since the structure is sparse, the offsets are not consecutive.

例如：

 
 
 
 

  
  
  
  
PyObject *key, *value;
  
  
  
  
Py_ssize_t pos = 0;
  
  
  
  

  
  
  
  
while (PyDict_Next(self->dict, &pos, &key, &value)) {
  
  
  
  
 /* do something interesting with the values... */
  
  
  
  
 ...
  
  
  
  
}
 
 
 
 

字典 p 不應(yīng)該在遍歷期間發(fā)生改變。在遍歷字典時(shí)，改變鍵中的值是安全的，但僅限于鍵的集合不發(fā)生改變。例如:

 
 
 
 

  
  
  
  
PyObject *key, *value;
  
  
  
  
Py_ssize_t pos = 0;
  
  
  
  

  
  
  
  
while (PyDict_Next(self->dict, &pos, &key, &value)) {
  
  
  
  
 long i = PyLong_AsLong(value);
  
  
  
  
 if (i == -1 && PyErr_Occurred()) {
  
  
  
  
 return -1;
  
  
  
  
 }
  
  
  
  
 PyObject *o = PyLong_FromLong(i + 1);
  
  
  
  
 if (o == NULL)
  
  
  
  
 return -1;
  
  
  
  
 if (PyDict_SetItem(self->dict, key, o) < 0) {
  
  
  
  
 Py_DECREF(o);
  
  
  
  
 return -1;
  
  
  
  
 }
  
  
  
  
 Py_DECREF(o);
  
  
  
  
}
 
 
 
 

int PyDict_Merge(PyObject *a, PyObject *b, int override)

Part of the Stable ABI.

對(duì)映射對(duì)象 b 進(jìn)行迭代，將鍵值對(duì)添加到字典 a。 b 可以是一個(gè)字典，或任何支持 PyMapping_Keys() 和 PyObject_GetItem() 的對(duì)象。 如果 override 為真值，則如果在 b 中找到相同的鍵則 a 中已存在的相應(yīng)鍵值對(duì)將被替換，否則如果在 a 中沒(méi)有相同的鍵則只是添加鍵值對(duì)。 當(dāng)成功時(shí)返回 0 或者當(dāng)引發(fā)異常時(shí)返回 -1。

int PyDict_Update(PyObject *a, PyObject *b)

Part of the Stable ABI.

這與 C 中的 PyDict_Merge(a, b, 1) 一樣，也類(lèi)似于 Python 中的 a.update(b)，差別在于 PyDict_Update() 在第二個(gè)參數(shù)沒(méi)有 “keys” 屬性時(shí)不會(huì)回退到迭代鍵值對(duì)的序列。 當(dāng)成功時(shí)返回 0 或者當(dāng)引發(fā)異常時(shí)返回 -1。

int PyDict_MergeFromSeq2(PyObject *a, PyObject *seq2, int override)

Part of the Stable ABI.

將 seq2 中的鍵值對(duì)更新或合并到字典 a。 seq2 必須為產(chǎn)生長(zhǎng)度為 2 的用作鍵值對(duì)的元素的可迭代對(duì)象。 當(dāng)存在重復(fù)的鍵時(shí)，如果 override 真值則最后出現(xiàn)的鍵勝出。 當(dāng)成功時(shí)返回 0 或者當(dāng)引發(fā)異常時(shí)返回 -1。 等價(jià)的 Python 代碼（返回值除外）:

 
 
 
 

  
  
  
  
def PyDict_MergeFromSeq2(a, seq2, override):
  
  
  
  
 for key, value in seq2:
  
  
  
  
 if override or key not in a:
  
  
  
  
 a[key] = value
 
 
 
 

當(dāng)前標(biāo)題：創(chuàng)新互聯(lián)Python教程：字典對(duì)象
瀏覽路徑：http://m.5511xx.com/article/dhsocgh.html