set.po

# Copyright (C) 2001 Python Software Foundation
# This file is distributed under the same license as the Python package.
#
# Translators:
msgid ""
msgstr ""
"Project-Id-Version: Python 3.14\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2026-04-12 00:25+0000\n"
"PO-Revision-Date: 2018-05-23 14:07+0000\n"
"Last-Translator: Adrian Liaw <adrianliaw2000@gmail.com>\n"
"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
"tw)\n"
"Language: zh_TW\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Plural-Forms: nplurals=1; plural=0;\n"

#: ../../c-api/set.rst:6
msgid "Set Objects"
msgstr "集合物件"

#: ../../c-api/set.rst:15
msgid ""
"This section details the public API for :class:`set` and :class:`frozenset` "
"objects.  Any functionality not listed below is best accessed using either "
"the abstract object protocol (including :c:func:`PyObject_CallMethod`, :c:"
"func:`PyObject_RichCompareBool`, :c:func:`PyObject_Hash`, :c:func:"
"`PyObject_Repr`, :c:func:`PyObject_IsTrue`, :c:func:`PyObject_Print`, and :c:"
"func:`PyObject_GetIter`) or the abstract number protocol (including :c:func:"
"`PyNumber_And`, :c:func:`PyNumber_Subtract`, :c:func:`PyNumber_Or`, :c:func:"
"`PyNumber_Xor`, :c:func:`PyNumber_InPlaceAnd`, :c:func:"
"`PyNumber_InPlaceSubtract`, :c:func:`PyNumber_InPlaceOr`, and :c:func:"
"`PyNumber_InPlaceXor`)."
msgstr ""

#: ../../c-api/set.rst:29
msgid ""
"This subtype of :c:type:`PyObject` is used to hold the internal data for "
"both :class:`set` and :class:`frozenset` objects.  It is like a :c:type:"
"`PyDictObject` in that it is a fixed size for small sets (much like tuple "
"storage) and will point to a separate, variable sized block of memory for "
"medium and large sized sets (much like list storage). None of the fields of "
"this structure should be considered public and all are subject to change.  "
"All access should be done through the documented API rather than by "
"manipulating the values in the structure."
msgstr ""

#: ../../c-api/set.rst:40
msgid ""
"This is an instance of :c:type:`PyTypeObject` representing the Python :class:"
"`set` type."
msgstr ""

#: ../../c-api/set.rst:46
msgid ""
"This is an instance of :c:type:`PyTypeObject` representing the Python :class:"
"`frozenset` type."
msgstr ""

#: ../../c-api/set.rst:49
msgid ""
"The following type check macros work on pointers to any Python object. "
"Likewise, the constructor functions work with any iterable Python object."
msgstr ""

#: ../../c-api/set.rst:55
msgid ""
"Return true if *p* is a :class:`set` object or an instance of a subtype. "
"This function always succeeds."
msgstr ""
"如果 *p* 是 :class:`set` 物件或是子類別的實例，則回傳 true。此函式總會成功執"
"行。"

#: ../../c-api/set.rst:60
msgid ""
"Return true if *p* is a :class:`frozenset` object or an instance of a "
"subtype.  This function always succeeds."
msgstr ""
"如果 *p* 是 :class:`frozenset` 物件或是子類別的實例，則回傳 true。此函式總會"
"成功執行。"

#: ../../c-api/set.rst:65
msgid ""
"Return true if *p* is a :class:`set` object, a :class:`frozenset` object, or "
"an instance of a subtype.  This function always succeeds."
msgstr ""
"如果 *p* 是 :class:`set` 物件、:class:`frozenset` 物件，或是子類別的實例，則"
"回傳 true。此函式總會成功執行。"

#: ../../c-api/set.rst:70
msgid ""
"Return true if *p* is a :class:`set` object but not an instance of a "
"subtype.  This function always succeeds."
msgstr ""
"如果 *p* 是 :class:`set` 物件但不是子類別的實例，則回傳 true。此函式總會成功"
"執行。"

#: ../../c-api/set.rst:77
msgid ""
"Return true if *p* is a :class:`set` object or a :class:`frozenset` object "
"but not an instance of a subtype.  This function always succeeds."
msgstr ""
"如果 *p* 是 :class:`set` 物件或 :class:`frozenset` 物件但不是子類別的實例，則"
"回傳 true。此函式總會成功執行。"

#: ../../c-api/set.rst:83
msgid ""
"Return true if *p* is a :class:`frozenset` object but not an instance of a "
"subtype.  This function always succeeds."
msgstr ""
"如果 *p* 是 :class:`frozenset` 物件但不是子類別的實例，則回傳 true。此函式總"
"會成功執行。"

#: ../../c-api/set.rst:89
msgid ""
"Return a new :class:`set` containing objects returned by the *iterable*.  "
"The *iterable* may be ``NULL`` to create a new empty set.  Return the new "
"set on success or ``NULL`` on failure.  Raise :exc:`TypeError` if *iterable* "
"is not actually iterable.  The constructor is also useful for copying a set "
"(``c=set(s)``)."
msgstr ""

#: ../../c-api/set.rst:97 ../../c-api/set.rst:110
msgid ""
"The operation is atomic on :term:`free threading <free-threaded build>` when "
"*iterable* is a :class:`set`, :class:`frozenset` or :class:`dict`."
msgstr ""

#: ../../c-api/set.rst:103
msgid ""
"Return a new :class:`frozenset` containing objects returned by the "
"*iterable*. The *iterable* may be ``NULL`` to create a new empty frozenset.  "
"Return the new set on success or ``NULL`` on failure.  Raise :exc:"
"`TypeError` if *iterable* is not actually iterable."
msgstr ""

#: ../../c-api/set.rst:114
msgid ""
"The following functions and macros are available for instances of :class:"
"`set` or :class:`frozenset` or instances of their subtypes."
msgstr ""

#: ../../c-api/set.rst:122
msgid ""
"Return the length of a :class:`set` or :class:`frozenset` object. Equivalent "
"to ``len(anyset)``.  Raises a :exc:`SystemError` if *anyset* is not a :class:"
"`set`, :class:`frozenset`, or an instance of a subtype."
msgstr ""

#: ../../c-api/set.rst:129
msgid "Macro form of :c:func:`PySet_Size` without error checking."
msgstr ""

#: ../../c-api/set.rst:134
msgid ""
"Return ``1`` if found, ``0`` if not found, and ``-1`` if an error is "
"encountered.  Unlike the Python :meth:`~object.__contains__` method, this "
"function does not automatically convert unhashable sets into temporary "
"frozensets.  Raise a :exc:`TypeError` if the *key* is unhashable. Raise :exc:"
"`SystemError` if *anyset* is not a :class:`set`, :class:`frozenset`, or an "
"instance of a subtype."
msgstr ""

#: ../../c-api/set.rst:142 ../../c-api/set.rst:157 ../../c-api/set.rst:177
msgid ""
"The operation is atomic on :term:`free threading <free-threaded build>` when "
"*key* is :class:`str`, :class:`int`, :class:`float`, :class:`bool` or :class:"
"`bytes`."
msgstr ""

#: ../../c-api/set.rst:147
msgid ""
"Add *key* to a :class:`set` instance.  Also works with :class:`frozenset` "
"instances (like :c:func:`PyTuple_SetItem` it can be used to fill in the "
"values of brand new frozensets before they are exposed to other code).  "
"Return ``0`` on success or ``-1`` on failure. Raise a :exc:`TypeError` if "
"the *key* is unhashable. Raise a :exc:`MemoryError` if there is no room to "
"grow.  Raise a :exc:`SystemError` if *set* is not an instance of :class:"
"`set` or its subtype."
msgstr ""

#: ../../c-api/set.rst:162
msgid ""
"The following functions are available for instances of :class:`set` or its "
"subtypes but not for instances of :class:`frozenset` or its subtypes."
msgstr ""

#: ../../c-api/set.rst:168
msgid ""
"Return ``1`` if found and removed, ``0`` if not found (no action taken), and "
"``-1`` if an error is encountered.  Does not raise :exc:`KeyError` for "
"missing keys.  Raise a :exc:`TypeError` if the *key* is unhashable.  Unlike "
"the Python :meth:`~set.discard` method, this function does not automatically "
"convert unhashable sets into temporary frozensets. Raise :exc:`SystemError` "
"if *set* is not an instance of :class:`set` or its subtype."
msgstr ""

#: ../../c-api/set.rst:183
msgid ""
"Return a new reference to an arbitrary object in the *set*, and removes the "
"object from the *set*.  Return ``NULL`` on failure.  Raise :exc:`KeyError` "
"if the set is empty. Raise a :exc:`SystemError` if *set* is not an instance "
"of :class:`set` or its subtype."
msgstr ""

#: ../../c-api/set.rst:191
msgid ""
"Empty an existing set of all elements. Return ``0`` on success. Return "
"``-1`` and raise :exc:`SystemError` if *set* is not an instance of :class:"
"`set` or its subtype."
msgstr ""

#: ../../c-api/set.rst:197
msgid ""
"In the :term:`free-threaded build`, the set is emptied before its entries "
"are cleared, so other threads will observe an empty set rather than "
"intermediate states."
msgstr ""

#: ../../c-api/set.rst:203
msgid "Deprecated API"
msgstr "已棄用的 API"

#: ../../c-api/set.rst:207
msgid ""
"A :term:`soft deprecated` constant representing the size of an internal "
"preallocated table inside :c:type:`PySetObject` instances."
msgstr ""
"一個被\\ :term:`軟性棄用 <soft deprecated>`\\ 的常數，代表 :c:type:"
"`PySetObject` 實例內部預分配表格的大小。"

#: ../../c-api/set.rst:210
msgid ""
"This is documented solely for completeness, as there are no guarantees that "
"a given version of CPython uses preallocated tables with a fixed size. In "
"code that does not deal with unstable set internals, :c:macro:`!"
"PySet_MINSIZE` can be replaced with a small constant like ``8``."
msgstr ""
"這僅為完整性而記錄於文件，且因為無法保證特定版本的 CPython 會使用具有固定大小"
"的預分配表格。在不處理不穩定集合內部結構的程式碼中，:c:macro:`!"
"PySet_MINSIZE` 可以替換為像 ``8`` 這樣的小常數。"

#: ../../c-api/set.rst:216
msgid "If looking for the size of a set, use :c:func:`PySet_Size` instead."
msgstr "如果要查詢集合的大小，請使用 :c:func:`PySet_Size`。"

#: ../../c-api/set.rst:11
msgid "object"
msgstr "object（物件）"

#: ../../c-api/set.rst:11
msgid "set"
msgstr "set（集合）"

#: ../../c-api/set.rst:11
msgid "frozenset"
msgstr "frozenset（凍結集合）"

#: ../../c-api/set.rst:120
msgid "built-in function"
msgstr "built-in function（內建函式）"

#: ../../c-api/set.rst:120
msgid "len"
msgstr "len"