Skip to content

Commit 2a5f362

Browse files
pydoc-zh-tw[bot]github-actions[bot]mattwang44
authored
Sync with CPython 3.14 (#1211)
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com> Co-authored-by: Matt.Wang <mattwang44@gmail.com>
1 parent dbb19df commit 2a5f362

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

52 files changed

+7331
-6693
lines changed

c-api/frame.po

Lines changed: 45 additions & 42 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ msgid ""
55
msgstr ""
66
"Project-Id-Version: Python 3.14\n"
77
"Report-Msgid-Bugs-To: \n"
8-
"POT-Creation-Date: 2025-11-11 00:15+0000\n"
8+
"POT-Creation-Date: 2026-02-28 00:16+0000\n"
99
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
1010
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
1111
"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -77,80 +77,83 @@ msgstr ""
7777

7878
#: ../../c-api/frame.rst:51
7979
msgid ""
80-
"Return a :term:`strong reference`, or ``NULL`` if *frame* has no outer frame."
80+
"Return a :term:`strong reference`, or ``NULL`` if *frame* has no outer "
81+
"frame. This raises no exceptions."
8182
msgstr ""
83+
"回傳一個 :term:`strong reference`,如果 *frame* 沒有外層 frame 則回傳 "
84+
"``NULL``。此函式不會引發例外。"
8285

83-
#: ../../c-api/frame.rst:59
86+
#: ../../c-api/frame.rst:60
8487
msgid "Get the *frame*'s :attr:`~frame.f_builtins` attribute."
8588
msgstr "取得 *frame* 的 :attr:`~frame.f_builtins` 屬性。"
8689

87-
#: ../../c-api/frame.rst:61 ../../c-api/frame.rst:92
90+
#: ../../c-api/frame.rst:62 ../../c-api/frame.rst:93
8891
msgid "Return a :term:`strong reference`. The result cannot be ``NULL``."
8992
msgstr "回傳 :term:`strong reference`。結果不能為 ``NULL``。"
9093

91-
#: ../../c-api/frame.rst:68
94+
#: ../../c-api/frame.rst:69
9295
msgid "Get the *frame* code."
9396
msgstr ""
9497

95-
#: ../../c-api/frame.rst:70 ../../c-api/frame.rst:136
98+
#: ../../c-api/frame.rst:71 ../../c-api/frame.rst:137
9699
msgid "Return a :term:`strong reference`."
97100
msgstr "回傳 :term:`strong reference`。"
98101

99-
#: ../../c-api/frame.rst:72
102+
#: ../../c-api/frame.rst:73
100103
msgid "The result (frame code) cannot be ``NULL``."
101104
msgstr ""
102105

103-
#: ../../c-api/frame.rst:79
106+
#: ../../c-api/frame.rst:80
104107
msgid ""
105108
"Get the generator, coroutine, or async generator that owns this frame, or "
106109
"``NULL`` if this frame is not owned by a generator. Does not raise an "
107110
"exception, even if the return value is ``NULL``."
108111
msgstr ""
109112

110-
#: ../../c-api/frame.rst:83
113+
#: ../../c-api/frame.rst:84
111114
msgid "Return a :term:`strong reference`, or ``NULL``."
112115
msgstr "回傳 :term:`strong reference` 或 ``NULL``。"
113116

114-
#: ../../c-api/frame.rst:90
117+
#: ../../c-api/frame.rst:91
115118
msgid "Get the *frame*'s :attr:`~frame.f_globals` attribute."
116119
msgstr "取得 *frame* 的 :attr:`~frame.f_globals` 屬性。"
117120

118-
#: ../../c-api/frame.rst:99
121+
#: ../../c-api/frame.rst:100
119122
msgid "Get the *frame*'s :attr:`~frame.f_lasti` attribute."
120123
msgstr "取得 *frame* 的 :attr:`~frame.f_lasti` 屬性。"
121124

122-
#: ../../c-api/frame.rst:101
125+
#: ../../c-api/frame.rst:102
123126
msgid "Returns -1 if ``frame.f_lasti`` is ``None``."
124127
msgstr "如果 ``frame.f_lasti`` 是 ``None`` 則回傳 -1。"
125128

126-
#: ../../c-api/frame.rst:108
129+
#: ../../c-api/frame.rst:109
127130
msgid "Get the variable *name* of *frame*."
128131
msgstr "取得 *frame* 的變數 *name*。"
129132

130-
#: ../../c-api/frame.rst:110
133+
#: ../../c-api/frame.rst:111
131134
msgid "Return a :term:`strong reference` to the variable value on success."
132135
msgstr "在成功時回傳變數值的 :term:`strong reference`。"
133136

134-
#: ../../c-api/frame.rst:111
137+
#: ../../c-api/frame.rst:112
135138
msgid ""
136139
"Raise :exc:`NameError` and return ``NULL`` if the variable does not exist."
137140
msgstr "如果變數不存在,則引發 :exc:`NameError` 並回傳 ``NULL``。"
138141

139-
#: ../../c-api/frame.rst:112
142+
#: ../../c-api/frame.rst:113
140143
msgid "Raise an exception and return ``NULL`` on error."
141144
msgstr "在錯誤時引發例外並回傳 ``NULL``。"
142145

143-
#: ../../c-api/frame.rst:114
146+
#: ../../c-api/frame.rst:115
144147
msgid "*name* type must be a :class:`str`."
145148
msgstr "*name* 的型別必須是 :class:`str`。"
146149

147-
#: ../../c-api/frame.rst:121
150+
#: ../../c-api/frame.rst:122
148151
msgid ""
149152
"Similar to :c:func:`PyFrame_GetVar`, but the variable name is a C string "
150153
"encoded in UTF-8."
151154
msgstr ""
152155

153-
#: ../../c-api/frame.rst:129
156+
#: ../../c-api/frame.rst:130
154157
msgid ""
155158
"Get the *frame*'s :attr:`~frame.f_locals` attribute. If the frame refers to "
156159
"an :term:`optimized scope`, this returns a write-through proxy object that "
@@ -159,21 +162,21 @@ msgid ""
159162
"directly (as described for :func:`locals`)."
160163
msgstr ""
161164

162-
#: ../../c-api/frame.rst:140
165+
#: ../../c-api/frame.rst:141
163166
msgid ""
164167
"As part of :pep:`667`, return an instance of :c:var:"
165168
"`PyFrameLocalsProxy_Type`."
166169
msgstr ""
167170

168-
#: ../../c-api/frame.rst:146
171+
#: ../../c-api/frame.rst:147
169172
msgid "Return the line number that *frame* is currently executing."
170173
msgstr ""
171174

172-
#: ../../c-api/frame.rst:150
175+
#: ../../c-api/frame.rst:151
173176
msgid "Frame Locals Proxies"
174177
msgstr ""
175178

176-
#: ../../c-api/frame.rst:154
179+
#: ../../c-api/frame.rst:155
177180
msgid ""
178181
"The :attr:`~frame.f_locals` attribute on a :ref:`frame object <frame-"
179182
"objects>` is an instance of a \"frame-locals proxy\". The proxy object "
@@ -182,34 +185,34 @@ msgid ""
182185
"to date with the live local variables in the frame itself."
183186
msgstr ""
184187

185-
#: ../../c-api/frame.rst:160
188+
#: ../../c-api/frame.rst:161
186189
msgid "See :pep:`667` for more information."
187190
msgstr "更多資訊請參閱 :pep:`667`。"
188191

189-
#: ../../c-api/frame.rst:164
192+
#: ../../c-api/frame.rst:165
190193
msgid "The type of frame :func:`locals` proxy objects."
191194
msgstr ""
192195

193-
#: ../../c-api/frame.rst:168
196+
#: ../../c-api/frame.rst:169
194197
msgid "Return non-zero if *obj* is a frame :func:`locals` proxy."
195198
msgstr ""
196199

197-
#: ../../c-api/frame.rst:172
200+
#: ../../c-api/frame.rst:173
198201
msgid "Legacy Local Variable APIs"
199202
msgstr ""
200203

201-
#: ../../c-api/frame.rst:174
204+
#: ../../c-api/frame.rst:175
202205
msgid ""
203206
"These APIs are :term:`soft deprecated`. As of Python 3.13, they do nothing. "
204207
"They exist solely for backwards compatibility."
205208
msgstr ""
206209

207-
#: ../../c-api/frame.rst:180 ../../c-api/frame.rst:194
208-
#: ../../c-api/frame.rst:207
210+
#: ../../c-api/frame.rst:181 ../../c-api/frame.rst:195
211+
#: ../../c-api/frame.rst:208
209212
msgid "This function is :term:`soft deprecated` and does nothing."
210213
msgstr ""
211214

212-
#: ../../c-api/frame.rst:182
215+
#: ../../c-api/frame.rst:183
213216
msgid ""
214217
"Prior to Python 3.13, this function would copy the :attr:`~frame.f_locals` "
215218
"attribute of *f* to the internal \"fast\" array of local variables, allowing "
@@ -218,51 +221,51 @@ msgid ""
218221
"dictionary."
219222
msgstr ""
220223

221-
#: ../../c-api/frame.rst:188 ../../c-api/frame.rst:201
222-
#: ../../c-api/frame.rst:213
224+
#: ../../c-api/frame.rst:189 ../../c-api/frame.rst:202
225+
#: ../../c-api/frame.rst:214
223226
msgid "This function now does nothing."
224227
msgstr ""
225228

226-
#: ../../c-api/frame.rst:196
229+
#: ../../c-api/frame.rst:197
227230
msgid ""
228231
"Prior to Python 3.13, this function would copy the internal \"fast\" array "
229232
"of local variables (which is used by the interpreter) to the :attr:`~frame."
230233
"f_locals` attribute of *f*, allowing changes in local variables to be "
231234
"visible to frame objects."
232235
msgstr ""
233236

234-
#: ../../c-api/frame.rst:209
237+
#: ../../c-api/frame.rst:210
235238
msgid ""
236239
"Prior to Python 3.13, this function was similar to :c:func:"
237240
"`PyFrame_FastToLocals`, but would return ``0`` on success, and ``-1`` with "
238241
"an exception set on failure."
239242
msgstr ""
240243

241-
#: ../../c-api/frame.rst:218
244+
#: ../../c-api/frame.rst:219
242245
msgid ":pep:`667`"
243246
msgstr ":pep:`667`"
244247

245-
#: ../../c-api/frame.rst:222
248+
#: ../../c-api/frame.rst:223
246249
msgid "Internal Frames"
247250
msgstr ""
248251

249-
#: ../../c-api/frame.rst:224
252+
#: ../../c-api/frame.rst:225
250253
msgid "Unless using :pep:`523`, you will not need this."
251254
msgstr ""
252255

253-
#: ../../c-api/frame.rst:228
256+
#: ../../c-api/frame.rst:229
254257
msgid "The interpreter's internal frame representation."
255258
msgstr ""
256259

257-
#: ../../c-api/frame.rst:234
260+
#: ../../c-api/frame.rst:235
258261
msgid "Return a :term:`strong reference` to the code object for the frame."
259262
msgstr ""
260263

261-
#: ../../c-api/frame.rst:241
264+
#: ../../c-api/frame.rst:242
262265
msgid "Return the byte offset into the last executed instruction."
263266
msgstr ""
264267

265-
#: ../../c-api/frame.rst:248
268+
#: ../../c-api/frame.rst:249
266269
msgid ""
267270
"Return the currently executing line number, or -1 if there is no line number."
268271
msgstr ""

c-api/interp-lifecycle.po

Lines changed: 67 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -7,10 +7,11 @@ msgid ""
77
msgstr ""
88
"Project-Id-Version: Python 3.14\n"
99
"Report-Msgid-Bugs-To: \n"
10-
"POT-Creation-Date: 2026-02-24 00:20+0000\n"
10+
"POT-Creation-Date: 2026-02-26 18:22+0000\n"
1111
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
1212
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
13-
"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-tw)\n"
13+
"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
14+
"tw)\n"
1415
"Language: zh_TW\n"
1516
"MIME-Version: 1.0\n"
1617
"Content-Type: text/plain; charset=UTF-8\n"
@@ -24,7 +25,9 @@ msgstr "直譯器的初始化與終結化"
2425
msgid ""
2526
"See :ref:`Python Initialization Configuration <init-config>` for details on "
2627
"how to configure the interpreter prior to initialization."
27-
msgstr "關於如何在初始化之前設定直譯器的細節,請參見 :ref:`Python 初始化設定 <init-config>`。"
28+
msgstr ""
29+
"關於如何在初始化之前設定直譯器的細節,請參見 :ref:`Python 初始化設定 <init-"
30+
"config>`。"
2831

2932
#: ../../c-api/interp-lifecycle.rst:14
3033
msgid "Before Python initialization"
@@ -273,7 +276,8 @@ msgstr ""
273276
msgid ""
274277
"Set by the :option:`-B` option and the :envvar:`PYTHONDONTWRITEBYTECODE` "
275278
"environment variable."
276-
msgstr "由 :option:`-B` 選項與 :envvar:`PYTHONDONTWRITEBYTECODE` 環境變數設定。"
279+
msgstr ""
280+
"由 :option:`-B` 選項與 :envvar:`PYTHONDONTWRITEBYTECODE` 環境變數設定。"
277281

278282
#: ../../c-api/interp-lifecycle.rst:142
279283
msgid ""
@@ -297,7 +301,8 @@ msgstr ""
297301
msgid ""
298302
"Set to ``1`` if the :envvar:`PYTHONHASHSEED` environment variable is set to "
299303
"a non-empty string."
300-
msgstr "如果環境變數 :envvar:`PYTHONHASHSEED` 被設定為一個非空字串則設為 ``1``。"
304+
msgstr ""
305+
"如果環境變數 :envvar:`PYTHONHASHSEED` 被設定為一個非空字串則設為 ``1``。"
301306

302307
#: ../../c-api/interp-lifecycle.rst:161
303308
msgid ""
@@ -317,8 +322,8 @@ msgid ""
317322
"Ignore all :envvar:`!PYTHON*` environment variables, e.g. :envvar:"
318323
"`PYTHONPATH` and :envvar:`PYTHONHOME`, that might be set."
319324
msgstr ""
320-
"忽略所有可能被設定的 :envvar:`!PYTHON*` 環境變數,例如 :envvar:`PYTHONPATH` "
321-
":envvar:`PYTHONHOME`。"
325+
"忽略所有可能被設定的 :envvar:`!PYTHON*` 環境變數,例如 :envvar:`PYTHONPATH` "
326+
":envvar:`PYTHONHOME`。"
322327

323328
#: ../../c-api/interp-lifecycle.rst:176
324329
msgid "Set by the :option:`-E` and :option:`-I` options."
@@ -390,7 +395,9 @@ msgstr ""
390395
msgid ""
391396
"Set to ``1`` if the :envvar:`PYTHONLEGACYWINDOWSFSENCODING` environment "
392397
"variable is set to a non-empty string."
393-
msgstr "如果環境變數 :envvar:`PYTHONLEGACYWINDOWSFSENCODING` 被設定為一個非空字串則設為 ``1``。"
398+
msgstr ""
399+
"如果環境變數 :envvar:`PYTHONLEGACYWINDOWSFSENCODING` 被設定為一個非空字串則設"
400+
"為 ``1``。"
394401

395402
#: ../../c-api/interp-lifecycle.rst:237
396403
msgid "See :pep:`529` for more details."
@@ -459,7 +466,9 @@ msgstr ""
459466
msgid ""
460467
"Set by the :option:`-s` and :option:`-I` options, and the :envvar:"
461468
"`PYTHONNOUSERSITE` environment variable."
462-
msgstr "由 :option:`-s` 選項、:option:`-I` 選項與 :envvar:`PYTHONNOUSERSITE` 環境變數設定。"
469+
msgstr ""
470+
"由 :option:`-s` 選項、:option:`-I` 選項與 :envvar:`PYTHONNOUSERSITE` 環境變數"
471+
"設定。"
463472

464473
#: ../../c-api/interp-lifecycle.rst:296
465474
msgid ""
@@ -663,7 +672,9 @@ msgstr ""
663672
msgid ""
664673
"Raises an :ref:`auditing event <auditing>` ``cpython."
665674
"_PySys_ClearAuditHooks`` with no arguments."
666-
msgstr "引發一個不附帶引數的\\ :ref:`稽核事件 <auditing>` ``cpython._PySys_ClearAuditHooks``。"
675+
msgstr ""
676+
"引發一個不附帶引數的\\ :ref:`稽核事件 <auditing>` ``cpython."
677+
"_PySys_ClearAuditHooks``。"
667678

668679
#: ../../c-api/interp-lifecycle.rst:476
669680
msgid ""
@@ -1143,6 +1154,52 @@ msgid ""
11431154
"`Python Initialization Configuration <init-config>`."
11441155
msgstr ""
11451156

1157+
#: ../../c-api/interp-lifecycle.rst:906
1158+
msgid ""
1159+
"This function works like :c:func:`PySys_SetArgvEx` with *updatepath* set to "
1160+
"``1`` unless the :program:`python` interpreter was started with the :option:"
1161+
"`-I`."
1162+
msgstr ""
1163+
1164+
#: ../../c-api/interp-lifecycle.rst:916
1165+
msgid "The *updatepath* value depends on :option:`-I`."
1166+
msgstr ""
1167+
1168+
#: ../../c-api/interp-lifecycle.rst:923
1169+
msgid ""
1170+
"This API is kept for backward compatibility: setting :c:member:`PyConfig."
1171+
"home` should be used instead, see :ref:`Python Initialization Configuration "
1172+
"<init-config>`."
1173+
msgstr ""
1174+
1175+
#: ../../c-api/interp-lifecycle.rst:927
1176+
msgid ""
1177+
"Set the default \"home\" directory, that is, the location of the standard "
1178+
"Python libraries. See :envvar:`PYTHONHOME` for the meaning of the argument "
1179+
"string."
1180+
msgstr ""
1181+
1182+
#: ../../c-api/interp-lifecycle.rst:931
1183+
msgid ""
1184+
"The argument should point to a zero-terminated character string in static "
1185+
"storage whose contents will not change for the duration of the program's "
1186+
"execution. No code in the Python interpreter will change the contents of "
1187+
"this storage."
1188+
msgstr ""
1189+
1190+
#: ../../c-api/interp-lifecycle.rst:944
1191+
msgid ""
1192+
"Return the default \"home\", that is, the value set by :c:member:`PyConfig."
1193+
"home`, or the value of the :envvar:`PYTHONHOME` environment variable if it "
1194+
"is set."
1195+
msgstr ""
1196+
1197+
#: ../../c-api/interp-lifecycle.rst:954
1198+
msgid ""
1199+
"Use :c:func:`PyConfig_Get(\"home\") <PyConfig_Get>` or the :envvar:"
1200+
"`PYTHONHOME` environment variable instead."
1201+
msgstr ""
1202+
11461203
#: ../../c-api/interp-lifecycle.rst:357
11471204
msgid "PyEval_InitThreads()"
11481205
msgstr "PyEval_InitThreads()"

0 commit comments

Comments
 (0)