FazBrowse GitHub Viewer
|
Trending
|
URL:
|
Home
Tools:
[Download Repo ZIP]
[View Raw Code]
[Original HTTPS Page]
python-docs-zh-tw/c-api/codec.html at gh-pages · python/python-docs-zh-tw · GitHub
python
python-docs-zh-tw
Repository navigation
Code
Issues
33
(33)
Pull requests
12
(12)
Discussions
Actions
Wiki
Security and quality
Insights
Expand file tree
Breadcrumbs
python-docs-zh-tw
/
c-api
/
codec.html
Copy path
More file actions
More file actions
Latest commit
History
History
History
508 lines (441 loc) · 44.2 KB
Breadcrumbs
python-docs-zh-tw
/
c-api
/
codec.html
Copy path
File metadata and controls
508 lines (441 loc) · 44.2 KB
Raw
Copy raw file
Download raw file
Open symbols panel
Edit and raw actions
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
<!DOCTYPE html
>
<
html
lang
="
zh-TW
"
data-content_root
="
../
"
>
<
head
>
<
meta
charset
="
utf-8
"
/>
<
meta
name
="
viewport
"
content
="
width=device-width, initial-scale=1.0
"
/>
<
meta
name
="
viewport
"
content
="
width=device-width, initial-scale=1
"
/>
<
title
>
編解碼器註冊表和支援函式 — Python 3.15.0 說明文件
</
title
>
<
meta
name
="
viewport
"
content
="
width=device-width, initial-scale=1.0
"
>
<
link
rel
="
stylesheet
"
type
="
text/css
"
href
="
../_static/pygments.css?v=b86133f3
"
/>
<
link
rel
="
stylesheet
"
type
="
text/css
"
href
="
../_static/classic.css?v=234b1a7c
"
/>
<
link
rel
="
stylesheet
"
type
="
text/css
"
href
="
../_static/pydoctheme.css?v=48df1187
"
/>
<
link
id
="
pygments_dark_css
"
media
="
(prefers-color-scheme: dark)
"
rel
="
stylesheet
"
type
="
text/css
"
href
="
../_static/pygments_dark.css?v=0fc419ee
"
/>
<
script
src
="
../_static/documentation_options.js?v=5d502324
"
>
</
script
>
<
script
src
="
../_static/doctools.js?v=9bcbadda
"
>
</
script
>
<
script
src
="
../_static/sphinx_highlight.js?v=dc90522c
"
>
</
script
>
<
script
src
="
../_static/translations.js?v=cbf116e0
"
>
</
script
>
<
script
src
="
../_static/sidebar.js
"
>
</
script
>
<
link
rel
="
search
"
type
="
application/opensearchdescription+xml
"
title
="
在 Python 3.15.0 說明文件 中搜尋
"
href
="
../_static/opensearch.xml
"
/>
<
link
rel
="
author
"
title
="
關於這些文件
"
href
="
../about.html
"
/>
<
link
rel
="
index
"
title
="
索引
"
href
="
../genindex.html
"
/>
<
link
rel
="
search
"
title
="
搜尋
"
href
="
../search.html
"
/>
<
link
rel
="
copyright
"
title
="
版權所有
"
href
="
../copyright.html
"
/>
<
link
rel
="
next
"
title
="
PyTime C API
"
href
="
time.html
"
/>
<
link
rel
="
prev
"
title
="
Reflection
"
href
="
reflection.html
"
/>
<
link
rel
="
canonical
"
href
="
https://docs.python.org/3/c-api/codec.html
"
>
<
style
>
@media
only
screen {
table
.
full-width-table
{
width
:
100
%
;
}
}
</
style
>
<
link
rel
="
stylesheet
"
href
="
../_static/pydoctheme_dark.css
"
media
="
(prefers-color-scheme: dark)
"
id
="
pydoctheme_dark_css
"
>
<
link
rel
="
shortcut icon
"
type
="
image/png
"
href
="
../_static/py.svg
"
>
<
script
type
="
text/javascript
"
src
="
../_static/copybutton.js
"
>
</
script
>
<
script
type
="
text/javascript
"
src
="
../_static/menu.js
"
>
</
script
>
<
script
type
="
text/javascript
"
src
="
../_static/search-focus.js
"
>
</
script
>
<
script
type
="
text/javascript
"
src
="
../_static/themetoggle.js
"
>
</
script
>
<
script
type
="
text/javascript
"
src
="
../_static/rtd_switcher.js
"
>
</
script
>
<
meta
name
="
readthedocs-addons-api-version
"
content
="
1
"
>
</
head
>
<
body
>
<
div
class
="
mobile-nav
"
>
<
input
type
="
checkbox
"
id
="
menuToggler
"
class
="
toggler__input
"
aria-controls
="
navigation
"
aria-pressed
="
false
"
aria-expanded
="
false
"
role
="
button
"
aria-label
="
選單
"
>
<
nav
class
="
nav-content
"
role
="
navigation
"
>
<
label
for
="
menuToggler
"
class
="
toggler__label
"
>
<
span
>
</
span
>
</
label
>
<
span
class
="
nav-items-wrapper
"
>
<
a
href
="
https://www.python.org/
"
class
="
nav-logo
"
>
<
img
src
="
../_static/py.svg
"
alt
="
Python logo
"
>
</
a
>
<
span
class
="
version_switcher_placeholder
"
>
</
span
>
<
form
role
="
search
"
class
="
search
"
action
="
../search.html
"
method
="
get
"
>
<
svg
xmlns
="
http://www.w3.org/2000/svg
"
width
="
20
"
height
="
20
"
viewBox
="
0 0 24 24
"
class
="
search-icon
"
>
<
path
fill-rule
="
nonzero
"
fill
="
currentColor
"
d
="
M15.5 14h-.79l-.28-.27a6.5 6.5 0 001.48-5.34c-.47-2.78-2.79-5-5.59-5.34a6.505 6.505 0 00-7.27 7.27c.34 2.8 2.56 5.12 5.34 5.59a6.5 6.5 0 005.34-1.48l.27.28v.79l4.25 4.25c.41.41 1.08.41 1.49 0 .41-.41.41-1.08 0-1.49L15.5 14zm-6 0C7.01 14 5 11.99 5 9.5S7.01 5 9.5 5 14 7.01 14 9.5 11.99 14 9.5 14z
"
>
</
path
>
</
svg
>
<
input
placeholder
="
快速搜索
"
aria-label
="
快速搜索
"
type
="
search
"
name
="
q
"
>
<
input
type
="
submit
"
value
="
前往
"
>
</
form
>
</
span
>
</
nav
>
<
div
class
="
menu-wrapper
"
>
<
nav
class
="
menu
"
role
="
navigation
"
aria-label
="
main navigation
"
>
<
div
class
="
language_switcher_placeholder
"
>
</
div
>
<
label
class
="
theme-selector-label
"
>
主題
<
select
class
="
theme-selector
"
oninput
="
activateTheme(this.value)
"
>
<
option
value
="
auto
"
selected
>
自動
</
option
>
<
option
value
="
light
"
>
淺色模式
</
option
>
<
option
value
="
dark
"
>
深色模式
</
option
>
</
select
>
</
label
>
<
div
>
<
h3
>
<
a
href
="
../contents.html
"
>
目錄
</
a
>
</
h3
>
<
ul
>
<
li
>
<
a
class
="
reference internal
"
href
="
#
"
>
編解碼器註冊表和支援函式
</
a
>
<
ul
>
<
li
>
<
a
class
="
reference internal
"
href
="
#codec-lookup-api
"
>
編解碼器查找 API
</
a
>
</
li
>
<
li
>
<
a
class
="
reference internal
"
href
="
#registry-api-for-unicode-encoding-error-handlers
"
>
用於 Unicode 編碼錯誤處理程式的註冊 API
</
a
>
</
li
>
<
li
>
<
a
class
="
reference internal
"
href
="
#codec-utility-variables
"
>
Codec utility variables
</
a
>
</
li
>
</
ul
>
</
li
>
</
ul
>
</
div
>
<
div
>
<
h4
>
上個主題
</
h4
>
<
p
class
="
topless
"
>
<
a
href
="
reflection.html
"
title
="
上一章
"
>
Reflection
</
a
>
</
p
>
</
div
>
<
div
>
<
h4
>
下個主題
</
h4
>
<
p
class
="
topless
"
>
<
a
href
="
time.html
"
title
="
下一章
"
>
PyTime C API
</
a
>
</
p
>
</
div
>
<
script
>
document
.
addEventListener
(
'DOMContentLoaded'
,
(
)
=>
{
const
title
=
document
.
querySelector
(
'meta[property="og:title"]'
)
.
content
;
const
elements
=
document
.
querySelectorAll
(
'.improvepage'
)
;
const
pageurl
=
window
.
location
.
href
.
split
(
'?'
)
[
0
]
;
elements
.
forEach
(
element
=>
{
const
url
=
new
URL
(
element
.
href
.
split
(
'?'
)
[
0
]
.
replace
(
"-nojs"
,
""
)
)
;
url
.
searchParams
.
set
(
'pagetitle'
,
title
)
;
url
.
searchParams
.
set
(
'pageurl'
,
pageurl
)
;
url
.
searchParams
.
set
(
'pagesource'
,
"c-api/codec.rst"
)
;
element
.
href
=
url
.
toString
(
)
;
}
)
;
}
)
;
</
script
>
<
div
role
="
note
"
aria-label
="
source link
"
>
<
h3
>
此頁面
</
h3
>
<
ul
class
="
this-page-menu
"
>
<
li
>
<
a
href
="
../bugs.html
"
>
回報錯誤
</
a
>
</
li
>
<
li
>
<
a
class
="
improvepage
"
href
="
../improve-page-nojs.html
"
>
改進此頁面
</
a
>
</
li
>
<
li
>
<
a
href
="
https://github.com/python/cpython/blob/3.15/Doc/c-api/codec.rst?plain=1
"
rel
="
nofollow
"
>
顯示原始碼
</
a
>
</
li
>
<
li
>
<
a
href
="
https://github.com/python/python-docs-zh-tw/blob/3.15/c-api/codec.po?plain=1
"
rel
="
nofollow
"
>
顯示翻譯原始碼
</
a
>
</
li
>
</
ul
>
</
div
>
</
nav
>
</
div
>
</
div
>
<
div
class
="
related
"
role
="
navigation
"
aria-label
="
Related
"
>
<
h3
>
導航
</
h3
>
<
ul
>
<
li
class
="
right
"
style
="
margin-right: 10px
"
>
<
a
href
="
../genindex.html
"
title
="
總索引
"
accesskey
="
I
"
>
索引
</
a
>
</
li
>
<
li
class
="
right
"
>
<
a
href
="
../py-modindex.html
"
title
="
Python 模組索引
"
>
模組
</
a
>
|
</
li
>
<
li
class
="
right
"
>
<
a
href
="
time.html
"
title
="
PyTime C API
"
accesskey
="
N
"
>
下一頁
</
a
>
|
</
li
>
<
li
class
="
right
"
>
<
a
href
="
reflection.html
"
title
="
Reflection
"
accesskey
="
P
"
>
上一頁
</
a
>
|
</
li
>
<
li
class
="
root-icon
"
>
<
img
src
="
../_static/py.svg
"
alt
="
Python logo
"
style
="
vertical-align: middle; margin-top: -1px
"
>
</
li
>
<
li
>
<
a
href
="
https://www.python.org/
"
>
Python
</
a
>
»
</
li
>
<
li
class
="
switchers
"
>
<
div
class
="
language_switcher_placeholder
"
>
</
div
>
<
div
class
="
version_switcher_placeholder
"
>
</
div
>
</
li
>
<
li
>
</
li
>
<
li
id
="
cpython-language-and-version
"
>
<
a
href
="
../index.html
"
>
3.15.0 Documentation
</
a
>
»
</
li
>
<
li
class
="
nav-item nav-item-1
"
>
<
a
href
="
index.html
"
>
Python/C API 參考手冊
</
a
>
»
</
li
>
<
li
class
="
nav-item nav-item-2
"
>
<
a
href
="
utilities.html
"
accesskey
="
U
"
>
工具
</
a
>
»
</
li
>
<
li
class
="
nav-item nav-item-this
"
>
<
a
href
=""
>
編解碼器註冊表和支援函式
</
a
>
</
li
>
<
li
class
="
right
"
>
<
div
class
="
inline-search
"
role
="
search
"
>
<
form
class
="
inline-search
"
action
="
../search.html
"
method
="
get
"
>
<
input
placeholder
="
快速搜索
"
aria-label
="
快速搜索
"
type
="
search
"
name
="
q
"
id
="
search-box
"
>
<
input
type
="
submit
"
value
="
前往
"
>
</
form
>
</
div
>
|
</
li
>
<
li
class
="
right
"
>
<
label
class
="
theme-selector-label
"
>
主題
<
select
class
="
theme-selector
"
oninput
="
activateTheme(this.value)
"
>
<
option
value
="
auto
"
selected
>
自動
</
option
>
<
option
value
="
light
"
>
淺色模式
</
option
>
<
option
value
="
dark
"
>
深色模式
</
option
>
</
select
>
</
label
>
|
</
li
>
</
ul
>
</
div
>
<
div
class
="
document
"
>
<
div
class
="
documentwrapper
"
>
<
div
class
="
bodywrapper
"
>
<
div
class
="
body
"
role
="
main
"
>
<
section
id
="
codec-registry-and-support-functions
"
>
<
span
id
="
codec-registry
"
>
</
span
>
<
h1
>
編解碼器註冊表和支援函式
<
a
class
="
headerlink
"
href
="
#codec-registry-and-support-functions
"
title
="
連結到這個標頭
"
>
¶
</
a
>
</
h1
>
<
dl
class
="
c function
"
>
<
dt
class
="
sig sig-object c
"
id
="
c.PyCodec_Register
"
>
<
span
class
="
kt
"
>
<
span
class
="
pre
"
>
int
</
span
>
</
span
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
sig-name descname
"
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
PyCodec_Register
</
span
>
</
span
>
</
span
>
<
span
class
="
sig-paren
"
>
(
</
span
>
<
a
class
="
reference internal
"
href
="
structures.html#c.PyObject
"
title
="
PyObject
"
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
PyObject
</
span
>
</
span
>
</
a
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
p
"
>
<
span
class
="
pre
"
>
*
</
span
>
</
span
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
search_function
</
span
>
</
span
>
<
span
class
="
sig-paren
"
>
)
</
span
>
<
a
class
="
headerlink
"
href
="
#c.PyCodec_Register
"
title
="
連結到這個定義
"
>
¶
</
a
>
<
br
/>
</
dt
>
<
dd
>
<
em
class
="
stableabi
"
>
為
<
a
class
="
reference internal
"
href
="
stable.html#stable
"
>
<
span
class
="
std std-ref
"
>
穩定 ABI 的一部分
</
span
>
</
a
>
.
</
em
>
<
p
>
註冊一個新的編解碼器搜尋函式。
</
p
>
<
p
>
作為副作用 (side effect)，這會嘗試載入
<
code
class
="
xref py py-mod docutils literal notranslate
"
>
<
span
class
="
pre
"
>
encodings
</
span
>
</
code
>
（如果尚未完成），以確保它始終位於搜尋函式列表中的第一個。
</
p
>
</
dd
>
</
dl
>
<
dl
class
="
c function
"
>
<
dt
class
="
sig sig-object c
"
id
="
c.PyCodec_Unregister
"
>
<
span
class
="
kt
"
>
<
span
class
="
pre
"
>
int
</
span
>
</
span
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
sig-name descname
"
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
PyCodec_Unregister
</
span
>
</
span
>
</
span
>
<
span
class
="
sig-paren
"
>
(
</
span
>
<
a
class
="
reference internal
"
href
="
structures.html#c.PyObject
"
title
="
PyObject
"
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
PyObject
</
span
>
</
span
>
</
a
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
p
"
>
<
span
class
="
pre
"
>
*
</
span
>
</
span
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
search_function
</
span
>
</
span
>
<
span
class
="
sig-paren
"
>
)
</
span
>
<
a
class
="
headerlink
"
href
="
#c.PyCodec_Unregister
"
title
="
連結到這個定義
"
>
¶
</
a
>
<
br
/>
</
dt
>
<
dd
>
<
em
class
="
stableabi
"
>
為
<
a
class
="
reference internal
"
href
="
stable.html#stable
"
>
<
span
class
="
std std-ref
"
>
穩定 ABI 的一部分
</
span
>
</
a
>
自 3.10 版本開始.
</
em
>
<
p
>
取消註冊編解碼器搜尋函式並清除註冊表 (registry) 的快取。如果搜尋函式並未被註冊，則不執行任何操作。成功回傳 0，發生錯誤時會引發例外並回傳 -1。
</
p
>
<
div
class
="
versionadded
"
>
<
p
>
<
span
class
="
versionmodified added
"
>
在 3.10 版被加入.
</
span
>
</
p
>
</
div
>
</
dd
>
</
dl
>
<
dl
class
="
c function
"
>
<
dt
class
="
sig sig-object c
"
id
="
c.PyCodec_KnownEncoding
"
>
<
span
class
="
kt
"
>
<
span
class
="
pre
"
>
int
</
span
>
</
span
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
sig-name descname
"
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
PyCodec_KnownEncoding
</
span
>
</
span
>
</
span
>
<
span
class
="
sig-paren
"
>
(
</
span
>
<
span
class
="
k
"
>
<
span
class
="
pre
"
>
const
</
span
>
</
span
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
kt
"
>
<
span
class
="
pre
"
>
char
</
span
>
</
span
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
p
"
>
<
span
class
="
pre
"
>
*
</
span
>
</
span
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
encoding
</
span
>
</
span
>
<
span
class
="
sig-paren
"
>
)
</
span
>
<
a
class
="
headerlink
"
href
="
#c.PyCodec_KnownEncoding
"
title
="
連結到這個定義
"
>
¶
</
a
>
<
br
/>
</
dt
>
<
dd
>
<
em
class
="
stableabi
"
>
為
<
a
class
="
reference internal
"
href
="
stable.html#stable
"
>
<
span
class
="
std std-ref
"
>
穩定 ABI 的一部分
</
span
>
</
a
>
.
</
em
>
<
p
>
回傳
<
code
class
="
docutils literal notranslate
"
>
<
span
class
="
pre
"
>
1
</
span
>
</
code
>
或
<
code
class
="
docutils literal notranslate
"
>
<
span
class
="
pre
"
>
0
</
span
>
</
code
>
，具體取決於是否有給定
<
em
>
encoding
</
em
>
的已註冊編解碼器。這個函式總會成功。
</
p
>
</
dd
>
</
dl
>
<
dl
class
="
c function
"
>
<
dt
class
="
sig sig-object c
"
id
="
c.PyCodec_Encode
"
>
<
a
class
="
reference internal
"
href
="
structures.html#c.PyObject
"
title
="
PyObject
"
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
PyObject
</
span
>
</
span
>
</
a
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
p
"
>
<
span
class
="
pre
"
>
*
</
span
>
</
span
>
<
span
class
="
sig-name descname
"
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
PyCodec_Encode
</
span
>
</
span
>
</
span
>
<
span
class
="
sig-paren
"
>
(
</
span
>
<
a
class
="
reference internal
"
href
="
structures.html#c.PyObject
"
title
="
PyObject
"
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
PyObject
</
span
>
</
span
>
</
a
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
p
"
>
<
span
class
="
pre
"
>
*
</
span
>
</
span
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
object
</
span
>
</
span
>
,
<
span
class
="
k
"
>
<
span
class
="
pre
"
>
const
</
span
>
</
span
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
kt
"
>
<
span
class
="
pre
"
>
char
</
span
>
</
span
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
p
"
>
<
span
class
="
pre
"
>
*
</
span
>
</
span
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
encoding
</
span
>
</
span
>
,
<
span
class
="
k
"
>
<
span
class
="
pre
"
>
const
</
span
>
</
span
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
kt
"
>
<
span
class
="
pre
"
>
char
</
span
>
</
span
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
p
"
>
<
span
class
="
pre
"
>
*
</
span
>
</
span
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
errors
</
span
>
</
span
>
<
span
class
="
sig-paren
"
>
)
</
span
>
<
a
class
="
headerlink
"
href
="
#c.PyCodec_Encode
"
title
="
連結到這個定義
"
>
¶
</
a
>
<
br
/>
</
dt
>
<
dd
>
<
em
class
="
refcount return_new_ref
"
>
回傳值：新的參照。
</
em
>
<
em
class
="
stableabi
"
>
為
<
a
class
="
reference internal
"
href
="
stable.html#stable
"
>
<
span
class
="
std std-ref
"
>
穩定 ABI 的一部分
</
span
>
</
a
>
.
</
em
>
<
p
>
基於泛用編解碼器的編碼 API。
</
p
>
<
p
>
<
em
>
object
</
em
>
被傳遞給以給定
<
em
>
encoding
</
em
>
所查找到的編碼器函式，並使用以
<
em
>
errors
</
em
>
定義的錯誤處理方法。
<
em
>
errors
</
em
>
可以設為
<
code
class
="
docutils literal notranslate
"
>
<
span
class
="
pre
"
>
NULL
</
span
>
</
code
>
來使用編解碼器定義的預設方法。如果找不到編碼器，則引發
<
a
class
="
reference internal
"
href
="
../builtins/exceptions.html#LookupError
"
title
="
LookupError
"
>
<
code
class
="
xref py py-exc docutils literal notranslate
"
>
<
span
class
="
pre
"
>
LookupError
</
span
>
</
code
>
</
a
>
。
</
p
>
</
dd
>
</
dl
>
<
dl
class
="
c function
"
>
<
dt
class
="
sig sig-object c
"
id
="
c.PyCodec_Decode
"
>
<
a
class
="
reference internal
"
href
="
structures.html#c.PyObject
"
title
="
PyObject
"
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
PyObject
</
span
>
</
span
>
</
a
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
p
"
>
<
span
class
="
pre
"
>
*
</
span
>
</
span
>
<
span
class
="
sig-name descname
"
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
PyCodec_Decode
</
span
>
</
span
>
</
span
>
<
span
class
="
sig-paren
"
>
(
</
span
>
<
a
class
="
reference internal
"
href
="
structures.html#c.PyObject
"
title
="
PyObject
"
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
PyObject
</
span
>
</
span
>
</
a
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
p
"
>
<
span
class
="
pre
"
>
*
</
span
>
</
span
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
object
</
span
>
</
span
>
,
<
span
class
="
k
"
>
<
span
class
="
pre
"
>
const
</
span
>
</
span
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
kt
"
>
<
span
class
="
pre
"
>
char
</
span
>
</
span
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
p
"
>
<
span
class
="
pre
"
>
*
</
span
>
</
span
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
encoding
</
span
>
</
span
>
,
<
span
class
="
k
"
>
<
span
class
="
pre
"
>
const
</
span
>
</
span
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
kt
"
>
<
span
class
="
pre
"
>
char
</
span
>
</
span
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
p
"
>
<
span
class
="
pre
"
>
*
</
span
>
</
span
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
errors
</
span
>
</
span
>
<
span
class
="
sig-paren
"
>
)
</
span
>
<
a
class
="
headerlink
"
href
="
#c.PyCodec_Decode
"
title
="
連結到這個定義
"
>
¶
</
a
>
<
br
/>
</
dt
>
<
dd
>
<
em
class
="
refcount return_new_ref
"
>
回傳值：新的參照。
</
em
>
<
em
class
="
stableabi
"
>
為
<
a
class
="
reference internal
"
href
="
stable.html#stable
"
>
<
span
class
="
std std-ref
"
>
穩定 ABI 的一部分
</
span
>
</
a
>
.
</
em
>
<
p
>
基於泛用編解碼器的解碼 API。
</
p
>
<
p
>
<
em
>
object
</
em
>
被傳遞給以給定
<
em
>
encoding
</
em
>
所查找到的解碼器函式，並使用以
<
em
>
errors
</
em
>
定義的錯誤處理方法。
<
em
>
errors
</
em
>
可以設為
<
code
class
="
docutils literal notranslate
"
>
<
span
class
="
pre
"
>
NULL
</
span
>
</
code
>
來使用編解碼器定義的預設方法。如果找不到解碼器，則引發
<
a
class
="
reference internal
"
href
="
../builtins/exceptions.html#LookupError
"
title
="
LookupError
"
>
<
code
class
="
xref py py-exc docutils literal notranslate
"
>
<
span
class
="
pre
"
>
LookupError
</
span
>
</
code
>
</
a
>
。
</
p
>
</
dd
>
</
dl
>
<
section
id
="
codec-lookup-api
"
>
<
h2
>
編解碼器查找 API
<
a
class
="
headerlink
"
href
="
#codec-lookup-api
"
title
="
連結到這個標頭
"
>
¶
</
a
>
</
h2
>
<
p
>
在以下函式中，查找的
<
em
>
encoding
</
em
>
字串的所有字元將轉換為小寫，這使得透過此機制查找的編碼可以不區分大小寫而更有效率。如果未找到編解碼器，則會設定
<
a
class
="
reference internal
"
href
="
../builtins/exceptions.html#KeyError
"
title
="
KeyError
"
>
<
code
class
="
xref py py-exc docutils literal notranslate
"
>
<
span
class
="
pre
"
>
KeyError
</
span
>
</
code
>
</
a
>
並回傳
<
code
class
="
docutils literal notranslate
"
>
<
span
class
="
pre
"
>
NULL
</
span
>
</
code
>
。
</
p
>
<
dl
class
="
c function
"
>
<
dt
class
="
sig sig-object c
"
id
="
c.PyCodec_Encoder
"
>
<
a
class
="
reference internal
"
href
="
structures.html#c.PyObject
"
title
="
PyObject
"
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
PyObject
</
span
>
</
span
>
</
a
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
p
"
>
<
span
class
="
pre
"
>
*
</
span
>
</
span
>
<
span
class
="
sig-name descname
"
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
PyCodec_Encoder
</
span
>
</
span
>
</
span
>
<
span
class
="
sig-paren
"
>
(
</
span
>
<
span
class
="
k
"
>
<
span
class
="
pre
"
>
const
</
span
>
</
span
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
kt
"
>
<
span
class
="
pre
"
>
char
</
span
>
</
span
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
p
"
>
<
span
class
="
pre
"
>
*
</
span
>
</
span
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
encoding
</
span
>
</
span
>
<
span
class
="
sig-paren
"
>
)
</
span
>
<
a
class
="
headerlink
"
href
="
#c.PyCodec_Encoder
"
title
="
連結到這個定義
"
>
¶
</
a
>
<
br
/>
</
dt
>
<
dd
>
<
em
class
="
refcount return_new_ref
"
>
回傳值：新的參照。
</
em
>
<
em
class
="
stableabi
"
>
為
<
a
class
="
reference internal
"
href
="
stable.html#stable
"
>
<
span
class
="
std std-ref
"
>
穩定 ABI 的一部分
</
span
>
</
a
>
.
</
em
>
<
p
>
取得給定
<
em
>
encoding
</
em
>
的編碼器函式。
</
p
>
</
dd
>
</
dl
>
<
dl
class
="
c function
"
>
<
dt
class
="
sig sig-object c
"
id
="
c.PyCodec_Decoder
"
>
<
a
class
="
reference internal
"
href
="
structures.html#c.PyObject
"
title
="
PyObject
"
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
PyObject
</
span
>
</
span
>
</
a
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
p
"
>
<
span
class
="
pre
"
>
*
</
span
>
</
span
>
<
span
class
="
sig-name descname
"
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
PyCodec_Decoder
</
span
>
</
span
>
</
span
>
<
span
class
="
sig-paren
"
>
(
</
span
>
<
span
class
="
k
"
>
<
span
class
="
pre
"
>
const
</
span
>
</
span
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
kt
"
>
<
span
class
="
pre
"
>
char
</
span
>
</
span
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
p
"
>
<
span
class
="
pre
"
>
*
</
span
>
</
span
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
encoding
</
span
>
</
span
>
<
span
class
="
sig-paren
"
>
)
</
span
>
<
a
class
="
headerlink
"
href
="
#c.PyCodec_Decoder
"
title
="
連結到這個定義
"
>
¶
</
a
>
<
br
/>
</
dt
>
<
dd
>
<
em
class
="
refcount return_new_ref
"
>
回傳值：新的參照。
</
em
>
<
em
class
="
stableabi
"
>
為
<
a
class
="
reference internal
"
href
="
stable.html#stable
"
>
<
span
class
="
std std-ref
"
>
穩定 ABI 的一部分
</
span
>
</
a
>
.
</
em
>
<
p
>
取得給定
<
em
>
encoding
</
em
>
的解碼器函式。
</
p
>
</
dd
>
</
dl
>
<
dl
class
="
c function
"
>
<
dt
class
="
sig sig-object c
"
id
="
c.PyCodec_IncrementalEncoder
"
>
<
a
class
="
reference internal
"
href
="
structures.html#c.PyObject
"
title
="
PyObject
"
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
PyObject
</
span
>
</
span
>
</
a
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
p
"
>
<
span
class
="
pre
"
>
*
</
span
>
</
span
>
<
span
class
="
sig-name descname
"
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
PyCodec_IncrementalEncoder
</
span
>
</
span
>
</
span
>
<
span
class
="
sig-paren
"
>
(
</
span
>
<
span
class
="
k
"
>
<
span
class
="
pre
"
>
const
</
span
>
</
span
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
kt
"
>
<
span
class
="
pre
"
>
char
</
span
>
</
span
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
p
"
>
<
span
class
="
pre
"
>
*
</
span
>
</
span
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
encoding
</
span
>
</
span
>
,
<
span
class
="
k
"
>
<
span
class
="
pre
"
>
const
</
span
>
</
span
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
kt
"
>
<
span
class
="
pre
"
>
char
</
span
>
</
span
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
p
"
>
<
span
class
="
pre
"
>
*
</
span
>
</
span
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
errors
</
span
>
</
span
>
<
span
class
="
sig-paren
"
>
)
</
span
>
<
a
class
="
headerlink
"
href
="
#c.PyCodec_IncrementalEncoder
"
title
="
連結到這個定義
"
>
¶
</
a
>
<
br
/>
</
dt
>
<
dd
>
<
em
class
="
refcount return_new_ref
"
>
回傳值：新的參照。
</
em
>
<
em
class
="
stableabi
"
>
為
<
a
class
="
reference internal
"
href
="
stable.html#stable
"
>
<
span
class
="
std std-ref
"
>
穩定 ABI 的一部分
</
span
>
</
a
>
.
</
em
>
<
p
>
取得給定
<
em
>
encoding
</
em
>
的
<
a
class
="
reference internal
"
href
="
../library/codecs.html#codecs.IncrementalEncoder
"
title
="
codecs.IncrementalEncoder
"
>
<
code
class
="
xref py py-class docutils literal notranslate
"
>
<
span
class
="
pre
"
>
IncrementalEncoder
</
span
>
</
code
>
</
a
>
物件。
</
p
>
</
dd
>
</
dl
>
<
dl
class
="
c function
"
>
<
dt
class
="
sig sig-object c
"
id
="
c.PyCodec_IncrementalDecoder
"
>
<
a
class
="
reference internal
"
href
="
structures.html#c.PyObject
"
title
="
PyObject
"
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
PyObject
</
span
>
</
span
>
</
a
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
p
"
>
<
span
class
="
pre
"
>
*
</
span
>
</
span
>
<
span
class
="
sig-name descname
"
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
PyCodec_IncrementalDecoder
</
span
>
</
span
>
</
span
>
<
span
class
="
sig-paren
"
>
(
</
span
>
<
span
class
="
k
"
>
<
span
class
="
pre
"
>
const
</
span
>
</
span
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
kt
"
>
<
span
class
="
pre
"
>
char
</
span
>
</
span
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
p
"
>
<
span
class
="
pre
"
>
*
</
span
>
</
span
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
encoding
</
span
>
</
span
>
,
<
span
class
="
k
"
>
<
span
class
="
pre
"
>
const
</
span
>
</
span
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
kt
"
>
<
span
class
="
pre
"
>
char
</
span
>
</
span
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
p
"
>
<
span
class
="
pre
"
>
*
</
span
>
</
span
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
errors
</
span
>
</
span
>
<
span
class
="
sig-paren
"
>
)
</
span
>
<
a
class
="
headerlink
"
href
="
#c.PyCodec_IncrementalDecoder
"
title
="
連結到這個定義
"
>
¶
</
a
>
<
br
/>
</
dt
>
<
dd
>
<
em
class
="
refcount return_new_ref
"
>
回傳值：新的參照。
</
em
>
<
em
class
="
stableabi
"
>
為
<
a
class
="
reference internal
"
href
="
stable.html#stable
"
>
<
span
class
="
std std-ref
"
>
穩定 ABI 的一部分
</
span
>
</
a
>
.
</
em
>
<
p
>
取得給定
<
em
>
encoding
</
em
>
的
<
a
class
="
reference internal
"
href
="
../library/codecs.html#codecs.IncrementalDecoder
"
title
="
codecs.IncrementalDecoder
"
>
<
code
class
="
xref py py-class docutils literal notranslate
"
>
<
span
class
="
pre
"
>
IncrementalDecoder
</
span
>
</
code
>
</
a
>
物件。
</
p
>
</
dd
>
</
dl
>
<
dl
class
="
c function
"
>
<
dt
class
="
sig sig-object c
"
id
="
c.PyCodec_StreamReader
"
>
<
a
class
="
reference internal
"
href
="
structures.html#c.PyObject
"
title
="
PyObject
"
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
PyObject
</
span
>
</
span
>
</
a
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
p
"
>
<
span
class
="
pre
"
>
*
</
span
>
</
span
>
<
span
class
="
sig-name descname
"
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
PyCodec_StreamReader
</
span
>
</
span
>
</
span
>
<
span
class
="
sig-paren
"
>
(
</
span
>
<
span
class
="
k
"
>
<
span
class
="
pre
"
>
const
</
span
>
</
span
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
kt
"
>
<
span
class
="
pre
"
>
char
</
span
>
</
span
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
p
"
>
<
span
class
="
pre
"
>
*
</
span
>
</
span
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
encoding
</
span
>
</
span
>
,
<
a
class
="
reference internal
"
href
="
structures.html#c.PyObject
"
title
="
PyObject
"
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
PyObject
</
span
>
</
span
>
</
a
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
p
"
>
<
span
class
="
pre
"
>
*
</
span
>
</
span
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
stream
</
span
>
</
span
>
,
<
span
class
="
k
"
>
<
span
class
="
pre
"
>
const
</
span
>
</
span
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
kt
"
>
<
span
class
="
pre
"
>
char
</
span
>
</
span
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
p
"
>
<
span
class
="
pre
"
>
*
</
span
>
</
span
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
errors
</
span
>
</
span
>
<
span
class
="
sig-paren
"
>
)
</
span
>
<
a
class
="
headerlink
"
href
="
#c.PyCodec_StreamReader
"
title
="
連結到這個定義
"
>
¶
</
a
>
<
br
/>
</
dt
>
<
dd
>
<
em
class
="
refcount return_new_ref
"
>
回傳值：新的參照。
</
em
>
<
em
class
="
stableabi
"
>
為
<
a
class
="
reference internal
"
href
="
stable.html#stable
"
>
<
span
class
="
std std-ref
"
>
穩定 ABI 的一部分
</
span
>
</
a
>
.
</
em
>
<
p
>
取得給定
<
em
>
encoding
</
em
>
的
<
a
class
="
reference internal
"
href
="
../library/codecs.html#codecs.StreamReader
"
title
="
codecs.StreamReader
"
>
<
code
class
="
xref py py-class docutils literal notranslate
"
>
<
span
class
="
pre
"
>
StreamReader
</
span
>
</
code
>
</
a
>
工廠函式。
</
p
>
</
dd
>
</
dl
>
<
dl
class
="
c function
"
>
<
dt
class
="
sig sig-object c
"
id
="
c.PyCodec_StreamWriter
"
>
<
a
class
="
reference internal
"
href
="
structures.html#c.PyObject
"
title
="
PyObject
"
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
PyObject
</
span
>
</
span
>
</
a
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
p
"
>
<
span
class
="
pre
"
>
*
</
span
>
</
span
>
<
span
class
="
sig-name descname
"
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
PyCodec_StreamWriter
</
span
>
</
span
>
</
span
>
<
span
class
="
sig-paren
"
>
(
</
span
>
<
span
class
="
k
"
>
<
span
class
="
pre
"
>
const
</
span
>
</
span
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
kt
"
>
<
span
class
="
pre
"
>
char
</
span
>
</
span
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
p
"
>
<
span
class
="
pre
"
>
*
</
span
>
</
span
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
encoding
</
span
>
</
span
>
,
<
a
class
="
reference internal
"
href
="
structures.html#c.PyObject
"
title
="
PyObject
"
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
PyObject
</
span
>
</
span
>
</
a
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
p
"
>
<
span
class
="
pre
"
>
*
</
span
>
</
span
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
stream
</
span
>
</
span
>
,
<
span
class
="
k
"
>
<
span
class
="
pre
"
>
const
</
span
>
</
span
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
kt
"
>
<
span
class
="
pre
"
>
char
</
span
>
</
span
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
p
"
>
<
span
class
="
pre
"
>
*
</
span
>
</
span
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
errors
</
span
>
</
span
>
<
span
class
="
sig-paren
"
>
)
</
span
>
<
a
class
="
headerlink
"
href
="
#c.PyCodec_StreamWriter
"
title
="
連結到這個定義
"
>
¶
</
a
>
<
br
/>
</
dt
>
<
dd
>
<
em
class
="
refcount return_new_ref
"
>
回傳值：新的參照。
</
em
>
<
em
class
="
stableabi
"
>
為
<
a
class
="
reference internal
"
href
="
stable.html#stable
"
>
<
span
class
="
std std-ref
"
>
穩定 ABI 的一部分
</
span
>
</
a
>
.
</
em
>
<
p
>
取得給定
<
em
>
encoding
</
em
>
的
<
a
class
="
reference internal
"
href
="
../library/codecs.html#codecs.StreamWriter
"
title
="
codecs.StreamWriter
"
>
<
code
class
="
xref py py-class docutils literal notranslate
"
>
<
span
class
="
pre
"
>
StreamWriter
</
span
>
</
code
>
</
a
>
工廠函式。
</
p
>
</
dd
>
</
dl
>
</
section
>
<
section
id
="
registry-api-for-unicode-encoding-error-handlers
"
>
<
h2
>
用於 Unicode 編碼錯誤處理程式的註冊 API
<
a
class
="
headerlink
"
href
="
#registry-api-for-unicode-encoding-error-handlers
"
title
="
連結到這個標頭
"
>
¶
</
a
>
</
h2
>
<
dl
class
="
c function
"
>
<
dt
class
="
sig sig-object c
"
id
="
c.PyCodec_RegisterError
"
>
<
span
class
="
kt
"
>
<
span
class
="
pre
"
>
int
</
span
>
</
span
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
sig-name descname
"
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
PyCodec_RegisterError
</
span
>
</
span
>
</
span
>
<
span
class
="
sig-paren
"
>
(
</
span
>
<
span
class
="
k
"
>
<
span
class
="
pre
"
>
const
</
span
>
</
span
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
kt
"
>
<
span
class
="
pre
"
>
char
</
span
>
</
span
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
p
"
>
<
span
class
="
pre
"
>
*
</
span
>
</
span
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
name
</
span
>
</
span
>
,
<
a
class
="
reference internal
"
href
="
structures.html#c.PyObject
"
title
="
PyObject
"
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
PyObject
</
span
>
</
span
>
</
a
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
p
"
>
<
span
class
="
pre
"
>
*
</
span
>
</
span
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
error
</
span
>
</
span
>
<
span
class
="
sig-paren
"
>
)
</
span
>
<
a
class
="
headerlink
"
href
="
#c.PyCodec_RegisterError
"
title
="
連結到這個定義
"
>
¶
</
a
>
<
br
/>
</
dt
>
<
dd
>
<
em
class
="
stableabi
"
>
為
<
a
class
="
reference internal
"
href
="
stable.html#stable
"
>
<
span
class
="
std std-ref
"
>
穩定 ABI 的一部分
</
span
>
</
a
>
.
</
em
>
<
p
>
在給定的
<
em
>
name
</
em
>
下註冊錯誤處理回呼 (callback) 函式
<
em
>
error
</
em
>
。當編解碼器遇到無法編碼的字元/無法解碼的位元組並且
<
em
>
name
</
em
>
被指定為呼叫編碼/解碼函式時的錯誤參數時，將呼叫此回呼函式。
</
p
>
<
p
>
回呼取得單個引數，即
<
a
class
="
reference internal
"
href
="
../builtins/exceptions.html#UnicodeEncodeError
"
title
="
UnicodeEncodeError
"
>
<
code
class
="
xref py py-exc docutils literal notranslate
"
>
<
span
class
="
pre
"
>
UnicodeEncodeError
</
span
>
</
code
>
</
a
>
、
<
a
class
="
reference internal
"
href
="
../builtins/exceptions.html#UnicodeDecodeError
"
title
="
UnicodeDecodeError
"
>
<
code
class
="
xref py py-exc docutils literal notranslate
"
>
<
span
class
="
pre
"
>
UnicodeDecodeError
</
span
>
</
code
>
</
a
>
或
<
a
class
="
reference internal
"
href
="
../builtins/exceptions.html#UnicodeTranslateError
"
title
="
UnicodeTranslateError
"
>
<
code
class
="
xref py py-exc docutils literal notranslate
"
>
<
span
class
="
pre
"
>
UnicodeTranslateError
</
span
>
</
code
>
</
a
>
的實例，其中包含關於有問題的字元或位元組序列及其在原始字串中偏移量的資訊（有關取得此資訊的函式，請參閱
<
a
class
="
reference internal
"
href
="
exceptions.html#unicodeexceptions
"
>
<
span
class
="
std std-ref
"
>
Unicode 例外物件
</
span
>
</
a
>
）。回呼必須引發給定的例外，或者回傳一個包含有問題序列的替換的二元組 (two-item tuple)，以及一個代表原始字串中應該被恢復的編碼/解碼偏移量的整數。
</
p
>
<
p
>
成功時回傳
<
code
class
="
docutils literal notranslate
"
>
<
span
class
="
pre
"
>
0
</
span
>
</
code
>
，錯誤時回傳
<
code
class
="
docutils literal notranslate
"
>
<
span
class
="
pre
"
>
-1
</
span
>
</
code
>
。
</
p
>
</
dd
>
</
dl
>
<
dl
class
="
c function
"
>
<
dt
class
="
sig sig-object c
"
id
="
c.PyCodec_LookupError
"
>
<
a
class
="
reference internal
"
href
="
structures.html#c.PyObject
"
title
="
PyObject
"
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
PyObject
</
span
>
</
span
>
</
a
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
p
"
>
<
span
class
="
pre
"
>
*
</
span
>
</
span
>
<
span
class
="
sig-name descname
"
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
PyCodec_LookupError
</
span
>
</
span
>
</
span
>
<
span
class
="
sig-paren
"
>
(
</
span
>
<
span
class
="
k
"
>
<
span
class
="
pre
"
>
const
</
span
>
</
span
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
kt
"
>
<
span
class
="
pre
"
>
char
</
span
>
</
span
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
p
"
>
<
span
class
="
pre
"
>
*
</
span
>
</
span
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
name
</
span
>
</
span
>
<
span
class
="
sig-paren
"
>
)
</
span
>
<
a
class
="
headerlink
"
href
="
#c.PyCodec_LookupError
"
title
="
連結到這個定義
"
>
¶
</
a
>
<
br
/>
</
dt
>
<
dd
>
<
em
class
="
refcount return_new_ref
"
>
回傳值：新的參照。
</
em
>
<
em
class
="
stableabi
"
>
為
<
a
class
="
reference internal
"
href
="
stable.html#stable
"
>
<
span
class
="
std std-ref
"
>
穩定 ABI 的一部分
</
span
>
</
a
>
.
</
em
>
<
p
>
查找
<
em
>
name
</
em
>
下已註冊的錯誤處理回呼函式。作為一種特殊情況，可以傳遞
<
code
class
="
docutils literal notranslate
"
>
<
span
class
="
pre
"
>
NULL
</
span
>
</
code
>
，在這種情況下，將回傳 "strict" 的錯誤處理回呼。
</
p
>
</
dd
>
</
dl
>
<
dl
class
="
c function
"
>
<
dt
class
="
sig sig-object c
"
id
="
c.PyCodec_StrictErrors
"
>
<
a
class
="
reference internal
"
href
="
structures.html#c.PyObject
"
title
="
PyObject
"
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
PyObject
</
span
>
</
span
>
</
a
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
p
"
>
<
span
class
="
pre
"
>
*
</
span
>
</
span
>
<
span
class
="
sig-name descname
"
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
PyCodec_StrictErrors
</
span
>
</
span
>
</
span
>
<
span
class
="
sig-paren
"
>
(
</
span
>
<
a
class
="
reference internal
"
href
="
structures.html#c.PyObject
"
title
="
PyObject
"
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
PyObject
</
span
>
</
span
>
</
a
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
p
"
>
<
span
class
="
pre
"
>
*
</
span
>
</
span
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
exc
</
span
>
</
span
>
<
span
class
="
sig-paren
"
>
)
</
span
>
<
a
class
="
headerlink
"
href
="
#c.PyCodec_StrictErrors
"
title
="
連結到這個定義
"
>
¶
</
a
>
<
br
/>
</
dt
>
<
dd
>
<
em
class
="
refcount return_null
"
>
回傳值：總是為 NULL。
</
em
>
<
em
class
="
stableabi
"
>
為
<
a
class
="
reference internal
"
href
="
stable.html#stable
"
>
<
span
class
="
std std-ref
"
>
穩定 ABI 的一部分
</
span
>
</
a
>
.
</
em
>
<
p
>
引發
<
em
>
exc
</
em
>
作為例外。
</
p
>
</
dd
>
</
dl
>
<
dl
class
="
c function
"
>
<
dt
class
="
sig sig-object c
"
id
="
c.PyCodec_IgnoreErrors
"
>
<
a
class
="
reference internal
"
href
="
structures.html#c.PyObject
"
title
="
PyObject
"
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
PyObject
</
span
>
</
span
>
</
a
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
p
"
>
<
span
class
="
pre
"
>
*
</
span
>
</
span
>
<
span
class
="
sig-name descname
"
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
PyCodec_IgnoreErrors
</
span
>
</
span
>
</
span
>
<
span
class
="
sig-paren
"
>
(
</
span
>
<
a
class
="
reference internal
"
href
="
structures.html#c.PyObject
"
title
="
PyObject
"
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
PyObject
</
span
>
</
span
>
</
a
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
p
"
>
<
span
class
="
pre
"
>
*
</
span
>
</
span
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
exc
</
span
>
</
span
>
<
span
class
="
sig-paren
"
>
)
</
span
>
<
a
class
="
headerlink
"
href
="
#c.PyCodec_IgnoreErrors
"
title
="
連結到這個定義
"
>
¶
</
a
>
<
br
/>
</
dt
>
<
dd
>
<
em
class
="
refcount return_new_ref
"
>
回傳值：新的參照。
</
em
>
<
em
class
="
stableabi
"
>
為
<
a
class
="
reference internal
"
href
="
stable.html#stable
"
>
<
span
class
="
std std-ref
"
>
穩定 ABI 的一部分
</
span
>
</
a
>
.
</
em
>
<
p
>
忽略 unicode 錯誤，跳過錯誤的輸入。
</
p
>
</
dd
>
</
dl
>
<
dl
class
="
c function
"
>
<
dt
class
="
sig sig-object c
"
id
="
c.PyCodec_ReplaceErrors
"
>
<
a
class
="
reference internal
"
href
="
structures.html#c.PyObject
"
title
="
PyObject
"
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
PyObject
</
span
>
</
span
>
</
a
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
p
"
>
<
span
class
="
pre
"
>
*
</
span
>
</
span
>
<
span
class
="
sig-name descname
"
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
PyCodec_ReplaceErrors
</
span
>
</
span
>
</
span
>
<
span
class
="
sig-paren
"
>
(
</
span
>
<
a
class
="
reference internal
"
href
="
structures.html#c.PyObject
"
title
="
PyObject
"
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
PyObject
</
span
>
</
span
>
</
a
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
p
"
>
<
span
class
="
pre
"
>
*
</
span
>
</
span
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
exc
</
span
>
</
span
>
<
span
class
="
sig-paren
"
>
)
</
span
>
<
a
class
="
headerlink
"
href
="
#c.PyCodec_ReplaceErrors
"
title
="
連結到這個定義
"
>
¶
</
a
>
<
br
/>
</
dt
>
<
dd
>
<
em
class
="
refcount return_new_ref
"
>
回傳值：新的參照。
</
em
>
<
em
class
="
stableabi
"
>
為
<
a
class
="
reference internal
"
href
="
stable.html#stable
"
>
<
span
class
="
std std-ref
"
>
穩定 ABI 的一部分
</
span
>
</
a
>
.
</
em
>
<
p
>
將 unicode 編碼錯誤替換為
<
code
class
="
docutils literal notranslate
"
>
<
span
class
="
pre
"
>
?
</
span
>
</
code
>
或
<
code
class
="
docutils literal notranslate
"
>
<
span
class
="
pre
"
>
U+FFFD
</
span
>
</
code
>
。
</
p
>
</
dd
>
</
dl
>
<
dl
class
="
c function
"
>
<
dt
class
="
sig sig-object c
"
id
="
c.PyCodec_XMLCharRefReplaceErrors
"
>
<
a
class
="
reference internal
"
href
="
structures.html#c.PyObject
"
title
="
PyObject
"
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
PyObject
</
span
>
</
span
>
</
a
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
p
"
>
<
span
class
="
pre
"
>
*
</
span
>
</
span
>
<
span
class
="
sig-name descname
"
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
PyCodec_XMLCharRefReplaceErrors
</
span
>
</
span
>
</
span
>
<
span
class
="
sig-paren
"
>
(
</
span
>
<
a
class
="
reference internal
"
href
="
structures.html#c.PyObject
"
title
="
PyObject
"
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
PyObject
</
span
>
</
span
>
</
a
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
p
"
>
<
span
class
="
pre
"
>
*
</
span
>
</
span
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
exc
</
span
>
</
span
>
<
span
class
="
sig-paren
"
>
)
</
span
>
<
a
class
="
headerlink
"
href
="
#c.PyCodec_XMLCharRefReplaceErrors
"
title
="
連結到這個定義
"
>
¶
</
a
>
<
br
/>
</
dt
>
<
dd
>
<
em
class
="
refcount return_new_ref
"
>
回傳值：新的參照。
</
em
>
<
em
class
="
stableabi
"
>
為
<
a
class
="
reference internal
"
href
="
stable.html#stable
"
>
<
span
class
="
std std-ref
"
>
穩定 ABI 的一部分
</
span
>
</
a
>
.
</
em
>
<
p
>
將 unicode 編碼錯誤替換為 XML 字元參照。
</
p
>
</
dd
>
</
dl
>
<
dl
class
="
c function
"
>
<
dt
class
="
sig sig-object c
"
id
="
c.PyCodec_BackslashReplaceErrors
"
>
<
a
class
="
reference internal
"
href
="
structures.html#c.PyObject
"
title
="
PyObject
"
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
PyObject
</
span
>
</
span
>
</
a
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
p
"
>
<
span
class
="
pre
"
>
*
</
span
>
</
span
>
<
span
class
="
sig-name descname
"
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
PyCodec_BackslashReplaceErrors
</
span
>
</
span
>
</
span
>
<
span
class
="
sig-paren
"
>
(
</
span
>
<
a
class
="
reference internal
"
href
="
structures.html#c.PyObject
"
title
="
PyObject
"
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
PyObject
</
span
>
</
span
>
</
a
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
p
"
>
<
span
class
="
pre
"
>
*
</
span
>
</
span
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
exc
</
span
>
</
span
>
<
span
class
="
sig-paren
"
>
)
</
span
>
<
a
class
="
headerlink
"
href
="
#c.PyCodec_BackslashReplaceErrors
"
title
="
連結到這個定義
"
>
¶
</
a
>
<
br
/>
</
dt
>
<
dd
>
<
em
class
="
refcount return_new_ref
"
>
回傳值：新的參照。
</
em
>
<
em
class
="
stableabi
"
>
為
<
a
class
="
reference internal
"
href
="
stable.html#stable
"
>
<
span
class
="
std std-ref
"
>
穩定 ABI 的一部分
</
span
>
</
a
>
.
</
em
>
<
p
>
將 unicode 編碼錯誤替換為反斜線跳脫（
<
code
class
="
docutils literal notranslate
"
>
<
span
class
="
pre
"
>
\x
</
span
>
</
code
>
、
<
code
class
="
docutils literal notranslate
"
>
<
span
class
="
pre
"
>
\u
</
span
>
</
code
>
和
<
code
class
="
docutils literal notranslate
"
>
<
span
class
="
pre
"
>
\U
</
span
>
</
code
>
）。
</
p
>
</
dd
>
</
dl
>
<
dl
class
="
c function
"
>
<
dt
class
="
sig sig-object c
"
id
="
c.PyCodec_NameReplaceErrors
"
>
<
a
class
="
reference internal
"
href
="
structures.html#c.PyObject
"
title
="
PyObject
"
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
PyObject
</
span
>
</
span
>
</
a
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
p
"
>
<
span
class
="
pre
"
>
*
</
span
>
</
span
>
<
span
class
="
sig-name descname
"
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
PyCodec_NameReplaceErrors
</
span
>
</
span
>
</
span
>
<
span
class
="
sig-paren
"
>
(
</
span
>
<
a
class
="
reference internal
"
href
="
structures.html#c.PyObject
"
title
="
PyObject
"
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
PyObject
</
span
>
</
span
>
</
a
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
p
"
>
<
span
class
="
pre
"
>
*
</
span
>
</
span
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
exc
</
span
>
</
span
>
<
span
class
="
sig-paren
"
>
)
</
span
>
<
a
class
="
headerlink
"
href
="
#c.PyCodec_NameReplaceErrors
"
title
="
連結到這個定義
"
>
¶
</
a
>
<
br
/>
</
dt
>
<
dd
>
<
em
class
="
refcount return_new_ref
"
>
回傳值：新的參照。
</
em
>
<
em
class
="
stableabi
"
>
為
<
a
class
="
reference internal
"
href
="
stable.html#stable
"
>
<
span
class
="
std std-ref
"
>
穩定 ABI 的一部分
</
span
>
</
a
>
自 3.7 版本開始.
</
em
>
<
p
>
將 unicode 編碼錯誤替換為
<
code
class
="
docutils literal notranslate
"
>
<
span
class
="
pre
"
>
\N{...}
</
span
>
</
code
>
跳脫。
</
p
>
<
div
class
="
versionadded
"
>
<
p
>
<
span
class
="
versionmodified added
"
>
在 3.5 版被加入.
</
span
>
</
p
>
</
div
>
</
dd
>
</
dl
>
</
section
>
<
section
id
="
codec-utility-variables
"
>
<
h2
>
Codec utility variables
<
a
class
="
headerlink
"
href
="
#codec-utility-variables
"
title
="
連結到這個標頭
"
>
¶
</
a
>
</
h2
>
<
dl
class
="
c var
"
>
<
dt
class
="
sig sig-object c
"
id
="
c.Py_hexdigits
"
>
<
span
class
="
k
"
>
<
span
class
="
pre
"
>
const
</
span
>
</
span
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
kt
"
>
<
span
class
="
pre
"
>
char
</
span
>
</
span
>
<
span
class
="
w
"
>
</
span
>
<
span
class
="
p
"
>
<
span
class
="
pre
"
>
*
</
span
>
</
span
>
<
span
class
="
sig-name descname
"
>
<
span
class
="
n
"
>
<
span
class
="
pre
"
>
Py_hexdigits
</
span
>
</
span
>
</
span
>
<
a
class
="
headerlink
"
href
="
#c.Py_hexdigits
"
title
="
連結到這個定義
"
>
¶
</
a
>
<
br
/>
</
dt
>
<
dd
>
<
p
>
A string constant containing the lowercase hexadecimal digits:
<
code
class
="
docutils literal notranslate
"
>
<
span
class
="
pre
"
>
"0123456789abcdef"
</
span
>
</
code
>
.
</
p
>
<
div
class
="
versionadded
"
>
<
p
>
<
span
class
="
versionmodified added
"
>
在 3.3 版被加入.
</
span
>
</
p
>
</
div
>
</
dd
>
</
dl
>
</
section
>
</
section
>
<
div
class
="
clearer
"
>
</
div
>
</
div
>
</
div
>
</
div
>
<
div
class
="
sphinxsidebar
"
role
="
navigation
"
aria-label
="
Main
"
>
<
div
class
="
sphinxsidebarwrapper
"
>
<
div
>
<
h3
>
<
a
href
="
../contents.html
"
>
目錄
</
a
>
</
h3
>
<
ul
>
<
li
>
<
a
class
="
reference internal
"
href
="
#
"
>
編解碼器註冊表和支援函式
</
a
>
<
ul
>
<
li
>
<
a
class
="
reference internal
"
href
="
#codec-lookup-api
"
>
編解碼器查找 API
</
a
>
</
li
>
<
li
>
<
a
class
="
reference internal
"
href
="
#registry-api-for-unicode-encoding-error-handlers
"
>
用於 Unicode 編碼錯誤處理程式的註冊 API
</
a
>
</
li
>
<
li
>
<
a
class
="
reference internal
"
href
="
#codec-utility-variables
"
>
Codec utility variables
</
a
>
</
li
>
</
ul
>
</
li
>
</
ul
>
</
div
>
<
div
>
<
h4
>
上個主題
</
h4
>
<
p
class
="
topless
"
>
<
a
href
="
reflection.html
"
title
="
上一章
"
>
Reflection
</
a
>
</
p
>
</
div
>
<
div
>
<
h4
>
下個主題
</
h4
>
<
p
class
="
topless
"
>
<
a
href
="
time.html
"
title
="
下一章
"
>
PyTime C API
</
a
>
</
p
>
</
div
>
<
script
>
document
.
addEventListener
(
'DOMContentLoaded'
,
(
)
=>
{
const
title
=
document
.
querySelector
(
'meta[property="og:title"]'
)
.
content
;
const
elements
=
document
.
querySelectorAll
(
'.improvepage'
)
;
const
pageurl
=
window
.
location
.
href
.
split
(
'?'
)
[
0
]
;
elements
.
forEach
(
element
=>
{
const
url
=
new
URL
(
element
.
href
.
split
(
'?'
)
[
0
]
.
replace
(
"-nojs"
,
""
)
)
;
url
.
searchParams
.
set
(
'pagetitle'
,
title
)
;
url
.
searchParams
.
set
(
'pageurl'
,
pageurl
)
;
url
.
searchParams
.
set
(
'pagesource'
,
"c-api/codec.rst"
)
;
element
.
href
=
url
.
toString
(
)
;
}
)
;
}
)
;
</
script
>
<
div
role
="
note
"
aria-label
="
source link
"
>
<
h3
>
此頁面
</
h3
>
<
ul
class
="
this-page-menu
"
>
<
li
>
<
a
href
="
../bugs.html
"
>
回報錯誤
</
a
>
</
li
>
<
li
>
<
a
class
="
improvepage
"
href
="
../improve-page-nojs.html
"
>
改進此頁面
</
a
>
</
li
>
<
li
>
<
a
href
="
https://github.com/python/cpython/blob/3.15/Doc/c-api/codec.rst?plain=1
"
rel
="
nofollow
"
>
顯示原始碼
</
a
>
</
li
>
<
li
>
<
a
href
="
https://github.com/python/python-docs-zh-tw/blob/3.15/c-api/codec.po?plain=1
"
rel
="
nofollow
"
>
顯示翻譯原始碼
</
a
>
</
li
>
</
ul
>
</
div
>
</
div
>
<
div
id
="
sidebarbutton
"
title
="
收合側邊欄
"
>
<
span
>
«
</
span
>
</
div
>
</
div
>
<
div
class
="
clearer
"
>
</
div
>
</
div
>
<
div
class
="
related
"
role
="
navigation
"
aria-label
="
Related
"
>
<
h3
>
導航
</
h3
>
<
ul
>
<
li
class
="
right
"
style
="
margin-right: 10px
"
>
<
a
href
="
../genindex.html
"
title
="
總索引
"
>
索引
</
a
>
</
li
>
<
li
class
="
right
"
>
<
a
href
="
../py-modindex.html
"
title
="
Python 模組索引
"
>
模組
</
a
>
|
</
li
>
<
li
class
="
right
"
>
<
a
href
="
time.html
"
title
="
PyTime C API
"
>
下一頁
</
a
>
|
</
li
>
<
li
class
="
right
"
>
<
a
href
="
reflection.html
"
title
="
Reflection
"
>
上一頁
</
a
>
|
</
li
>
<
li
class
="
root-icon
"
>
<
img
src
="
../_static/py.svg
"
alt
="
Python logo
"
style
="
vertical-align: middle; margin-top: -1px
"
>
</
li
>
<
li
>
<
a
href
="
https://www.python.org/
"
>
Python
</
a
>
»
</
li
>
<
li
class
="
switchers
"
>
<
div
class
="
language_switcher_placeholder
"
>
</
div
>
<
div
class
="
version_switcher_placeholder
"
>
</
div
>
</
li
>
<
li
>
</
li
>
<
li
id
="
cpython-language-and-version
"
>
<
a
href
="
../index.html
"
>
3.15.0 Documentation
</
a
>
»
</
li
>
<
li
class
="
nav-item nav-item-1
"
>
<
a
href
="
index.html
"
>
Python/C API 參考手冊
</
a
>
»
</
li
>
<
li
class
="
nav-item nav-item-2
"
>
<
a
href
="
utilities.html
"
>
工具
</
a
>
»
</
li
>
<
li
class
="
nav-item nav-item-this
"
>
<
a
href
=""
>
編解碼器註冊表和支援函式
</
a
>
</
li
>
<
li
class
="
right
"
>
<
div
class
="
inline-search
"
role
="
search
"
>
<
form
class
="
inline-search
"
action
="
../search.html
"
method
="
get
"
>
<
input
placeholder
="
快速搜索
"
aria-label
="
快速搜索
"
type
="
search
"
name
="
q
"
id
="
search-box
"
>
<
input
type
="
submit
"
value
="
前往
"
>
</
form
>
</
div
>
|
</
li
>
<
li
class
="
right
"
>
<
label
class
="
theme-selector-label
"
>
主題
<
select
class
="
theme-selector
"
oninput
="
activateTheme(this.value)
"
>
<
option
value
="
auto
"
selected
>
自動
</
option
>
<
option
value
="
light
"
>
淺色模式
</
option
>
<
option
value
="
dark
"
>
深色模式
</
option
>
</
select
>
</
label
>
|
</
li
>
</
ul
>
</
div
>
<
div
class
="
footer
"
>
©
<
a
href
="
../copyright.html
"
>
版權所有
</
a
>
2001 Python Software Foundation.
<
br
>
此頁面採用 Python 軟體基金會授權條款第 2 版。
<
br
>
文件中的範例、應用技巧與其他程式碼額外採用了 Zero Clause BSD 授權條款。
<
br
>
更多訊息請見
<
a
href
="
/license.html
"
>
歷史與授權條款
</
a
>
。
<
br
>
<
br
>
Python 軟體基金會是一家非營利法人。
<
a
href
="
https://www.python.org/psf/donations/
"
>
敬請捐贈。
</
a
>
<
br
>
<
br
>
最後更新於 10月 15, 2026 (20:36 UTC)。
<
a
href
="
/bugs.html
"
>
發現 bug
</
a
>
？
<
br
>
以
<
a
href
="
https://www.sphinx-doc.org/
"
>
Sphinx
</
a
>
8.2.3建立。
</
div
>
</
body
>
</
html
>
Back
|
FazBrowse Home
|
New Git URL