Skip to content

Commit 5ffa35b

Browse files
pydoc-zh-tw[bot]github-actions[bot]mattwang44
authored
Sync with CPython 3.11 (python#362)
* sync with cpython d74117ac * sync with cpython d279f38a * sync with cpython 0006d9bf * sync with cpython 193a25e8 * sync with cpython f1609964 * sync with cpython 5bbf8ed8 * sync with cpython 8dafefca * fix: resolve fuzzy entries Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com> Co-authored-by: Matt.Wang <[email protected]>
1 parent 091ad0d commit 5ffa35b

23 files changed

+4547
-4347
lines changed

c-api/typeobj.po

+617-591
Large diffs are not rendered by default.

library/asyncio-task.po

+217-209
Large diffs are not rendered by default.

library/base64.po

+63-51
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ msgid ""
88
msgstr ""
99
"Project-Id-Version: Python 3.11\n"
1010
"Report-Msgid-Bugs-To: \n"
11-
"POT-Creation-Date: 2022-10-15 20:43+0000\n"
11+
"POT-Creation-Date: 2022-11-30 00:19+0000\n"
1212
"PO-Revision-Date: 2018-05-23 14:39+0000\n"
1313
"Last-Translator: Adrian Liaw <[email protected]>\n"
1414
"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -93,92 +93,104 @@ msgstr ""
9393

9494
#: ../../library/base64.rst:56
9595
msgid ""
96-
"Optional *altchars* must be a :term:`bytes-like object` of at least length 2 "
97-
"(additional characters are ignored) which specifies an alternative alphabet "
98-
"for the ``+`` and ``/`` characters. This allows an application to e.g. "
99-
"generate URL or filesystem safe Base64 strings. The default is ``None``, "
100-
"for which the standard Base64 alphabet is used."
96+
"Optional *altchars* must be a :term:`bytes-like object` of length 2 which "
97+
"specifies an alternative alphabet for the ``+`` and ``/`` characters. This "
98+
"allows an application to e.g. generate URL or filesystem safe Base64 "
99+
"strings. The default is ``None``, for which the standard Base64 alphabet is "
100+
"used."
101101
msgstr ""
102102

103-
#: ../../library/base64.rst:65
103+
#: ../../library/base64.rst:61
104+
msgid ""
105+
"May assert or raise a a :exc:`ValueError` if the length of *altchars* is not "
106+
"2. Raises a :exc:`TypeError` if *altchars* is not a :term:`bytes-like "
107+
"object`."
108+
msgstr ""
109+
110+
#: ../../library/base64.rst:67
104111
msgid ""
105112
"Decode the Base64 encoded :term:`bytes-like object` or ASCII string *s* and "
106113
"return the decoded :class:`bytes`."
107114
msgstr ""
108115

109-
#: ../../library/base64.rst:68
116+
#: ../../library/base64.rst:70
110117
msgid ""
111118
"Optional *altchars* must be a :term:`bytes-like object` or ASCII string of "
112-
"at least length 2 (additional characters are ignored) which specifies the "
113-
"alternative alphabet used instead of the ``+`` and ``/`` characters."
119+
"length 2 which specifies the alternative alphabet used instead of the ``+`` "
120+
"and ``/`` characters."
114121
msgstr ""
115122

116-
#: ../../library/base64.rst:72
123+
#: ../../library/base64.rst:74
117124
msgid ""
118125
"A :exc:`binascii.Error` exception is raised if *s* is incorrectly padded."
119126
msgstr ""
120127

121-
#: ../../library/base64.rst:75
128+
#: ../../library/base64.rst:77
122129
msgid ""
123130
"If *validate* is ``False`` (the default), characters that are neither in the "
124131
"normal base-64 alphabet nor the alternative alphabet are discarded prior to "
125132
"the padding check. If *validate* is ``True``, these non-alphabet characters "
126133
"in the input result in a :exc:`binascii.Error`."
127134
msgstr ""
128135

129-
#: ../../library/base64.rst:81
136+
#: ../../library/base64.rst:83
130137
msgid ""
131138
"For more information about the strict base64 check, see :func:`binascii."
132139
"a2b_base64`"
133140
msgstr ""
134141

135-
#: ../../library/base64.rst:86
142+
#: ../../library/base64.rst:85
143+
msgid ""
144+
"May assert or raise a :exc:`ValueError` if the length of *altchars* is not 2."
145+
msgstr ""
146+
147+
#: ../../library/base64.rst:89
136148
msgid ""
137149
"Encode :term:`bytes-like object` *s* using the standard Base64 alphabet and "
138150
"return the encoded :class:`bytes`."
139151
msgstr ""
140152

141-
#: ../../library/base64.rst:92
153+
#: ../../library/base64.rst:95
142154
msgid ""
143155
"Decode :term:`bytes-like object` or ASCII string *s* using the standard "
144156
"Base64 alphabet and return the decoded :class:`bytes`."
145157
msgstr ""
146158

147-
#: ../../library/base64.rst:98
159+
#: ../../library/base64.rst:101
148160
msgid ""
149161
"Encode :term:`bytes-like object` *s* using the URL- and filesystem-safe "
150162
"alphabet, which substitutes ``-`` instead of ``+`` and ``_`` instead of ``/"
151163
"`` in the standard Base64 alphabet, and return the encoded :class:`bytes`. "
152164
"The result can still contain ``=``."
153165
msgstr ""
154166

155-
#: ../../library/base64.rst:107
167+
#: ../../library/base64.rst:110
156168
msgid ""
157169
"Decode :term:`bytes-like object` or ASCII string *s* using the URL- and "
158170
"filesystem-safe alphabet, which substitutes ``-`` instead of ``+`` and ``_`` "
159171
"instead of ``/`` in the standard Base64 alphabet, and return the decoded :"
160172
"class:`bytes`."
161173
msgstr ""
162174

163-
#: ../../library/base64.rst:116
175+
#: ../../library/base64.rst:119
164176
msgid ""
165177
"Encode the :term:`bytes-like object` *s* using Base32 and return the "
166178
"encoded :class:`bytes`."
167179
msgstr ""
168180

169-
#: ../../library/base64.rst:122
181+
#: ../../library/base64.rst:125
170182
msgid ""
171183
"Decode the Base32 encoded :term:`bytes-like object` or ASCII string *s* and "
172184
"return the decoded :class:`bytes`."
173185
msgstr ""
174186

175-
#: ../../library/base64.rst:125 ../../library/base64.rst:173
187+
#: ../../library/base64.rst:128 ../../library/base64.rst:176
176188
msgid ""
177189
"Optional *casefold* is a flag specifying whether a lowercase alphabet is "
178190
"acceptable as input. For security purposes, the default is ``False``."
179191
msgstr ""
180192

181-
#: ../../library/base64.rst:129
193+
#: ../../library/base64.rst:132
182194
msgid ""
183195
":rfc:`4648` allows for optional mapping of the digit 0 (zero) to the letter "
184196
"O (oh), and for optional mapping of the digit 1 (one) to either the letter I "
@@ -189,141 +201,141 @@ msgid ""
189201
"input."
190202
msgstr ""
191203

192-
#: ../../library/base64.rst:136 ../../library/base64.rst:177
204+
#: ../../library/base64.rst:139 ../../library/base64.rst:180
193205
msgid ""
194206
"A :exc:`binascii.Error` is raised if *s* is incorrectly padded or if there "
195207
"are non-alphabet characters present in the input."
196208
msgstr ""
197209

198-
#: ../../library/base64.rst:143
210+
#: ../../library/base64.rst:146
199211
msgid ""
200212
"Similar to :func:`b32encode` but uses the Extended Hex Alphabet, as defined "
201213
"in :rfc:`4648`."
202214
msgstr ""
203215

204-
#: ../../library/base64.rst:151
216+
#: ../../library/base64.rst:154
205217
msgid ""
206218
"Similar to :func:`b32decode` but uses the Extended Hex Alphabet, as defined "
207219
"in :rfc:`4648`."
208220
msgstr ""
209221

210-
#: ../../library/base64.rst:154
222+
#: ../../library/base64.rst:157
211223
msgid ""
212224
"This version does not allow the digit 0 (zero) to the letter O (oh) and "
213225
"digit 1 (one) to either the letter I (eye) or letter L (el) mappings, all "
214226
"these characters are included in the Extended Hex Alphabet and are not "
215227
"interchangeable."
216228
msgstr ""
217229

218-
#: ../../library/base64.rst:164
230+
#: ../../library/base64.rst:167
219231
msgid ""
220232
"Encode the :term:`bytes-like object` *s* using Base16 and return the "
221233
"encoded :class:`bytes`."
222234
msgstr ""
223235

224-
#: ../../library/base64.rst:170
236+
#: ../../library/base64.rst:173
225237
msgid ""
226238
"Decode the Base16 encoded :term:`bytes-like object` or ASCII string *s* and "
227239
"return the decoded :class:`bytes`."
228240
msgstr ""
229241

230-
#: ../../library/base64.rst:184
242+
#: ../../library/base64.rst:187
231243
msgid ""
232244
"Encode the :term:`bytes-like object` *b* using Ascii85 and return the "
233245
"encoded :class:`bytes`."
234246
msgstr ""
235247

236-
#: ../../library/base64.rst:187
248+
#: ../../library/base64.rst:190
237249
msgid ""
238250
"*foldspaces* is an optional flag that uses the special short sequence 'y' "
239251
"instead of 4 consecutive spaces (ASCII 0x20) as supported by 'btoa'. This "
240252
"feature is not supported by the \"standard\" Ascii85 encoding."
241253
msgstr ""
242254

243-
#: ../../library/base64.rst:191
255+
#: ../../library/base64.rst:194
244256
msgid ""
245257
"*wrapcol* controls whether the output should have newline (``b'\\n'``) "
246258
"characters added to it. If this is non-zero, each output line will be at "
247259
"most this many characters long."
248260
msgstr ""
249261

250-
#: ../../library/base64.rst:195
262+
#: ../../library/base64.rst:198
251263
msgid ""
252264
"*pad* controls whether the input is padded to a multiple of 4 before "
253265
"encoding. Note that the ``btoa`` implementation always pads."
254266
msgstr ""
255267

256-
#: ../../library/base64.rst:198
268+
#: ../../library/base64.rst:201
257269
msgid ""
258270
"*adobe* controls whether the encoded byte sequence is framed with ``<~`` and "
259271
"``~>``, which is used by the Adobe implementation."
260272
msgstr ""
261273

262-
#: ../../library/base64.rst:206
274+
#: ../../library/base64.rst:209
263275
msgid ""
264276
"Decode the Ascii85 encoded :term:`bytes-like object` or ASCII string *b* and "
265277
"return the decoded :class:`bytes`."
266278
msgstr ""
267279

268-
#: ../../library/base64.rst:209
280+
#: ../../library/base64.rst:212
269281
msgid ""
270282
"*foldspaces* is a flag that specifies whether the 'y' short sequence should "
271283
"be accepted as shorthand for 4 consecutive spaces (ASCII 0x20). This feature "
272284
"is not supported by the \"standard\" Ascii85 encoding."
273285
msgstr ""
274286

275-
#: ../../library/base64.rst:213
287+
#: ../../library/base64.rst:216
276288
msgid ""
277289
"*adobe* controls whether the input sequence is in Adobe Ascii85 format (i.e. "
278290
"is framed with <~ and ~>)."
279291
msgstr ""
280292

281-
#: ../../library/base64.rst:216
293+
#: ../../library/base64.rst:219
282294
msgid ""
283295
"*ignorechars* should be a :term:`bytes-like object` or ASCII string "
284296
"containing characters to ignore from the input. This should only contain "
285297
"whitespace characters, and by default contains all whitespace characters in "
286298
"ASCII."
287299
msgstr ""
288300

289-
#: ../../library/base64.rst:226
301+
#: ../../library/base64.rst:229
290302
msgid ""
291303
"Encode the :term:`bytes-like object` *b* using base85 (as used in e.g. git-"
292304
"style binary diffs) and return the encoded :class:`bytes`."
293305
msgstr ""
294306

295-
#: ../../library/base64.rst:229
307+
#: ../../library/base64.rst:232
296308
msgid ""
297309
"If *pad* is true, the input is padded with ``b'\\0'`` so its length is a "
298310
"multiple of 4 bytes before encoding."
299311
msgstr ""
300312

301-
#: ../../library/base64.rst:237
313+
#: ../../library/base64.rst:240
302314
msgid ""
303315
"Decode the base85-encoded :term:`bytes-like object` or ASCII string *b* and "
304316
"return the decoded :class:`bytes`. Padding is implicitly removed, if "
305317
"necessary."
306318
msgstr ""
307319

308-
#: ../../library/base64.rst:244
320+
#: ../../library/base64.rst:247
309321
msgid "The legacy interface:"
310322
msgstr ""
311323

312-
#: ../../library/base64.rst:248
324+
#: ../../library/base64.rst:251
313325
msgid ""
314326
"Decode the contents of the binary *input* file and write the resulting "
315327
"binary data to the *output* file. *input* and *output* must be :term:`file "
316328
"objects <file object>`. *input* will be read until ``input.readline()`` "
317329
"returns an empty bytes object."
318330
msgstr ""
319331

320-
#: ../../library/base64.rst:256
332+
#: ../../library/base64.rst:259
321333
msgid ""
322334
"Decode the :term:`bytes-like object` *s*, which must contain one or more "
323335
"lines of base64 encoded data, and return the decoded :class:`bytes`."
324336
msgstr ""
325337

326-
#: ../../library/base64.rst:264
338+
#: ../../library/base64.rst:267
327339
msgid ""
328340
"Encode the contents of the binary *input* file and write the resulting "
329341
"base64 encoded data to the *output* file. *input* and *output* must be :term:"
@@ -333,46 +345,46 @@ msgid ""
333345
"the output always ends with a newline, as per :rfc:`2045` (MIME)."
334346
msgstr ""
335347

336-
#: ../../library/base64.rst:274
348+
#: ../../library/base64.rst:277
337349
msgid ""
338350
"Encode the :term:`bytes-like object` *s*, which can contain arbitrary binary "
339351
"data, and return :class:`bytes` containing the base64-encoded data, with "
340352
"newlines (``b'\\n'``) inserted after every 76 bytes of output, and ensuring "
341353
"that there is a trailing newline, as per :rfc:`2045` (MIME)."
342354
msgstr ""
343355

344-
#: ../../library/base64.rst:282
356+
#: ../../library/base64.rst:285
345357
msgid "An example usage of the module:"
346358
msgstr ""
347359

348-
#: ../../library/base64.rst:295
360+
#: ../../library/base64.rst:298
349361
msgid "Security Considerations"
350362
msgstr ""
351363

352-
#: ../../library/base64.rst:297
364+
#: ../../library/base64.rst:300
353365
msgid ""
354366
"A new security considerations section was added to :rfc:`4648` (section 12); "
355367
"it's recommended to review the security section for any code deployed to "
356368
"production."
357369
msgstr ""
358370

359-
#: ../../library/base64.rst:303
371+
#: ../../library/base64.rst:306
360372
msgid "Module :mod:`binascii`"
361373
msgstr ":mod:`binascii` 模組"
362374

363-
#: ../../library/base64.rst:303
375+
#: ../../library/base64.rst:306
364376
msgid ""
365377
"Support module containing ASCII-to-binary and binary-to-ASCII conversions."
366378
msgstr ""
367379

368-
#: ../../library/base64.rst:306
380+
#: ../../library/base64.rst:309
369381
msgid ""
370382
":rfc:`1521` - MIME (Multipurpose Internet Mail Extensions) Part One: "
371383
"Mechanisms for Specifying and Describing the Format of Internet Message "
372384
"Bodies"
373385
msgstr ""
374386

375-
#: ../../library/base64.rst:306
387+
#: ../../library/base64.rst:309
376388
msgid ""
377389
"Section 5.2, \"Base64 Content-Transfer-Encoding,\" provides the definition "
378390
"of the base64 encoding."

0 commit comments

Comments
 (0)