Set 物件

本節詳細介紹了 set 和 frozenset 物件的公共 API。任何未在此處列出的功能最好透過抽象物件協議（包括 PyObject_CallMethod()、 PyObject_RichCompareBool()、 PyObject_Hash()、 PyObject_Repr()、 PyObject_IsTrue()、 PyObject_Print() 和 PyObject_GetIter()）或抽象數字協議（包括 PyNumber_And()、 PyNumber_Subtract()、 PyNumber_Or()、 PyNumber_Xor()、 PyNumber_InPlaceAnd()、 PyNumber_InPlaceSubtract()、 PyNumber_InPlaceOr() 和 PyNumber_InPlaceXor()）訪問。

type PySetObject

此 PyObject 的子型別用於儲存 set 和 frozenset 物件的內部資料。它類似於 PyDictObject，因為它對於小型集合是固定大小的（很像元組儲存），並且對於中型和大型集合將指向一個單獨的、可變大小的記憶體塊（很像列表儲存）。此結構的任何欄位都不應被視為公共的，並且都可能發生更改。所有訪問都應透過已記錄的 API 進行，而不是透過操作結構中的值。

PyTypeObject PySet_Type

作為 穩定 ABI 的一部分。

這是 PyTypeObject 的一個例項，表示 Python set 型別。

PyTypeObject PyFrozenSet_Type

作為 穩定 ABI 的一部分。

這是 PyTypeObject 的一個例項，表示 Python frozenset 型別。

以下型別檢查宏適用於指向任何 Python 物件的指標。同樣，建構函式適用於任何可迭代的 Python 物件。

int PySet_Check(PyObject *p)

如果 p 是 set 物件或其子型別的例項，則返回真。此函式總是成功。

int PyFrozenSet_Check(PyObject *p)

如果 p 是 frozenset 物件或其子型別的例項，則返回真。此函式總是成功。

int PyAnySet_Check(PyObject *p)

如果 p 是 set 物件、 frozenset 物件或其子型別的例項，則返回真。此函式總是成功。

int PySet_CheckExact(PyObject *p)

如果 p 是 set 物件而不是其子型別的例項，則返回真。此函式總是成功。

在 3.10 版本加入。

int PyAnySet_CheckExact(PyObject *p)

如果 p 是 set 物件或 frozenset 物件而不是其子型別的例項，則返回真。此函式總是成功。

int PyFrozenSet_CheckExact(PyObject *p)

如果 p 是 frozenset 物件而不是其子型別的例項，則返回真。此函式總是成功。

PyObject *PySet_New(PyObject *iterable)

返回值: 新引用。 穩定ABI 的一部分。

返回一個新的 set，其中包含 iterable 返回的物件。 iterable 可以為 NULL 以建立一個新的空集合。成功時返回新的集合，失敗時返回 NULL。如果 iterable 實際上不可迭代，則引發 TypeError。此建構函式也可用於複製集合（c=set(s)）。

PyObject *PyFrozenSet_New(PyObject *iterable)

返回值: 新引用。 穩定ABI 的一部分。

返回一個新的 frozenset，其中包含 iterable 返回的物件。 iterable 可以為 NULL 以建立一個新的空 frozenset。成功時返回新的集合，失敗時返回 NULL。如果 iterable 實際上不可迭代，則引發 TypeError。

以下函式和宏適用於 set 或 frozenset 的例項或其子型別的例項。

Py_ssize_t PySet_Size(PyObject *anyset)

作為 穩定 ABI 的一部分。

返回 set 或 frozenset 物件的長度。等同於 len(anyset)。如果 anyset 不是 set、 frozenset 或其子型別的例項，則引發 SystemError。

Py_ssize_t PySet_GET_SIZE(PyObject *anyset)

PySet_Size() 的宏形式，不帶錯誤檢查。

int PySet_Contains(PyObject *anyset, PyObject *key)

作為 穩定 ABI 的一部分。

如果找到，返回 1；如果未找到，返回 0；如果遇到錯誤，返回 -1。與 Python 的 __contains__() 方法不同，此函式不會自動將不可雜湊的集合轉換為臨時的 frozenset。如果 key 不可雜湊，則引發 TypeError。如果 anyset 不是 set、 frozenset 或其子型別的例項，則引發 SystemError。

int PySet_Add(PyObject *set, PyObject *key)

作為 穩定 ABI 的一部分。

將 key 新增到 set 例項。也適用於 frozenset 例項（就像 PyTuple_SetItem() 一樣，它可以在新的 frozenset 暴露給其他程式碼之前用於填充其值）。成功時返回 0，失敗時返回 -1。如果 key 不可雜湊，則引發 TypeError。如果沒有足夠的空間增長，則引發 MemoryError。如果 set 不是 set 或其子型別的例項，則引發 SystemError。

以下函式適用於 set 的例項或其子型別，但不適用於 frozenset 的例項或其子型別。

int PySet_Discard(PyObject *set, PyObject *key)

作為 穩定 ABI 的一部分。

如果找到並移除，返回 1；如果未找到（未採取任何操作），返回 0；如果遇到錯誤，返回 -1。對於缺失的鍵不引發 KeyError。如果 key 不可雜湊，則引發 TypeError。與 Python 的 discard() 方法不同，此函式不會自動將不可雜湊的集合轉換為臨時的 frozenset。如果 set 不是 set 或其子型別的例項，則引發 SystemError。

PyObject *PySet_Pop(PyObject *set)

返回值: 新引用。 穩定ABI 的一部分。

返回 set 中任意物件的新引用，並從 set 中移除該物件。失敗時返回 NULL。如果集合為空，則引發 KeyError。如果 set 不是 set 或其子型別的例項，則引發 SystemError。

int PySet_Clear(PyObject *set)

作為 穩定 ABI 的一部分。

清空現有集合的所有元素。成功時返回 0。如果 set 不是 set 或其子型別的例項，則返回 -1 並引發 SystemError。