10000 sync with cpython e3281152 · python/python-docs-zh-tw@6f378db · GitHub
[go: up one dir, main page]

Skip to content

Commit 6f378db

Browse files
github-actions[bot]mattwang44
authored andcommitted
sync with cpython e3281152
1 parent 843fb92 commit 6f378db

File tree

15 files changed

+2026
-1997
lines changed

15 files changed

+2026
-1997
lines changed

c-api/function.po

Lines changed: 44 additions & 38 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ msgid ""
1010
msgstr ""
1111
"Project-Id-Version: Python 3.12\n"
1212
"Report-Msgid-Bugs-To: \n"
13-
"POT-Creation-Date: 2023-12-07 00:03+0000\n"
13+
"POT-Creation-Date: 2023-12-13 00:03+0000\n"
1414
"PO-Revision-Date: 2022-11-12 15:45+0800\n"
1515
"Last-Translator: Matt Wang <mattwang44@gmail.com>\n"
1616
"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -62,153 +62,159 @@ msgstr ""
6262
"夠存取的全域變數的字典。"
6363

6464
#: ../../c-api/function.rst:37
65+
#, fuzzy
6566
msgid ""
66-
"The function's docstring and name are retrieved from the code object. "
67-
"*__module__* is retrieved from *globals*. The argument defaults, annotations "
68-
"and closure are set to ``NULL``. *__qualname__* is set to the same value as "
69-
"the code object's :attr:`~codeobject.co_qualname` field."
67+
"The function's docstring and name are retrieved from the code object. :attr:"
68+
"`~function.__module__` is retrieved from *globals*. The argument defaults, "
69+
"annotations and closure are set to ``NULL``. :attr:`~function.__qualname__` "
70+
"is set to the same value as the code object's :attr:`~codeobject."
71+
"co_qualname` field."
7072
msgstr ""
7173
"函式的文件字串 (docstring) 和名稱是從程式碼物件所取得,*__module__* 是自 "
7274
"*globals* 所取得。引數預設值、標註 (annotation) 和閉包 (closure) 被設為 "
7375
"``NULL``,*__qualname__* 被設為和程式碼物件 :attr:`~codeobject.co_qualname` "
7476
"欄位相同的值。"
7577

76-
#: ../../c-api/function.rst:45
78+
#: ../../c-api/function.rst:46
79+
#, fuzzy
7780
msgid ""
78-
"As :c:func:`PyFunction_New`, but also allows setting the function object's "
79-
"``__qualname__`` attribute. *qualname* should be a unicode object or "
80-
"``NULL``; if ``NULL``, the ``__qualname__`` attribute is set to the same "
81-
"value as the code object's :attr:`~codeobject.co_qualname` field."
81+
"As :c:func:`PyFunction_New`, but also allows setting the function object's :"
82+
"attr:`~function.__qualname__` attribute. *qualname* should be a unicode "
83+
"object or ``NULL``; if ``NULL``, the :attr:`!__qualname__` attribute is set "
84+
"to the same value as the code object's :attr:`~codeobject.co_qualname` field."
8285
msgstr ""
8386
"和 :c:func:`PyFunction_New` 相似,但也允許函式物件 ``__qualname__`` 屬性的設"
8487
"定,*qualname* 應為一個 unicode 物件或是 ``NULL``;如為 ``NULL``,"
8588
"``__qualname__`` 屬性會被設為與程式碼物件 :attr:`~codeobject.co_qualname` 欄"
8689
"位相同的值。"
8790

88-
#: ../../c-api/function.rst:55
91+
#: ../../c-api/function.rst:57
8992
msgid "Return the code object associated with the function object *op*."
9093
msgstr "回傳與程式碼物件相關的函式物件 *op*。"
9194

92-
#: ../../c-api/function.rst:60
95+
#: ../../c-api/function.rst:62
9396
msgid "Return the globals dictionary associated with the function object *op*."
9497
msgstr "回傳與全域函式字典相關的函式物件 *op*。"
9598

96-
#: ../../c-api/function.rst:65
99+
#: ../../c-api/function.rst:67
100+
#, fuzzy
97101
msgid ""
98-
"Return a :term:`borrowed reference` to the *__module__* attribute of the "
99-
"function object *op*. It can be *NULL*."
102+
"Return a :term:`borrowed reference` to the :attr:`~function.__module__` "
103+
"attribute of the :ref:`function object <user-defined-funcs>` *op*. It can be "
104+
"*NULL*."
100105
msgstr ""
101106
"回傳一個函式物件 *op* 之 *__module__* 屬性的 :term:`borrowed reference`,它可"
102107
"以是 *NULL*。"
103108

104-
#: ../../c-api/function.rst:68
109+
#: ../../c-api/function.rst:71
110+
#, fuzzy
105111
msgid ""
106-
"This is normally a string containing the module name, but can be set to any "
107-
"other object by Python code."
112+
"This is normally a :class:`string <str>` containing the module name, but can "
113+
"be set to any other object by Python code."
108114
msgstr "這通常是個包含模組名稱的字串,但可以被 Python 程式設為任何其他物件。"
109115

110-
#: ../../c-api/function.rst:74
116+
#: ../../c-api/function.rst:77
111117
msgid ""
112118
"Return the argument default values of the function object *op*. This can be "
113119
"a tuple of arguments or ``NULL``."
114120
msgstr ""
115121
"回傳函式物件 *op* 的引數預設值,這可以是一個含有多個引數的 tuple(元組)或 "
116122
"``NULL``。"
117123

118-
#: ../../c-api/function.rst:80
124+
#: ../../c-api/function.rst:83
119125
msgid ""
120126
"Set the argument default values for the function object *op*. *defaults* "
121127
"must be ``Py_None`` or a tuple."
122128
msgstr ""
123129
"設定函式物件 *op* 的引數預設值。*defaults* 必須是 ``Py_None`` 或一個 tuple。"
124130

125-
#: ../../c-api/function.rst:83 ../../c-api/function.rst:106
126-
#: ../../c-api/function.rst:120
131+
#: ../../c-api/function.rst:86 ../../c-api/function.rst:109
132+
#: ../../c-api/function.rst:123
127133
msgid "Raises :exc:`SystemError` and returns ``-1`` on failure."
128134
msgstr "引發 :exc:`SystemError` 且在失敗時回傳 ``-1``。"
129135

130-
#: ../../c-api/function.rst:88
136+
#: ../../c-api/function.rst:91
131137
msgid "Set the vectorcall field of a given function object *func*."
132138
msgstr "為一個給定的函式物件 *func* 設定 vectorcall 欄位。"
133139

134-
#: ../../c-api/function.rst:90
140+
#: ../../c-api/function.rst:93
135141
msgid ""
136142
"Warning: extensions using this API must preserve the behavior of the "
137143
"unaltered (default) vectorcall function!"
138144
msgstr ""
139145

140-
#: ../../c-api/function.rst:97
146+
#: ../../c-api/function.rst:100
141147
msgid ""
142148
"Return the closure associated with the function object *op*. This can be "
143149
"``NULL`` or a tuple of cell objects."
144150
msgstr ""
145151
"回傳與函式物件 *op* 相關聯的閉包,這可以是個 ``NULL`` 或是一個包含 cell 物件"
146152
"的 tuple。"
147153

148-
#: ../../c-api/function.rst:103
154+
#: ../../c-api/function.rst:106
149155
msgid ""
150156
"Set the closure associated with the function object *op*. *closure* must be "
151157
"``Py_None`` or a tuple of cell objects."
152158
msgstr ""
153159
"設定與函式物件 *op* 相關聯的閉包,*closure* 必須是 ``Py_None`` 或是一個包含 "
154160
"cell 物件的 tuple。"
155161

156-
#: ../../c-api/function.rst:111
162+
#: ../../c-api/function.rst:114
157163
msgid ""
158164
"Return the annotations of the function object *op*. This can be a mutable "
159165
"dictionary or ``NULL``."
160166
msgstr ""
161167
"回傳函式物件 *op* 的標註,這可以是一個可變動的 (mutable) 字典或 ``NULL``。"
162168

163-
#: ../../c-api/function.rst:117
169+
#: ../../c-api/function.rst:120
164170
msgid ""
165171
"Set the annotations for the function object *op*. *annotations* must be a "
166172
"dictionary or ``Py_None``."
167173
msgstr "設定函式物件 *op* 的標註,*annotations* 必須是一個字典或 ``Py_None``。"
168174

169-
#: ../../c-api/function.rst:125
175+
#: ../../c-api/function.rst:128
170176
msgid ""
171177
"Register *callback* as a function watcher for the current interpreter. "
172178
"Return an ID which may be passed to :c:func:`PyFunction_ClearWatcher`. In "
173179
"case of error (e.g. no more watcher IDs available), return ``-1`` and set an "
174180
"exception."
175181
msgstr ""
176182

177-
#: ../../c-api/function.rst:135
183+
#: ../../c-api/function.rst:138
178184
msgid ""
179185
"Clear watcher identified by *watcher_id* previously returned from :c:func:"
180186
"`PyFunction_AddWatcher` for the current interpreter. Return ``0`` on "
181187
"success, or ``-1`` and set an exception on error (e.g. if the given "
182188
"*watcher_id* was never registered.)"
183189
msgstr ""
184190

185-
#: ../../c-api/function.rst:145
191+
#: ../../c-api/function.rst:148
186192
msgid ""
187193
"Enumeration of possible function watcher events: - "
188194
"``PyFunction_EVENT_CREATE`` - ``PyFunction_EVENT_DESTROY`` - "
189195
"``PyFunction_EVENT_MODIFY_CODE`` - ``PyFunction_EVENT_MODIFY_DEFAULTS`` - "
190196
"``PyFunction_EVENT_MODIFY_KWDEFAULTS``"
191197
msgstr ""
192198

193-
#: ../../c-api/function.rst:157
199+
#: ../../c-api/function.rst:160
194200
msgid "Type of a function watcher callback function."
195201
msgstr ""
196202

197-
#: ../../c-api/function.rst:159
203+
#: ../../c-api/function.rst:162
198204
msgid ""
199205
"If *event* is ``PyFunction_EVENT_CREATE`` or ``PyFunction_EVENT_DESTROY`` "
200206
"then *new_value* will be ``NULL``. Otherwise, *new_value* will hold a :term:"
201207
"`borrowed reference` to the new value that is about to be stored in *func* "
202208
"for the attribute that is being modified."
203209
msgstr ""
204210

205-
#: ../../c-api/function.rst:164
211+
#: ../../c-api/function.rst:167
206212
msgid ""
207213
"The callback may inspect but must not modify *func*; doing so could have "
208214
"unpredictable effects, including infinite recursion."
209215
msgstr ""
210216

211-
#: ../../c-api/function.rst:167
217+
#: ../../c-api/function.rst:170
212218
msgid ""
213219
"If *event* is ``PyFunction_EVENT_CREATE``, then the callback is invoked "
214220
"after `func` has been fully initialized. Otherwise, the callback is invoked "
@@ -220,22 +226,22 @@ msgid ""
220226
"semantics of the Python code being executed."
221227
msgstr ""
222228

223-
#: ../../c-api/function.rst:176
229+
#: ../../c-api/function.rst:179
224230
msgid ""
225231
"If *event* is ``PyFunction_EVENT_DESTROY``, Taking a reference in the "
1241
226232
"callback to the about-to-be-destroyed function will resurrect it, preventing "
227233
"it from being freed at this time. When the resurrected object is destroyed "
228234
"later, any watcher callbacks active at that time will be called again."
229235
msgstr ""
230236

231-
#: ../../c-api/function.rst:181
237+
#: ../../c-api/function.rst:184
232238
msgid ""
233239
"If the callback sets an exception, it must return ``-1``; this exception "
234240
"will be printed as an unraisable exception using :c:func:"
235241
"`PyErr_WriteUnraisable`. Otherwise it should return ``0``."
236242
msgstr ""
237243

238-
#: ../../c-api/function.rst:185
244+
#: ../../c-api/function.rst:188
239245
msgid ""
240246
"There may already be a pending exception set on entry to the callback. In "
241247
"this case, the callback should return ``0`` with the same exception still "

howto/annotations.po

Lines changed: 20 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ msgid ""
77
msgstr ""
88
"Project-Id-Version: Python 3.12\n"
99
"Report-Msgid-Bugs-To: \n"
10-
"POT-Creation-Date: 2022-12-25 00:16+0000\n"
10+
"POT-Creation-Date: 2023-12-13 00:03+0000\n"
1111
"PO-Revision-Date: 2023-11-08 23:11+0800\n"
1212
"Last-Translator: rockleon <therockleona@gmail.com>\n"
1313
"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -271,14 +271,15 @@ msgstr ""
271271
"__wrapped__`` 或 ``o.func`` 來疊代解開它,直到找到根解包函式。"
272272

273273
#: ../../howto/annotations.rst:155
274+
#, fuzzy
274275
msgid ""
275-
"If ``o`` is a callable (but not a class), use ``o.__globals__`` as the "
276-
"globals when calling :func:`eval`."
276+
"If ``o`` is a callable (but not a class), use :attr:`o.__globals__ <function."
277+
"__globals__>` as the globals when calling :func:`eval`."
277278
msgstr ""
278279
"如果 ``o`` 是 callable(但不是類別),則在呼叫 :func:`eval` 時使用 ``o."
279280
"__globals__`` 作為全域變數。"
280281

281-
#: ../../howto/annotations.rst:158
282+
#: ../../howto/annotations.rst:159
282283
msgid ""
283284
"However, not all string values used as annotations can be successfully "
284285
"turned into Python values by :func:`eval`. String values could theoretically "
@@ -290,21 +291,21 @@ msgstr ""
290291
"理論上,字串值可以包含任何有效的字串,並且在實踐中,型別提示存在有效的用例,"
291292
"需要使用特定「無法」評估的字串值進行註釋。例如: ::"
292293

293-
#: ../../howto/annotations.rst:165
294+
#: ../../howto/annotations.rst:166
294295
msgid ""
295296
":pep:`604` union types using ``|``, before support for this was added to "
296297
"Python 3.10."
297298
msgstr ""
298299
"在 Python 3.10 支援 :pep:`604` 聯合型別 (union type) ``|`` 之前使用它。"
299300

300-
#: ../../howto/annotations.rst:167
301+
#: ../../howto/annotations.rst:168
301302
msgid ""
302303
"Definitions that aren't needed at runtime, only imported when :const:`typing."
303304
"TYPE_CHECKING` is true."
304305
msgstr ""
305306
"Runtime 中不需要的定義,僅在 :const:`typing.TYPE_CHECKING` 為 true 時匯入。"
306307

307-
#: ../../howto/annotations.rst:170
308+
#: ../../howto/annotations.rst:171
308309
msgid ""
309310
"If :func:`eval` attempts to evaluate such values, it will fail and raise an "
310311
"exception. So, when designing a library API that works with annotations, "
@@ -314,27 +315,27 @@ msgstr ""
314315
"如果 :func:`eval` 嘗試計算這類型的值,它將失敗並引發例外。因此,在設計使用註"
315316
"釋的函式庫 API 時,建議僅在呼叫者 (caller) 明確請求時嘗試評估字串值。"
316317

317-
#: ../../howto/annotations.rst:178
318+
#: ../../howto/annotations.rst:179
318319
msgid "Best Practices For ``__annotations__`` In Any Python Version"
319320
msgstr "任何 Python 版本中 ``__annotations__`` 的最佳實踐"
320321

321-
#: ../../howto/annotations.rst:180
322+
#: ../../howto/annotations.rst:181
322323
msgid ""
323324
"You should avoid assigning to the ``__annotations__`` member of objects "
324325
"directly. Let Python manage setting ``__annotations__``."
325326
msgstr ""
326327
"你應該避免直接指派給物件的 ``__annotations__`` 成員。讓 Python 管理設定 "
327328
"``__annotations__``。"
328329

329-
#: ../../howto/annotations.rst:183
330+
#: ../../howto/annotations.rst:184
330331
msgid ""
331332
"If you do assign directly to the ``__annotations__`` member of an object, "
332333
"you should always set it to a ``dict`` object."
333334
msgstr ""
334335
"如果你直接指派給物件的 ``__annotations__`` 成員,則應始終將其設為 ``dict`` 物"
335336
"件。"
336337

337-
#: ../../howto/annotations.rst:186
338+
#: ../../howto/annotations.rst:187
338339
msgid ""
339340
"If you directly access the ``__annotations__`` member of an object, you "
340341
"should ensure that it's a dictionary before attempting to examine its "
@@ -343,20 +344,20 @@ msgstr ""
343344
"如果直接存取物件的 ``__annotations__`` 成員,則應在嘗試檢查其內容之前確保它是"
344345
"字典。"
345346

346-
#: ../../howto/annotations.rst:190
347+
#: ../../howto/annotations.rst:191
347348
msgid "You should avoid modifying ``__annotations__`` dicts."
348349
msgstr "你應該避免修改 ``__annotations__`` 字典。"
349350

350-
#: ../../howto/annotations.rst:192
351+
#: ../../howto/annotations.rst:193
351352
msgid ""
352353
"You should avoid deleting the ``__annotations__`` attribute of an object."
353354
msgstr "你應該避免刪除物件的 ``__annotations__`` 屬性。"
354355

355-
#: ../../howto/annotations.rst:197
356+
#: ../../howto/annotations.rst:198
356357
msgid "``__annotations__`` Quirks"
357358
msgstr "``__annotations__`` 奇異之處"
358359

359-
#: ../../howto/annotations.rst:199
360+
#: ../../howto/annotations.rst:200
360361
msgid ""
361362
"In all versions of Python 3, function objects lazy-create an annotations "
362363
"dict if no annotations are defined on that object. You can delete the "
@@ -374,13 +375,13 @@ msgstr ""
374375
"上的註釋將拋出 ``AttributeError``;連續兩次使用 ``del fn.__annotations__`` 保"
375376
"證總是拋出 ``AttributeError`` 。"
376377

377-
#: ../../howto/annotations.rst:209
378+
#: ../../howto/annotations.rst:210
378379
msgid ""
379380
"Everything in the above paragraph also applies to class and module objects "
< C65A code>380381
"in Python 3.10 and newer."
381382
msgstr "上一段的所有內容也適用於 Python 3.10 及更高版本中的類別和模組物件。"
382383

383-
#: ../../howto/annotations.rst:212
384+
#: ../../howto/annotations.rst:213
384385
msgid ""
385386
"In all versions of Python 3, you can set ``__annotations__`` on a function "
386387
"object to ``None``. However, subsequently accessing the annotations on that "
@@ -396,7 +397,7 @@ msgstr ""
396397
"\\ *並非如此*\\;這些物件允許將 ``__annotations__`` 設定為任何 Python 值,並"
397398
"且將保留設定的任何值。"
398399

399-
#: ../../howto/annotations.rst:220
400+
#: ../../howto/annotations.rst:221
400401
msgid ""
401402
"If Python stringizes your annotations for you (using ``from __future__ "
402403
"import annotations``), and you specify a string as an annotation, the string "
@@ -407,7 +408,7 @@ msgstr ""
407408
"annotations``),並且你指定一個字串作為註釋,則該字串本身將被引用。實際上,註"
408409
"釋被引用了\\ *兩次。*\\ 例如: ::"
409410

410-
#: ../../howto/annotations.rst:231
411+
#: ../../howto/annotations.rst:232
411412
msgid ""
412413
"This prints ``{'a': \"'str'\"}``. This shouldn't really be considered a "
413414
"\"quirk\"; it's mentioned here simply because it might be surprising."

0 commit comments

Comments
 (0)
0