sync with cpython b82b12bc

Author: github-actions[bot]

c-api/module.po

@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.14\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-11-27 00:14+0000\n"
+"POT-Creation-Date: 2026-01-28 00:16+0000\n"
 "PO-Revision-Date: 2018-05-23 14:32+0000\n"
 "Last-Translator: Adrian Liaw <adrianliaw2000@gmail.com>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -784,7 +784,12 @@ msgid ""
 "``PyModule_FromDefAndSpec``)."
 msgstr ""
 
-#: ../../c-api/module.rst:682
+#: ../../c-api/module.rst:678
+#, fuzzy
+msgid "Return ``0`` on success. Return ``-1`` with an exception set on error."
+msgstr "在失敗時回傳 ``NULL`` 並設定例外。"
+
+#: ../../c-api/module.rst:685
 msgid ""
 "Indicate that *module* does or does not support running without the global "
 "interpreter lock (GIL), using one of the values from :c:macro:`Py_mod_gil`. "
@@ -796,26 +801,26 @@ msgid ""
 "on error, ``0`` on success."
 msgstr ""
 
-#: ../../c-api/module.rst:696
+#: ../../c-api/module.rst:699
 msgid "Module lookup (single-phase initialization)"
 msgstr ""
 
-#: ../../c-api/module.rst:698
+#: ../../c-api/module.rst:701
 msgid ""
 "The legacy :ref:`single-phase initialization <single-phase-initialization>` "
 "initialization scheme creates singleton modules that can be looked up in the "
 "context of the current interpreter. This allows the module object to be "
 "retrieved later with only a reference to the module definition."
 msgstr ""
 
-#: ../../c-api/module.rst:703
+#: ../../c-api/module.rst:706
 msgid ""
 "These functions will not work on modules created using multi-phase "
 "initialization, since multiple such modules can be created from a single "
 "definition."
 msgstr ""
 
-#: ../../c-api/module.rst:708
+#: ../../c-api/module.rst:711
 msgid ""
 "Returns the module object that was created from *def* for the current "
 "interpreter. This method requires that the module object has been attached "
@@ -824,18 +829,18 @@ msgid ""
 "to the interpreter state yet, it returns ``NULL``."
 msgstr ""
 
-#: ../../c-api/module.rst:715
+#: ../../c-api/module.rst:718
 msgid ""
 "Attaches the module object passed to the function to the interpreter state. "
 "This allows the module object to be accessible via :c:func:"
 "`PyState_FindModule`."
 msgstr ""
 
-#: ../../c-api/module.rst:718
+#: ../../c-api/module.rst:721
 msgid "Only effective on modules created using single-phase initialization."
 msgstr ""
 
-#: ../../c-api/module.rst:720
+#: ../../c-api/module.rst:723
 msgid ""
 "Python calls ``PyState_AddModule`` automatically after importing a module "
 "that uses :ref:`single-phase initialization <single-phase-initialization>`, "
@@ -847,21 +852,21 @@ msgid ""
 "state updates)."
 msgstr ""
 
-#: ../../c-api/module.rst:729
+#: ../../c-api/module.rst:732
 msgid ""
 "If a module was attached previously using the same *def*, it is replaced by "
 "the new *module*."
 msgstr ""
 
-#: ../../c-api/module.rst:732 ../../c-api/module.rst:743
+#: ../../c-api/module.rst:735 ../../c-api/module.rst:746
 msgid "The caller must have an :term:`attached thread state`."
 msgstr ""
 
-#: ../../c-api/module.rst:734
+#: ../../c-api/module.rst:737
 msgid "Return ``-1`` with an exception set on error, ``0`` on success."
 msgstr "成功時回傳 ``0``，在失敗時回傳 ``-1`` 並設定例外。"
 
-#: ../../c-api/module.rst:740
+#: ../../c-api/module.rst:743
 msgid ""
 "Removes the module object created from *def* from the interpreter state. "
 "Return ``-1`` with an exception set on error, ``0`` on success."

library/contextvars.po

@@ -4,7 +4,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.14\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2026-01-27 00:17+0000\n"
+"POT-Creation-Date: 2026-01-28 00:16+0000\n"
 "PO-Revision-Date: 2025-07-30 22:06+0800\n"
 "Last-Translator: \n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -211,32 +211,38 @@ msgstr ""
 "# 在重設呼叫之後，var 又沒有值了，所以\n"
 "# var.get() 會引發 LookupError。"
 
-#: ../../library/contextvars.rst:125
+#: ../../library/contextvars.rst:122
+msgid "The same *token* cannot be used twice."
+msgstr ""
+
+#: ../../library/contextvars.rst:127
+#, fuzzy
 msgid ""
 "*Token* objects are returned by the :meth:`ContextVar.set` method. They can "
 "be passed to the :meth:`ContextVar.reset` method to revert the value of the "
-"variable to what it was before the corresponding *set*."
+"variable to what it was before the corresponding *set*. A single token "
+"cannot reset a context variable more than once."
 msgstr ""
 "*Token* 物件由 :meth:`ContextVar.set` 方法回傳，可以傳遞給 :meth:`ContextVar."
 "reset` 方法，用以將變數的值還原為相對應的 *set* 之前的值。"
 
-#: ../../library/contextvars.rst:130
+#: ../../library/contextvars.rst:132
 msgid ""
 "Tokens support the :ref:`context manager protocol <context-managers>` to "
 "automatically reset context variables. See :meth:`ContextVar.set`."
 msgstr ""
 
-#: ../../library/contextvars.rst:135
+#: ../../library/contextvars.rst:137
 msgid "Added support for usage as a context manager."
 msgstr "新增對用作情境管理器的支援。"
 
-#: ../../library/contextvars.rst:139
+#: ../../library/contextvars.rst:141
 msgid ""
 "A read-only property.  Points to the :class:`ContextVar` object that created "
 "the token."
 msgstr "唯讀屬性。 指向建立 token 的 :class:`ContextVar` 物件。"
 
-#: ../../library/contextvars.rst:144
+#: ../../library/contextvars.rst:146
 msgid ""
 "A read-only property.  Set to the value the variable had before the :meth:"
 "`ContextVar.set` method call that created the token. It points to :attr:"
@@ -245,34 +251,34 @@ msgstr ""
 "唯讀屬性。 值為變數在呼叫 :meth:`ContextVar.set` 方法之前的值。如果變數在呼叫"
 "前沒有設定，則指向 :attr:`Token.MISSING`。"
 
-#: ../../library/contextvars.rst:151
+#: ../../library/contextvars.rst:153
 msgid "A marker object used by :attr:`Token.old_value`."
 msgstr "由 :attr:`Token.old_value` 使用的標記物件。"
 
-#: ../../library/contextvars.rst:155
+#: ../../library/contextvars.rst:157
 msgid "Manual Context Management"
 msgstr "手動情境管理"
 
-#: ../../library/contextvars.rst:159
+#: ../../library/contextvars.rst:161
 msgid "Returns a copy of the current :class:`~contextvars.Context` object."
 msgstr "回傳目前 :class:`~contextvars.Context` 物件的複本（copy）。"
 
-#: ../../library/contextvars.rst:161
+#: ../../library/contextvars.rst:163
 msgid ""
 "The following snippet gets a copy of the current context and prints all "
 "variables and their values that are set in it::"
 msgstr ""
 "以下程式碼片段會取得目前情境的複本，並顯示在其中設定的所有變數及其值：::"
 
-#: ../../library/contextvars.rst:164
+#: ../../library/contextvars.rst:166
 msgid ""
 "ctx: Context = copy_context()\n"
 "print(list(ctx.items()))"
 msgstr ""
 "ctx: Context = copy_context()\n"
 "print(list(ctx.items()))"
 
-#: ../../library/contextvars.rst:167
+#: ../../library/contextvars.rst:169
 msgid ""
 "The function has an *O*\\ (1) complexity, i.e. works equally fast for "
 "contexts with a few context variables and for contexts that have a lot of "
@@ -281,19 +287,19 @@ msgstr ""
 "這個函式具有 *O*\\ (1) 的複雜度，也就是說，對於只有少許情境變數的情境和有大量"
 "情境變數的情境，速度都一樣快。"
 
-#: ../../library/contextvars.rst:174
+#: ../../library/contextvars.rst:176
 msgid "A mapping of :class:`ContextVars <ContextVar>` to their values."
 msgstr ":class:`ContextVars<ContextVar>` 到其值的映射。"
 
-#: ../../library/contextvars.rst:176
+#: ../../library/contextvars.rst:178
 msgid ""
 "``Context()`` creates an empty context with no values in it. To get a copy "
 "of the current context use the :func:`~contextvars.copy_context` function."
 msgstr ""
 "``Context()`` 會建立一個沒有值的空情境。要取得目前情境的複本，請使用 :func:"
 "`~contextvars.copy_context` 函式。"
 
-#: ../../library/contextvars.rst:180
+#: ../../library/contextvars.rst:182
 msgid ""
 "Each thread has its own effective stack of :class:`!Context` objects.  The :"
 "term:`current context` is the :class:`!Context` object at the top of the "
@@ -304,7 +310,7 @@ msgstr ""
 "term:`current context` 是目前執行緒堆疊頂端的 :class:`!Context` 物件。  堆疊"
 "中的所有 :class:`!Context` 物件都被視為\\ *已進入*。"
 
-#: ../../library/contextvars.rst:185
+#: ../../library/contextvars.rst:187
 msgid ""
 "*Entering* a context, which can be done by calling its :meth:`~Context.run` "
 "method, makes the context the current context by pushing it onto the top of "
@@ -313,7 +319,7 @@ msgstr ""
 "*進入*\\ 一個情境，可以藉由呼叫其 :meth:`~Context.run` 方法來完成，此\\ *進入"
 "*\\ 的動作會將一情境推到目前執行緒的情境堆疊的頂端，使該情境成為目前的情境。"
 
-#: ../../library/contextvars.rst:189
+#: ../../library/contextvars.rst:191
 msgid ""
 "*Exiting* from the current context, which can be done by returning from the "
 "callback passed to the :meth:`~Context.run` method, restores the current "
@@ -324,7 +330,7 @@ msgstr ""
 "式回傳之後，就會自動\\ *退出*\\ 目前的情境，這會將目前的情境還原到進入情境之"
 "前的狀態，方法是將情境從情境堆疊的頂端彈出。"
 
-#: ../../library/contextvars.rst:194
+#: ../../library/contextvars.rst:196
 msgid ""
 "Since each thread has its own context stack, :class:`ContextVar` objects "
 "behave in a similar fashion to :func:`threading.local` when values are "
@@ -333,19 +339,19 @@ msgstr ""
 "因為每個執行緒都有自己的情境堆疊，當值在不同的執行緒中被指定時， :class:"
 "`ContextVar` 物件的行為與 :func:`threading.local` 相似。"
 
-#: ../../library/contextvars.rst:198
+#: ../../library/contextvars.rst:200
 msgid ""
 "Attempting to enter an already entered context, including contexts entered "
 "in other threads, raises a :exc:`RuntimeError`."
 msgstr ""
 "嘗試進入已進入的情境，包括在其他執行緒中進入的情境，會引發 :exc:"
 "`RuntimeError`。"
 
-#: ../../library/contextvars.rst:201
+#: ../../library/contextvars.rst:203
 msgid "After exiting a context, it can later be re-entered (from any thread)."
 msgstr "退出情境後，之後可以重新進入（從任何執行緒）。"
 
-#: ../../library/contextvars.rst:203
+#: ../../library/contextvars.rst:205
 msgid ""
 "Any changes to :class:`ContextVar` values via the :meth:`ContextVar.set` "
 "method are recorded in the current context.  The :meth:`ContextVar.get` "
@@ -359,11 +365,11 @@ msgstr ""
 "實際造成的效果會像是將其在進入情境時對情境變數所做的任何變一一彈出並還原（如"
 "果需要，可以透過重新進入情境來還原值）。"
 
-#: ../../library/contextvars.rst:210
+#: ../../library/contextvars.rst:212
 msgid "Context implements the :class:`collections.abc.Mapping` interface."
 msgstr "情境（Context）實作了 :class:`collections.abc.Mapping` 介面。"
 
-#: ../../library/contextvars.rst:214
+#: ../../library/contextvars.rst:216
 msgid ""
 "Enters the Context, executes ``callable(*args, **kwargs)``, then exits the "
 "Context.  Returns *callable*'s return value, or propagates an exception if "
@@ -372,11 +378,11 @@ msgstr ""
 "進入 Context，執行 ``callable(*args, **kwargs)``，然後退出 Context。 回傳 "
 "*callable* 的回傳值，如果發生例外（exception），則傳播例外。"
 
-#: ../../library/contextvars.rst:218
+#: ../../library/contextvars.rst:220
 msgid "Example:"
 msgstr "例如："
 
-#: ../../library/contextvars.rst:220
+#: ../../library/contextvars.rst:222
 msgid ""
 "import contextvars\n"
 "\n"
@@ -440,60 +446,60 @@ msgstr ""
 "# 但是，在 'ctx' 外, 'var' 的值仍然是 'spam':\n"
 "print(var.get())  # 'spam'"
 
-#: ../../library/contextvars.rst:266
+#: ../../library/contextvars.rst:268
 msgid "Return a shallow copy of the context object."
 msgstr "回傳情境物件的淺層複本（shallow copy）。"
 
-#: ../../library/contextvars.rst:270
+#: ../../library/contextvars.rst:272
 msgid ""
 "Return ``True`` if the *context* has a value for *var* set; return ``False`` "
 "otherwise."
 msgstr ""
 "如果\\ *情境*\\ 裡面有 *var* 的值，則回傳 ``True``，否則回傳 ``False``。"
 
-#: ../../library/contextvars.rst:275
+#: ../../library/contextvars.rst:277
 msgid ""
 "Return the value of the *var* :class:`ContextVar` variable. If the variable "
 "is not set in the context object, a :exc:`KeyError` is raised."
 msgstr ""
 "回傳 *var* :class:`ContextVar` 變數的值。如果該變數並沒有在情境物件中設定，則"
 "會引發 :exc:`KeyError` 錯誤。"
 
-#: ../../library/contextvars.rst:281
+#: ../../library/contextvars.rst:283
 msgid ""
 "Return the value for *var* if *var* has the value in the context object.  "
 "Return *default* otherwise.  If *default* is not given, return ``None``."
 msgstr ""
 "如果 *var* 的值在情境物件中，則回傳 *var* 的值。否則回傳 *default*。如果沒有 "
 "*default* 值，則回傳 ``None``。"
 
-#: ../../library/contextvars.rst:287
+#: ../../library/contextvars.rst:289
 msgid "Return an iterator over the variables stored in the context object."
 msgstr "回傳儲存於情境物件中變數的疊代器。"
 
-#: ../../library/contextvars.rst:292
+#: ../../library/contextvars.rst:294
 msgid "Return the number of variables set in the context object."
 msgstr "回傳情境物件中的變數個數。"
 
-#: ../../library/contextvars.rst:296
+#: ../../library/contextvars.rst:298
 msgid "Return a list of all variables in the context object."
 msgstr "回傳情境物件中所有變數的串列。"
 
-#: ../../library/contextvars.rst:300
+#: ../../library/contextvars.rst:302
 msgid "Return a list of all variables' values in the context object."
 msgstr "回傳情境物件中所有變數的值的串列。"
 
-#: ../../library/contextvars.rst:305
+#: ../../library/contextvars.rst:307
 msgid ""
 "Return a list of 2-tuples containing all variables and their values in the "
 "context object."
 msgstr "回傳情境物件中所有變數與其值的 2-元組（2-tuples）的串列。"
 
-#: ../../library/contextvars.rst:310
+#: ../../library/contextvars.rst:312
 msgid "asyncio support"
 msgstr "對 asyncio 的支援"
 
-#: ../../library/contextvars.rst:312
+#: ../../library/contextvars.rst:314
 msgid ""
 "Context variables are natively supported in :mod:`asyncio` and are ready to "
 "be used without any extra configuration.  For example, here is a simple echo "
@@ -503,7 +509,7 @@ msgstr ""
 ":mod:`asyncio` 原生支援情境變數，不需任何額外設定。 舉例來說，以下是一個簡單"
 "的 echo 伺服器，使用情境變數讓遠端用戶端的位址在處理該用戶端的任務中可用："
 
-#: ../../library/contextvars.rst:318
+#: ../../library/contextvars.rst:320
 msgid ""
 "import asyncio\n"
 "import contextvars\n"