sync with cpython 506c76f1

Author: github-actions[bot]

c-api/module.po

@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.13\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-10-10 00:13+0000\n"
+"POT-Creation-Date: 2025-02-04 00:13+0000\n"
 "PO-Revision-Date: 2018-05-23 14:32+0000\n"
 "Last-Translator: Adrian Liaw <[email protected]>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -584,18 +584,12 @@ msgid ""
 "On success, return ``0``. On error, raise an exception and return ``-1``."
 msgstr ""
 
-#: ../../c-api/module.rst:526
-msgid ""
-"Return ``-1`` if *value* is ``NULL``. It must be called with an exception "
-"raised in this case."
-msgstr ""
-
-#: ../../c-api/module.rst:529 ../../c-api/module.rst:576
-#: ../../c-api/module.rst:603
+#: ../../c-api/module.rst:526 ../../c-api/module.rst:577
+#: ../../c-api/module.rst:604
 msgid "Example usage::"
 msgstr "用法範例： ::"
 
-#: ../../c-api/module.rst:531
+#: ../../c-api/module.rst:528
 msgid ""
 "static int\n"
 "add_spam(PyObject *module, int value)\n"
@@ -621,13 +615,20 @@ msgstr ""
 "    return res;\n"
 " }"
 
-#: ../../c-api/module.rst:543
+#: ../../c-api/module.rst:540
+msgid ""
+"To be convenient, the function accepts ``NULL`` *value* with an exception "
+"set. In this case, return ``-1`` and just leave the raised exception "
+"unchanged."
+msgstr ""
+
+#: ../../c-api/module.rst:544
 msgid ""
 "The example can also be written without checking explicitly if *obj* is "
 "``NULL``::"
 msgstr ""
 
-#: ../../c-api/module.rst:546
+#: ../../c-api/module.rst:547
 msgid ""
 "static int\n"
 "add_spam(PyObject *module, int value)\n"
@@ -647,13 +648,13 @@ msgstr ""
 "    return res;\n"
 " }"
 
-#: ../../c-api/module.rst:555
+#: ../../c-api/module.rst:556
 msgid ""
 "Note that ``Py_XDECREF()`` should be used instead of ``Py_DECREF()`` in this "
 "case, since *obj* can be ``NULL``."
 msgstr ""
 
-#: ../../c-api/module.rst:558
+#: ../../c-api/module.rst:559
 msgid ""
 "The number of different *name* strings passed to this function should be "
 "kept small, usually by only using statically allocated strings as *name*. "
@@ -663,47 +664,47 @@ msgid ""
 "internally to create a key object."
 msgstr ""
 
-#: ../../c-api/module.rst:571
+#: ../../c-api/module.rst:572
 msgid ""
 "Similar to :c:func:`PyModule_AddObjectRef`, but \"steals\" a reference to "
 "*value*. It can be called with a result of function that returns a new "
 "reference without bothering to check its result or even saving it to a "
 "variable."
 msgstr ""
 
-#: ../../c-api/module.rst:578
+#: ../../c-api/module.rst:579
 msgid ""
 "if (PyModule_Add(module, \"spam\", PyBytes_FromString(value)) < 0) {\n"
 "    goto error;\n"
 "}"
 msgstr ""
 
-#: ../../c-api/module.rst:587
+#: ../../c-api/module.rst:588
 msgid ""
 "Similar to :c:func:`PyModule_AddObjectRef`, but steals a reference to "
 "*value* on success (if it returns ``0``)."
 msgstr ""
 
-#: ../../c-api/module.rst:590
+#: ../../c-api/module.rst:591
 msgid ""
 "The new :c:func:`PyModule_Add` or :c:func:`PyModule_AddObjectRef` functions "
 "are recommended, since it is easy to introduce reference leaks by misusing "
 "the :c:func:`PyModule_AddObject` function."
 msgstr ""
 
-#: ../../c-api/module.rst:597
+#: ../../c-api/module.rst:598
 msgid ""
 "Unlike other functions that steal references, ``PyModule_AddObject()`` only "
 "releases the reference to *value* **on success**."
 msgstr ""
 
-#: ../../c-api/module.rst:600
+#: ../../c-api/module.rst:601
 msgid ""
 "This means that its return value must be checked, and calling code must :c:"
 "func:`Py_XDECREF` *value* manually on error."
 msgstr ""
 
-#: ../../c-api/module.rst:605
+#: ../../c-api/module.rst:606
 msgid ""
 "PyObject *obj = PyBytes_FromString(value);\n"
 "if (PyModule_AddObject(module, \"spam\", obj) < 0) {\n"
@@ -717,59 +718,59 @@ msgid ""
 "// Py_XDECREF(obj) is not needed here."
 msgstr ""
 
-#: ../../c-api/module.rst:618
+#: ../../c-api/module.rst:619
 msgid ":c:func:`PyModule_AddObject` is :term:`soft deprecated`."
 msgstr ""
 
-#: ../../c-api/module.rst:623
+#: ../../c-api/module.rst:624
 msgid ""
 "Add an integer constant to *module* as *name*.  This convenience function "
 "can be used from the module's initialization function. Return ``-1`` with an "
 "exception set on error, ``0`` on success."
 msgstr ""
 
-#: ../../c-api/module.rst:627
+#: ../../c-api/module.rst:628
 msgid ""
 "This is a convenience function that calls :c:func:`PyLong_FromLong` and :c:"
 "func:`PyModule_AddObjectRef`; see their documentation for details."
 msgstr ""
 
-#: ../../c-api/module.rst:633
+#: ../../c-api/module.rst:634
 msgid ""
 "Add a string constant to *module* as *name*.  This convenience function can "
 "be used from the module's initialization function.  The string *value* must "
 "be ``NULL``-terminated. Return ``-1`` with an exception set on error, ``0`` "
 "on success."
 msgstr ""
 
-#: ../../c-api/module.rst:638
+#: ../../c-api/module.rst:639
 msgid ""
 "This is a convenience function that calls :c:func:"
 "`PyUnicode_InternFromString` and :c:func:`PyModule_AddObjectRef`; see their "
 "documentation for details."
 msgstr ""
 
-#: ../../c-api/module.rst:645
+#: ../../c-api/module.rst:646
 msgid ""
 "Add an int constant to *module*. The name and the value are taken from "
 "*macro*. For example ``PyModule_AddIntMacro(module, AF_INET)`` adds the int "
 "constant *AF_INET* with the value of *AF_INET* to *module*. Return ``-1`` "
 "with an exception set on error, ``0`` on success."
 msgstr ""
 
-#: ../../c-api/module.rst:653
+#: ../../c-api/module.rst:654
 msgid "Add a string constant to *module*."
 msgstr ""
 
-#: ../../c-api/module.rst:657
+#: ../../c-api/module.rst:658
 msgid ""
 "Add a type object to *module*. The type object is finalized by calling "
 "internally :c:func:`PyType_Ready`. The name of the type object is taken from "
 "the last component of :c:member:`~PyTypeObject.tp_name` after dot. Return "
 "``-1`` with an exception set on error, ``0`` on success."
 msgstr ""
 
-#: ../../c-api/module.rst:667
+#: ../../c-api/module.rst:668
 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`. "
@@ -780,25 +781,25 @@ msgid ""
 "Return ``-1`` with an exception set on error, ``0`` on success."
 msgstr ""
 
-#: ../../c-api/module.rst:680
+#: ../../c-api/module.rst:681
 msgid "Module lookup"
 msgstr "模組查找"
 
-#: ../../c-api/module.rst:682
+#: ../../c-api/module.rst:683
 msgid ""
 "Single-phase initialization 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:686
+#: ../../c-api/module.rst:687
 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:691
+#: ../../c-api/module.rst:692
 msgid ""
 "Returns the module object that was created from *def* for the current "
 "interpreter. This method requires that the module object has been attached "
@@ -807,18 +808,18 @@ msgid ""
 "to the interpreter state yet, it returns ``NULL``."
 msgstr ""
 
-#: ../../c-api/module.rst:698
+#: ../../c-api/module.rst:699
 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:701
+#: ../../c-api/module.rst:702
 msgid "Only effective on modules created using single-phase initialization."
 msgstr ""
 
-#: ../../c-api/module.rst:703
+#: ../../c-api/module.rst:704
 msgid ""
 "Python calls ``PyState_AddModule`` automatically after importing a module, "
 "so it is unnecessary (but harmless) to call it from module initialization "
@@ -829,15 +830,15 @@ msgid ""
 "state updates)."
 msgstr ""
 
-#: ../../c-api/module.rst:711 ../../c-api/module.rst:722
+#: ../../c-api/module.rst:712 ../../c-api/module.rst:723
 msgid "The caller must hold the GIL."
 msgstr ""
 
-#: ../../c-api/module.rst:713
+#: ../../c-api/module.rst:714
 msgid "Return ``-1`` with an exception set on error, ``0`` on success."
 msgstr "成功時回傳 ``0``，在失敗時回傳 ``-1`` 並設定例外。"
 
-#: ../../c-api/module.rst:719
+#: ../../c-api/module.rst:720
 msgid ""
 "Removes the module object created from *def* from the interpreter state. "
 "Return ``-1`` with an exception set on error, ``0`` on success."