Sync with CPython 3.14

c-api/capsule.po

@@ -6,7 +6,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.14\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-10-25 22:20+0000\n"
+"POT-Creation-Date: 2025-11-07 15:15+0000\n"
 "PO-Revision-Date: 2018-05-23 14:30+0000\n"
 "Last-Translator: Adrian Liaw <adrianliaw2000@gmail.com>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -37,141 +37,147 @@ msgid ""
 msgstr ""
 
 #: ../../c-api/capsule.rst:27
+msgid ""
+"The type object corresponding to capsule objects. This is the same object "
+"as :class:`types.CapsuleType` in the Python layer."
+msgstr ""
+
+#: ../../c-api/capsule.rst:33
 msgid "The type of a destructor callback for a capsule.  Defined as::"
 msgstr ""
 
-#: ../../c-api/capsule.rst:29
+#: ../../c-api/capsule.rst:35
 msgid "typedef void (*PyCapsule_Destructor)(PyObject *);"
 msgstr "typedef void (*PyCapsule_Destructor)(PyObject *);"
 
-#: ../../c-api/capsule.rst:31
+#: ../../c-api/capsule.rst:37
 msgid ""
 "See :c:func:`PyCapsule_New` for the semantics of PyCapsule_Destructor "
 "callbacks."
 msgstr ""
 
-#: ../../c-api/capsule.rst:37
+#: ../../c-api/capsule.rst:43
 msgid ""
 "Return true if its argument is a :c:type:`PyCapsule`.  This function always "
 "succeeds."
 msgstr ""
 
-#: ../../c-api/capsule.rst:43
+#: ../../c-api/capsule.rst:49
 msgid ""
 "Create a :c:type:`PyCapsule` encapsulating the *pointer*.  The *pointer* "
 "argument may not be ``NULL``."
 msgstr ""
 
-#: ../../c-api/capsule.rst:46
+#: ../../c-api/capsule.rst:52
 msgid "On failure, set an exception and return ``NULL``."
 msgstr ""
 
-#: ../../c-api/capsule.rst:48
+#: ../../c-api/capsule.rst:54
 msgid ""
 "The *name* string may either be ``NULL`` or a pointer to a valid C string.  "
 "If non-``NULL``, this string must outlive the capsule.  (Though it is "
 "permitted to free it inside the *destructor*.)"
 msgstr ""
 
-#: ../../c-api/capsule.rst:52
+#: ../../c-api/capsule.rst:58
 msgid ""
 "If the *destructor* argument is not ``NULL``, it will be called with the "
 "capsule as its argument when it is destroyed."
 msgstr ""
 
-#: ../../c-api/capsule.rst:55
+#: ../../c-api/capsule.rst:61
 msgid ""
 "If this capsule will be stored as an attribute of a module, the *name* "
 "should be specified as ``modulename.attributename``.  This will enable other "
 "modules to import the capsule using :c:func:`PyCapsule_Import`."
 msgstr ""
 
-#: ../../c-api/capsule.rst:62
+#: ../../c-api/capsule.rst:68
 msgid ""
 "Retrieve the *pointer* stored in the capsule.  On failure, set an exception "
 "and return ``NULL``."
 msgstr ""
 
-#: ../../c-api/capsule.rst:65
+#: ../../c-api/capsule.rst:71
 msgid ""
 "The *name* parameter must compare exactly to the name stored in the capsule. "
 "If the name stored in the capsule is ``NULL``, the *name* passed in must "
 "also be ``NULL``.  Python uses the C function :c:func:`!strcmp` to compare "
 "capsule names."
 msgstr ""
 
-#: ../../c-api/capsule.rst:73
+#: ../../c-api/capsule.rst:79
 msgid ""
 "Return the current destructor stored in the capsule.  On failure, set an "
 "exception and return ``NULL``."
 msgstr ""
 
-#: ../../c-api/capsule.rst:76
+#: ../../c-api/capsule.rst:82
 msgid ""
 "It is legal for a capsule to have a ``NULL`` destructor.  This makes a "
 "``NULL`` return code somewhat ambiguous; use :c:func:`PyCapsule_IsValid` or :"
 "c:func:`PyErr_Occurred` to disambiguate."
 msgstr ""
 
-#: ../../c-api/capsule.rst:83
+#: ../../c-api/capsule.rst:89
 msgid ""
 "Return the current context stored in the capsule.  On failure, set an "
 "exception and return ``NULL``."
 msgstr ""
 
-#: ../../c-api/capsule.rst:86
+#: ../../c-api/capsule.rst:92
 msgid ""
 "It is legal for a capsule to have a ``NULL`` context.  This makes a ``NULL`` "
 "return code somewhat ambiguous; use :c:func:`PyCapsule_IsValid` or :c:func:"
 "`PyErr_Occurred` to disambiguate."
 msgstr ""
 
-#: ../../c-api/capsule.rst:93
+#: ../../c-api/capsule.rst:99
 msgid ""
 "Return the current name stored in the capsule.  On failure, set an exception "
 "and return ``NULL``."
 msgstr ""
 
-#: ../../c-api/capsule.rst:96
+#: ../../c-api/capsule.rst:102
 msgid ""
 "It is legal for a capsule to have a ``NULL`` name.  This makes a ``NULL`` "
 "return code somewhat ambiguous; use :c:func:`PyCapsule_IsValid` or :c:func:"
 "`PyErr_Occurred` to disambiguate."
 msgstr ""
 
-#: ../../c-api/capsule.rst:103
+#: ../../c-api/capsule.rst:109
 msgid ""
 "Import a pointer to a C object from a capsule attribute in a module.  The "
 "*name* parameter should specify the full name to the attribute, as in "
 "``module.attribute``.  The *name* stored in the capsule must match this "
 "string exactly."
 msgstr ""
 
-#: ../../c-api/capsule.rst:108
+#: ../../c-api/capsule.rst:114
 msgid ""
 "This function splits *name* on the ``.`` character, and imports the first "
 "element. It then processes further elements using attribute lookups."
 msgstr ""
 
-#: ../../c-api/capsule.rst:111
+#: ../../c-api/capsule.rst:117
 msgid ""
 "Return the capsule's internal *pointer* on success.  On failure, set an "
 "exception and return ``NULL``."
 msgstr ""
 
-#: ../../c-api/capsule.rst:116
+#: ../../c-api/capsule.rst:122
 msgid ""
 "If *name* points to an attribute of some submodule or subpackage, this "
 "submodule or subpackage must be previously imported using other means (for "
 "example, by using :c:func:`PyImport_ImportModule`) for the attribute lookups "
 "to succeed."
 msgstr ""
 
-#: ../../c-api/capsule.rst:121
+#: ../../c-api/capsule.rst:127
 msgid "*no_block* has no effect anymore."
 msgstr ""
 
-#: ../../c-api/capsule.rst:127
+#: ../../c-api/capsule.rst:133
 msgid ""
 "Determines whether or not *capsule* is a valid capsule.  A valid capsule is "
 "non-``NULL``, passes :c:func:`PyCapsule_CheckExact`, has a non-``NULL`` "
@@ -180,41 +186,41 @@ msgid ""
 "compared.)"
 msgstr ""
 
-#: ../../c-api/capsule.rst:133
+#: ../../c-api/capsule.rst:139
 msgid ""
 "In other words, if :c:func:`PyCapsule_IsValid` returns a true value, calls "
 "to any of the accessors (any function starting with ``PyCapsule_Get``) are "
 "guaranteed to succeed."
 msgstr ""
 
-#: ../../c-api/capsule.rst:137
+#: ../../c-api/capsule.rst:143
 msgid ""
 "Return a nonzero value if the object is valid and matches the name passed "
 "in. Return ``0`` otherwise.  This function will not fail."
 msgstr ""
 
-#: ../../c-api/capsule.rst:143
+#: ../../c-api/capsule.rst:149
 msgid "Set the context pointer inside *capsule* to *context*."
 msgstr ""
 
-#: ../../c-api/capsule.rst:145 ../../c-api/capsule.rst:152
-#: ../../c-api/capsule.rst:161 ../../c-api/capsule.rst:169
+#: ../../c-api/capsule.rst:151 ../../c-api/capsule.rst:158
+#: ../../c-api/capsule.rst:167 ../../c-api/capsule.rst:175
 msgid ""
 "Return ``0`` on success.  Return nonzero and set an exception on failure."
 msgstr ""
 
-#: ../../c-api/capsule.rst:150
+#: ../../c-api/capsule.rst:156
 msgid "Set the destructor inside *capsule* to *destructor*."
 msgstr ""
 
-#: ../../c-api/capsule.rst:157
+#: ../../c-api/capsule.rst:163
 msgid ""
 "Set the name inside *capsule* to *name*.  If non-``NULL``, the name must "
 "outlive the capsule.  If the previous *name* stored in the capsule was not "
 "``NULL``, no attempt is made to free it."
 msgstr ""
 
-#: ../../c-api/capsule.rst:166
+#: ../../c-api/capsule.rst:172
 msgid ""
 "Set the void pointer inside *capsule* to *pointer*.  The pointer may not be "
 "``NULL``."