### 導航
- [索引](../genindex.xhtml "總目錄")
- [模塊](../py-modindex.xhtml "Python 模塊索引") |
- [下一頁](toplevel_components.xhtml "9. 最高層級組件") |
- [上一頁](simple_stmts.xhtml "7. 簡單語句") |
- 
- [Python](https://www.python.org/) ?
- zh\_CN 3.7.3 [文檔](../index.xhtml) ?
- [Python 語言參考](index.xhtml) ?
- $('.inline-search').show(0); |
# 8. 復合語句
復合語句是包含其它語句(語句組)的語句;它們會以某種方式影響或控制所包含其它語句的執行。 通常,復合語句會跨越多行,雖然在某些簡單形式下整個復合語句也可能包含于一行之內。
[`if`](#if), [`while`](#while) 和 [`for`](#for) 語句用來實現傳統的控制流程構造。 [`try`](#try) 語句為一組語句指定異常處理和/和清理代碼,而 [`with`](#with) 語句允許在一個代碼塊周圍執行初始化和終結化代碼。 函數和類定義在語法上也屬于復合語句。
一條復合語句由一個或多個‘子句’組成。 一個子句則包含一個句頭和一個‘句體’。 特定復合語句的子句頭都處于相同的縮進層級。 每個子句頭以一個作為唯一標識的關鍵字開始并以一個冒號結束。 子句體是由一個子句控制的一組語句。 子句體可以是在子句頭的冒號之后與其同處一行的一條或由分號分隔的多條簡單語句,或者也可以是在其之后縮進的一行或多行語句。 只有后一種形式的子句體才能包含嵌套的復合語句;以下形式是不合法的,這主要是因為無法分清某個后續的 [`else`](#else) 子句應該屬于哪個 [`if`](#if) 子句:
```
if test1: if test2: print(x)
```
還要注意的是在這種情形下分號的綁定比冒號更緊密,因此在以下示例中,所有 [`print()`](../library/functions.xhtml#print "print") 調用或者都不執行,或者都執行:
```
if x < y < z: print(x); print(y); print(z)
```
總結:
```
compound_stmt ::= if_stmt
| while_stmt
| for_stmt
| try_stmt
| with_stmt
| funcdef
| classdef
| async_with_stmt
| async_for_stmt
| async_funcdef
suite ::= stmt_list NEWLINE | NEWLINE INDENT statement+ DEDENT
statement ::= stmt_list NEWLINE | compound_stmt
stmt_list ::= simple_stmt (";" simple_stmt)* [";"]
```
請注意語句總是以 `NEWLINE` 結束,之后可能跟隨一個 `DEDENT`。 還要注意可選的后續子句總是以一個不能作為語句開頭的關鍵字作為開頭,因此不會產生歧義(‘懸空的 [`else`](#else)’問題在 Python 中是通過要求嵌套的 [`if`](#if) 語句必須縮進來解決的)。
為了保證清晰,以下各節中語法規則采用將每個子句都放在單獨行中的格式。
## 8.1. `if` 語句
[`if`](#if) 語句用于有條件的執行:
```
if_stmt ::= "if" expression ":" suite
("elif" expression ":" suite)*
["else" ":" suite]
```
它通過對表達式逐個求值直至找到一個真值(請參閱 [布爾運算](expressions.xhtml#booleans) 了解真值與假值的定義)在子句體中選擇唯一匹配的一個;然后執行該子句體(而且 [`if`](#if) 語句的其他部分不會被執行或求值)。 如果所有表達式均為假值,則如果 [`else`](#else) 子句體如果存在就會被執行。
## 8.2. `while` 語句
[`while`](#while) 語句用于在表達式保持為真的情況下重復地執行:
```
while_stmt ::= "while" expression ":" suite
["else" ":" suite]
```
這將重復地檢驗表達式,并且如果其值為真就執行第一個子句體;如果表達式值為假(這可能在第一次檢驗時就發生)則如果 `else` 子句體存在就會被執行并終止循環。
第一個子句體中的 [`break`](simple_stmts.xhtml#break) 語句在執行時將終止循環且不執行 `else` 子句體。 第一個子句體中的 [`continue`](simple_stmts.xhtml#continue) 語句在執行時將跳過子句體中的剩余部分并返回檢驗表達式。
## 8.3. `for` 語句
[`for`](#for) 語句用于對序列(例如字符串、元組或列表)或其他可迭代對象中的元素進行迭代:
```
for_stmt ::= "for" target_list "in" expression_list ":" suite
["else" ":" suite]
```
表達式列表會被求值一次;它應該產生一個可迭代對象。 系統將為 `expression_list` 的結果創建一個迭代器,然后將為迭代器所提供的每一項執行一次子句體,具體次序與迭代器的返回順序一致。 每一項會按標準賦值規則 (參見 [賦值語句](simple_stmts.xhtml#assignment)) 被依次賦值給目標列表,然后子句體將被執行。 當所有項被耗盡時 (這會在序列為空或迭代器引發 [`StopIteration`](../library/exceptions.xhtml#StopIteration "StopIteration") 異常時立刻發生),`else` 子句的子句體如果存在將會被執行,并終止循環。
第一個子句體中的 [`break`](simple_stmts.xhtml#break) 語句在執行時將終止循環且不執行 `else` 子句體。 第一個子句體中的 [`continue`](simple_stmts.xhtml#continue) 語句在執行時將跳過子句體中的剩余部分并轉往下一項繼續執行,或者在沒有下一項時轉往 `else` 子句執行。
The for-loop makes assignments to the variables(s) in the target list. This overwrites all previous assignments to those variables including those made in the suite of the for-loop:
```
for i in range(10):
print(i)
i = 5 # this will not affect the for-loop
# because i will be overwritten with the next
# index in the range
```
目標列表中的名稱在循環結束時不會被刪除,但如果序列為空,則它們根本不會被循環所賦值。 提示:內置函數 [`range()`](../library/stdtypes.xhtml#range "range") 會返回一個可迭代的整數序列,適用于模擬 Pascal 中的 `for i := a to b do` 這種效果;例如 `list(range(3))` 會返回列表 `[0, 1, 2]`。
注解
當序列在循環中被修改時會有一個微妙的問題(這只可能發生于可變序列例如列表中)。 會有一個內部計數器被用來跟蹤下一個要使用的項,每次迭代都會使計數器遞增。 當計數器值達到序列長度時循環就會終止。 這意味著如果語句體從序列中刪除了當前(或之前)的一項,下一項就會被跳過(因為其標號將變成已被處理的當前項的標號)。 類似地,如果語句體在序列當前項的前面插入一個新項,當前項會在循環的下一輪中再次被處理。 這會導致麻煩的程序錯誤,避免此問題的辦法是對整個序列使用切片來創建一個臨時副本,例如
```
for x in a[:]:
if x < 0: a.remove(x)
```
## 8.4. `try` 語句
[`try`](#try) 語句可為一組語句指定異常處理器和/或清理代碼:
```
try_stmt ::= try1_stmt | try2_stmt
try1_stmt ::= "try" ":" suite
("except" [expression ["as" identifier]] ":" suite)+
["else" ":" suite]
["finally" ":" suite]
try2_stmt ::= "try" ":" suite
"finally" ":" suite
```
[`except`](#except) 子句指定一個或多個異常處理器。 當 [`try`](#try) 子句中沒有發生異常時,沒有異常處理器會被執行。 當 `try` 子句中發生異常時,將啟動對異常處理器的搜索。 此搜索會依次檢查 except 子句,直至找到與該異常相匹配的子句。 如果存在無表達式的 except 子句,它必須是最后一個;它將匹配任何異常。 對于帶有表達式的 except 子句,該表達式會被求值,如果結果對象與發生的異常“兼容”則該子句將匹配該異常。 一個對象如果是異常對象所屬的類或基類,或者是包含有兼容該異常的項的元組則兩者就是兼容的。
如果沒有 except 子句與異常相匹配,則會在周邊代碼和發起調用棧上繼續搜索異常處理器。 [1](#id4)
如果在對 except 子句頭中的表達式求值時引發了異常,則原來對處理器的搜索會被取消,并在周邊代碼和調用棧上啟動對新異常的搜索(它會被視作是整個 [`try`](#try) 語句所引發的異常)。
當找到一個匹配的 except 子句時,該異常將被賦值給該 except 子句在 `as` 關鍵字之后指定的目標,如果存在此關鍵字的話,并且該 except 子句體將被執行。 所有 except 子句都必須有可執行的子句體。 當到達子句體的末尾時,通常會轉向整個 try 語句之后繼續執行。 (這意味著如果對于同一異常存在有嵌套的兩個處理器,而異常發生于內層處理器的 try 子句中,則外層處理器將不會處理該異常。)
當使用 `as` 將目標賦值為一個異常時,它將在 except 子句結束時被清除。 這就相當于
```
except E as N:
foo
```
被轉寫為
```
except E as N:
try:
foo
finally:
del N
```
這意味著異常必須賦值給一個不同的名稱才能在 except 子句之后引用它。 異常會被清除是因為在附加了回溯信息的情況下,它們會形成堆棧幀的循環引用,使得所有局部變量保持存活直到發生下一次垃圾回收。
在一個 except 子句體被執行之前,有關異常的詳細信息存放在 [`sys`](../library/sys.xhtml#module-sys "sys: Access system-specific parameters and functions.") 模塊中,可通過 [`sys.exc_info()`](../library/sys.xhtml#sys.exc_info "sys.exc_info") 來訪問。 [`sys.exc_info()`](../library/sys.xhtml#sys.exc_info "sys.exc_info") 返回一個 3 元組,由異常類、異常實例和回溯對象組成(參見 [標準類型層級結構](datamodel.xhtml#types) 一節),用于在程序中標識異常發生點。 當從處理異常的函數返回時 [`sys.exc_info()`](../library/sys.xhtml#sys.exc_info "sys.exc_info") 的值會恢復為(調用前的)原值。
如果控制流離開 [`try`](#try) 子句體時沒有引發異常,并且沒有執行 [`return`](simple_stmts.xhtml#return), [`continue`](simple_stmts.xhtml#continue) 或 [`break`](simple_stmts.xhtml#break) 語句,可選的 `else` 子句將被執行。 `else` 語句中的異常不會由之前的 [`except`](#except) 子句處理。
如果存在 [`finally`](#finally),它將指定‘清理’處理器。 [`try`](#try) 子句會被執行,包括任何 [`except`](#except) 和 `else` 子句。 如果在這些子句中發生任何未處理的異常,該異常會被臨時保存。 `finally` 子句將被執行。 如果存在被保存的異常,它會在 `finally` 子句的末尾被重新引發。 如果 `finally` 子句引發了另一個異常,被保存的異常會被設為新異常的上下文。 如果 `finally` 子句執行了 [`return`](simple_stmts.xhtml#return) 或 [`break`](simple_stmts.xhtml#break) 語句,被保存的異常會被丟棄:
```
>>> def f():
... try:
... 1/0
... finally:
... return 42
...
>>> f()
42
```
在 [`finally`](#finally) 子句執行期間,程序不能獲取異常信息。
當 [`return`](simple_stmts.xhtml#return), [`break`](simple_stmts.xhtml#break) 或 [`continue`](simple_stmts.xhtml#continue) 語句在一個 `try`...`finally` 語句的 [`try`](#try) 子句體中被執行時,[`finally`](#finally) 子句也會‘在離開時’被執行。 [`continue`](simple_stmts.xhtml#continue) 語句在 `finally` 子句中是不合法的。 (原因在于當前實現存在一個問題 --- 此限制可能會在未來去除)。
函數的返回值是由最后被執行的 [`return`](simple_stmts.xhtml#return) 語句所決定的。 由于 [`finally`](#finally) 子句總是被執行,因此在 `finally` 子句中被執行的 `return` 語句總是最后被執行的:
```
>>> def foo():
... try:
... return 'try'
... finally:
... return 'finally'
...
>>> foo()
'finally'
```
有關異常的更多信息可以在 [異常](executionmodel.xhtml#exceptions) 一節找到,有關使用 [`raise`](simple_stmts.xhtml#raise) 語句生成異常的信息可以在 [raise 語句](simple_stmts.xhtml#raise) 一節找到。
## 8.5. `with` 語句
[`with`](#with) 語句用于包裝帶有使用上下文管理器 (參見 [with 語句上下文管理器](datamodel.xhtml#context-managers) 一節) 定義的方法的代碼塊的執行。 這允許對普通的 [`try`](#try)...[`except`](#except)...[`finally`](#finally) 使用模式進行封裝以方便地重用。
```
with_stmt ::= "with" with_item ("," with_item)* ":" suite
with_item ::= expression ["as" target]
```
帶有一個“項目”的 [`with`](#with) 語句的執行過程如下:
1. 對上下文表達式 (在 [`with_item`](#grammar-token-with-item) 中給出的表達式) 求值以獲得一個上下文管理器。
2. 載入上下文管理器的 [`__exit__()`](datamodel.xhtml#object.__exit__ "object.__exit__") 以便后續使用。
3. 發起調用上下文管理器的 [`__enter__()`](datamodel.xhtml#object.__enter__ "object.__enter__") 方法。
4. 如果 [`with`](#with) 語句中包含一個目標,來自 [`__enter__()`](datamodel.xhtml#object.__enter__ "object.__enter__") 的返回值將被賦值給它。
注解
[`with`](#with) 語句會保證如果 [`__enter__()`](datamodel.xhtml#object.__enter__ "object.__enter__") 方法返回時未發生錯誤,則 [`__exit__()`](datamodel.xhtml#object.__exit__ "object.__exit__") 將總是被調用。 因此,如果在對目標列表賦值期間發生錯誤,則會將其視為在語句體內部發生的錯誤。 參見下面的第 6 步。
5. 執行語句體。
6. 發起調用上下文管理器的 [`__exit__()`](datamodel.xhtml#object.__exit__ "object.__exit__") 方法。 如果語句體的退出是由異常導致的,則其類型、值和回溯信息將被作為參數傳遞給 [`__exit__()`](datamodel.xhtml#object.__exit__ "object.__exit__")。 否則的話,將提供三個 [`None`](../library/constants.xhtml#None "None") 參數。
如果語句體的退出是由異常導致的,并且來自 [`__exit__()`](datamodel.xhtml#object.__exit__ "object.__exit__") 方法的返回值為假,則該異常會被重新引發。 如果返回值為真,則該異常會被抑制,并會繼續執行 [`with`](#with) 語句之后的語句。
如果語句體由于異常以外的任何原因退出,則來自 [`__exit__()`](datamodel.xhtml#object.__exit__ "object.__exit__") 的返回值會被忽略,并會在該類退出正常的發生位置繼續執行。
如果有多個項目,則會視作存在多個 [`with`](#with) 語句嵌套來處理多個上下文管理器:
```
with A() as a, B() as b:
suite
```
等價于
```
with A() as a:
with B() as b:
suite
```
在 3.1 版更改: 支持多個上下文表達式。
參見
[**PEP 343**](https://www.python.org/dev/peps/pep-0343) \[https://www.python.org/dev/peps/pep-0343\] - "with" 語句Python [`with`](#with) 語句的規范描述、背景和示例。
## 8.6. 函數定義
函數定義就是對用戶自定義函數的定義(參見 [標準類型層級結構](datamodel.xhtml#types) 一節):
```
funcdef ::= [decorators] "def" funcname "(" [parameter_list] ")"
["->" expression] ":" suite
decorators ::= decorator+
decorator ::= "@" dotted_name ["(" [argument_list [","]] ")"] NEWLINE
dotted_name ::= identifier ("." identifier)*
parameter_list ::= defparameter ("," defparameter)* ["," [parameter_list_starargs]]
| parameter_list_starargs
parameter_list_starargs ::= "*" [parameter] ("," defparameter)* ["," ["**" parameter [","]]]
| "**" parameter [","]
parameter ::= identifier [":" expression]
defparameter ::= parameter ["=" expression]
funcname ::= identifier
```
函數定義是一條可執行語句。 它執行時會在當前局部命名空間中將函數名稱綁定到一個函數對象(函數可執行代碼的包裝器)。 這個函數對象包含對當前全局命名空間的引用,作為函數被調用時所使用的全局命名空間。
函數定義并不會執行函數體;只有當函數被調用時才會執行此操作。 [2](#id5)
一個函數定義可以被一個或多個 [decorator](../glossary.xhtml#term-decorator) 表達式所包裝。 當函數被定義時將在包含該函數定義的作用域中對裝飾器表達式求值。 求值結果必須是一個可調用對象,它會以該函數對象作為唯一參數被發起調用。 其返回值將被綁定到函數名稱而非函數對象。 多個裝飾器會以嵌套方式被應用。 例如以下代碼
```
@f1(arg)
@f2
def func(): pass
```
大致等價于
```
def func(): pass
func = f1(arg)(f2(func))
```
不同之處在于原始函數并不會被臨時綁定到名稱 `func`。
當一個或多個 [形參](../glossary.xhtml#term-parameter) 具有 *形參*`=` *表達式* 這樣的形式時,該函數就被稱為具有“默認形參值”。 對于一個具有默認值的形參,其對應的 [argument](../glossary.xhtml#term-argument) 可以在調用中被省略,在此情況下會用形參的默認值來替代。 如果一個形參具有默認值,后續所有在 "`*`" 之前的形參也必須具有默認值 --- 這個句法限制并未在語法中明確表達。
**默認形參值會在執行函數定義時按從左至右的順序被求值。** 這意味著當函數被定義時將對表達式求值一次,相同的“預計算”值將在每次調用時被使用。 這一點在默認形參為可變對象,例如列表或字典的時候尤其需要重點理解:如果函數修改了該對象(例如向列表添加了一項),則實際上默認值也會被修改。 這通常不是人們所預期的。 繞過此問題的一個方法是使用 `None` 作為默認值,并在函數體中顯式地對其進行測試,例如:
```
def whats_on_the_telly(penguin=None):
if penguin is None:
penguin = []
penguin.append("property of the zoo")
return penguin
```
函數調用的語義在 [調用](expressions.xhtml#calls) 一節中有更詳細的描述。 函數調用總是會給形參列表中列出的所有形參賦值,或用位置參數,或用關鍵字參數,或用默認值。 如果存在 "`*identifier`" 這樣的形式,它會被初始化為一個元組來接收任何額外的位置參數,默認為空元組。 如果存在 "`**identifier`" 這樣的形式,它會被初始化為一個新的有序映射來接收任何額外的關鍵字參數,默認為一個相同類型的空映射。 在 "`*`" 或 "`*identifier`" 之后的形參都是僅關鍵字形參,只能通過關鍵字參數傳入值。
形參可以帶有 [標注](../glossary.xhtml#term-function-annotation),其形式為在形參名稱后加上 "`: expression`"。 任何形參都可以帶有標注,甚至 `*identifier` 或 `**identifier` 這樣的形參也可以。 函數可以帶有“返回”標注,其形式為在形參列表后加上 "`-> expression`"。 這些標注可以是任何有效的 Python 表達式。 標注的存在不會改變函數的語義。 標注值可以作為函數對象的 `__annotations__` 屬性中以對應形參名稱為鍵的字典值被訪問。 如果使用了 `annotations` import from [`__future__`](../library/__future__.xhtml#module-__future__ "__future__: Future statement definitions") 的方式,則標注會在運行時保存為字符串以啟用延遲求值特性。 否則,它們會在執行函數定義時被求值。 在這種情況下,標注的求值順序可能與它們在源代碼中出現的順序不同。
創建匿名函數(未綁定到一個名稱的函數)以便立即在表達式中使用也是可能的。 這需要使用 lambda 表達式,具體描述見 [lambda 表達式](expressions.xhtml#lambda) 一節。 請注意 lambda 只是簡單函數定義的一種簡化寫法;在 "[`def`](#def)" 語句中定義的函數也可以像用 lambda 表達式定義的函數一樣被傳遞或賦值給其他名稱。 "`def`" 形式實際上更為強大,因為它允許執行多條語句和使用標注。
**程序員注意事項:** 函數屬于一類對象。 在一個函數內部執行的 "`def`" 語句會定義一個局部函數并可被返回或傳遞。 在嵌套函數中使用的自由變量可以訪問包含該 def 語句的函數的局部變量。 詳情參見 [命名與綁定](executionmodel.xhtml#naming) 一節。
參見
[**PEP 3107**](https://www.python.org/dev/peps/pep-3107) \[https://www.python.org/dev/peps/pep-3107\] - 函數標注最初的函數標注規范說明。
[**PEP 484**](https://www.python.org/dev/peps/pep-0484) \[https://www.python.org/dev/peps/pep-0484\] - 類型提示標注的標準含意定義:類型提示。
[**PEP 526**](https://www.python.org/dev/peps/pep-0526) \[https://www.python.org/dev/peps/pep-0526\] - 變量標注的語法變量聲明的類型提示功能,包括類變量和實例變量
[**PEP 563**](https://www.python.org/dev/peps/pep-0563) \[https://www.python.org/dev/peps/pep-0563\] - 延遲的標注求值支持在運行時通過以字符串形式保存標注而非不是即求值來實現標注內部的向前引用。
## 8.7. 類定義
類定義就是對類對象的定義 (參見 [標準類型層級結構](datamodel.xhtml#types) 一節):
```
classdef ::= [decorators] "class" classname [inheritance] ":" suite
inheritance ::= "(" [argument_list] ")"
classname ::= identifier
```
類定義是一條可執行語句。 其中繼承列表通常給出基類的列表 (進階用法請參見 [元類](datamodel.xhtml#metaclasses)),列表中的每一項都應當被求值為一個允許子類的類對象。 沒有繼承列表的類默認繼承自基類 [`object`](../library/functions.xhtml#object "object");因此,:
```
class Foo:
pass
```
等價于
```
class Foo(object):
pass
```
隨后類體將在一個新的執行幀 (參見 [命名與綁定](executionmodel.xhtml#naming)) 中被執行,使用新創建的局部命名空間和原有的全局命名空間。 (通常,類體主要包含函數定義。) 當類體結束執行時,其執行幀將被丟棄而其局部命名空間會被保存。 [3](#id6) 一個類對象隨后會被創建,其基類使用給定的繼承列表,屬性字典使用保存的局部命名空間。 類名稱將在原有的全局命名空間中綁定到該類對象。
在類體內定義的屬性的順序保存在新類的 `__dict__` 中。 請注意此順序的可靠性只限于類剛被創建時,并且只適用于使用定義語法所定義的類。
類的創建可使用 [元類](datamodel.xhtml#metaclasses) 進行重度定制。
類也可以被裝飾:就像裝飾函數一樣,:
```
@f1(arg)
@f2
class Foo: pass
```
大致等價于
```
class Foo: pass
Foo = f1(arg)(f2(Foo))
```
裝飾器表達式的求值規則與函數裝飾器相同。 結果隨后會被綁定到類名稱。
**程序員注意事項:** 在類定義內定義的變量是類屬性;它們將被類實例所共享。 實例屬性可通過 `self.name = value` 在方法中設定。 類和實例屬性均可通過 "`self.name`" 表示法來訪問,當通過此方式訪問時實例屬性會隱藏同名的類屬性。 類屬性可被用作實例屬性的默認值,但在此場景下使用可變值可能導致未預期的結果。 可以使用 [描述器](datamodel.xhtml#descriptors) 來創建具有不同實現細節的實例變量。
參見
[**PEP 3115**](https://www.python.org/dev/peps/pep-3115) \[https://www.python.org/dev/peps/pep-3115\] - Python 3000 中的元類將元類聲明修改為當前語法的提議,以及關于如何構建帶有元類的類的語義描述。
[**PEP 3129**](https://www.python.org/dev/peps/pep-3129) \[https://www.python.org/dev/peps/pep-3129\] - 類裝飾器增加類裝飾器的提議。 函數和方法裝飾器是在 [**PEP 318**](https://www.python.org/dev/peps/pep-0318) \[https://www.python.org/dev/peps/pep-0318\] 中被引入的。
## 8.8. 協程
3\.5 新版功能.
### 8.8.1. 協程函數定義
```
async_funcdef ::= [decorators] "async" "def" funcname "(" [parameter_list] ")"
["->" expression] ":" suite
```
Python 協程可以在多個位置上掛起和恢復執行 (參見 [coroutine](../glossary.xhtml#term-coroutine))。 在協程函數體內部,`await` 和 `async` 標識符已成為保留關鍵字;[`await`](expressions.xhtml#await) 表達式,[`async for`](#async-for) 以及 [`async with`](#async-with) 只能在協程函數體中使用。
使用 `async def` 語法定義的函數總是為協程函數,即使它們不包含 `await` 或 `async` 關鍵字。
在協程函數體中使用 `yield from` 表達式將引發 [`SyntaxError`](../library/exceptions.xhtml#SyntaxError "SyntaxError")。
協程函數的例子:
```
async def func(param1, param2):
do_stuff()
await some_coroutine()
```
### 8.8.2. `async for` 語句
```
async_for_stmt ::= "async" for_stmt
```
[asynchronous iterable](../glossary.xhtml#term-asynchronous-iterable) 能夠在其 *iter* 實現中調用異步代碼,而 [asynchronous iterator](../glossary.xhtml#term-asynchronous-iterator) 可以在其 *next* 方法中調用異步代碼。
`async for` 語句允許方便地對異步迭代器進行迭代。
以下代碼:
```
async for TARGET in ITER:
BLOCK
else:
BLOCK2
```
在語義上等價于:
```
iter = (ITER)
iter = type(iter).__aiter__(iter)
running = True
while running:
try:
TARGET = await type(iter).__anext__(iter)
except StopAsyncIteration:
running = False
else:
BLOCK
else:
BLOCK2
```
另請參閱 [`__aiter__()`](datamodel.xhtml#object.__aiter__ "object.__aiter__") 和 [`__anext__()`](datamodel.xhtml#object.__anext__ "object.__anext__") 了解詳情。
在協程函數體之外使用 `async for` 語句將引發 [`SyntaxError`](../library/exceptions.xhtml#SyntaxError "SyntaxError")。
### 8.8.3. `async with` 語句
```
async_with_stmt ::= "async" with_stmt
```
[asynchronous context manager](../glossary.xhtml#term-asynchronous-context-manager) 是一種 [context manager](../glossary.xhtml#term-context-manager),能夠在其 *enter* 和 *exit* 方法中暫停執行。
以下代碼:
```
async with EXPR as VAR:
BLOCK
```
在語義上等價于:
```
mgr = (EXPR)
aexit = type(mgr).__aexit__
aenter = type(mgr).__aenter__(mgr)
VAR = await aenter
try:
BLOCK
except:
if not await aexit(mgr, *sys.exc_info()):
raise
else:
await aexit(mgr, None, None, None)
```
另請參閱 [`__aenter__()`](datamodel.xhtml#object.__aenter__ "object.__aenter__") 和 [`__aexit__()`](datamodel.xhtml#object.__aexit__ "object.__aexit__") 了解詳情。
在協程函數體之外使用 `async with` 語句將引發 [`SyntaxError`](../library/exceptions.xhtml#SyntaxError "SyntaxError")。
參見
[**PEP 492**](https://www.python.org/dev/peps/pep-0492) \[https://www.python.org/dev/peps/pep-0492\] - 使用 async 和 await 語法實現協程將協程作為 Python 中的一個正式的單獨概念,并增加相應的支持語法。
腳注
[1](#id1)異常會被傳播給發起調用棧,除非存在一個 [`finally`](#finally) 子句正好引發了另一個異常。 新引發的異常將導致舊異常的丟失。
[2](#id2)作為函數體的第一條語句出現的字符串字面值會被轉換為函數的 `__doc__` 屬性,也就是該函數的 [docstring](../glossary.xhtml#term-docstring)。
[3](#id3)作為類體的第一條語句出現的字符串字面值會被轉換為命名空間的 `__doc__` 條目,也就是該類的 [docstring](../glossary.xhtml#term-docstring)。
### 導航
- [索引](../genindex.xhtml "總目錄")
- [模塊](../py-modindex.xhtml "Python 模塊索引") |
- [下一頁](toplevel_components.xhtml "9. 最高層級組件") |
- [上一頁](simple_stmts.xhtml "7. 簡單語句") |
- 
- [Python](https://www.python.org/) ?
- zh\_CN 3.7.3 [文檔](../index.xhtml) ?
- [Python 語言參考](index.xhtml) ?
- $('.inline-search').show(0); |
? [版權所有](../copyright.xhtml) 2001-2019, Python Software Foundation.
Python 軟件基金會是一個非盈利組織。 [請捐助。](https://www.python.org/psf/donations/)
最后更新于 5月 21, 2019. [發現了問題](../bugs.xhtml)?
使用[Sphinx](http://sphinx.pocoo.org/)1.8.4 創建。
- Python文檔內容
- Python 有什么新變化?
- Python 3.7 有什么新變化
- 摘要 - 發布重點
- 新的特性
- 其他語言特性修改
- 新增模塊
- 改進的模塊
- C API 的改變
- 構建的改變
- 性能優化
- 其他 CPython 實現的改變
- 已棄用的 Python 行為
- 已棄用的 Python 模塊、函數和方法
- 已棄用的 C API 函數和類型
- 平臺支持的移除
- API 與特性的移除
- 移除的模塊
- Windows 專屬的改變
- 移植到 Python 3.7
- Python 3.7.1 中的重要變化
- Python 3.7.2 中的重要變化
- Python 3.6 有什么新變化A
- 摘要 - 發布重點
- 新的特性
- 其他語言特性修改
- 新增模塊
- 改進的模塊
- 性能優化
- Build and C API Changes
- 其他改進
- 棄用
- 移除
- 移植到Python 3.6
- Python 3.6.2 中的重要變化
- Python 3.6.4 中的重要變化
- Python 3.6.5 中的重要變化
- Python 3.6.7 中的重要變化
- Python 3.5 有什么新變化
- 摘要 - 發布重點
- 新的特性
- 其他語言特性修改
- 新增模塊
- 改進的模塊
- Other module-level changes
- 性能優化
- Build and C API Changes
- 棄用
- 移除
- Porting to Python 3.5
- Notable changes in Python 3.5.4
- What's New In Python 3.4
- 摘要 - 發布重點
- 新的特性
- 新增模塊
- 改進的模塊
- CPython Implementation Changes
- 棄用
- 移除
- Porting to Python 3.4
- Changed in 3.4.3
- What's New In Python 3.3
- 摘要 - 發布重點
- PEP 405: Virtual Environments
- PEP 420: Implicit Namespace Packages
- PEP 3118: New memoryview implementation and buffer protocol documentation
- PEP 393: Flexible String Representation
- PEP 397: Python Launcher for Windows
- PEP 3151: Reworking the OS and IO exception hierarchy
- PEP 380: Syntax for Delegating to a Subgenerator
- PEP 409: Suppressing exception context
- PEP 414: Explicit Unicode literals
- PEP 3155: Qualified name for classes and functions
- PEP 412: Key-Sharing Dictionary
- PEP 362: Function Signature Object
- PEP 421: Adding sys.implementation
- Using importlib as the Implementation of Import
- 其他語言特性修改
- A Finer-Grained Import Lock
- Builtin functions and types
- 新增模塊
- 改進的模塊
- 性能優化
- Build and C API Changes
- 棄用
- Porting to Python 3.3
- What's New In Python 3.2
- PEP 384: Defining a Stable ABI
- PEP 389: Argparse Command Line Parsing Module
- PEP 391: Dictionary Based Configuration for Logging
- PEP 3148: The concurrent.futures module
- PEP 3147: PYC Repository Directories
- PEP 3149: ABI Version Tagged .so Files
- PEP 3333: Python Web Server Gateway Interface v1.0.1
- 其他語言特性修改
- New, Improved, and Deprecated Modules
- 多線程
- 性能優化
- Unicode
- Codecs
- 文檔
- IDLE
- Code Repository
- Build and C API Changes
- Porting to Python 3.2
- What's New In Python 3.1
- PEP 372: Ordered Dictionaries
- PEP 378: Format Specifier for Thousands Separator
- 其他語言特性修改
- New, Improved, and Deprecated Modules
- 性能優化
- IDLE
- Build and C API Changes
- Porting to Python 3.1
- What's New In Python 3.0
- Common Stumbling Blocks
- Overview Of Syntax Changes
- Changes Already Present In Python 2.6
- Library Changes
- PEP 3101: A New Approach To String Formatting
- Changes To Exceptions
- Miscellaneous Other Changes
- Build and C API Changes
- 性能
- Porting To Python 3.0
- What's New in Python 2.7
- The Future for Python 2.x
- Changes to the Handling of Deprecation Warnings
- Python 3.1 Features
- PEP 372: Adding an Ordered Dictionary to collections
- PEP 378: Format Specifier for Thousands Separator
- PEP 389: The argparse Module for Parsing Command Lines
- PEP 391: Dictionary-Based Configuration For Logging
- PEP 3106: Dictionary Views
- PEP 3137: The memoryview Object
- 其他語言特性修改
- New and Improved Modules
- Build and C API Changes
- Other Changes and Fixes
- Porting to Python 2.7
- New Features Added to Python 2.7 Maintenance Releases
- Acknowledgements
- Python 2.6 有什么新變化
- Python 3.0
- Changes to the Development Process
- PEP 343: The 'with' statement
- PEP 366: Explicit Relative Imports From a Main Module
- PEP 370: Per-user site-packages Directory
- PEP 371: The multiprocessing Package
- PEP 3101: Advanced String Formatting
- PEP 3105: print As a Function
- PEP 3110: Exception-Handling Changes
- PEP 3112: Byte Literals
- PEP 3116: New I/O Library
- PEP 3118: Revised Buffer Protocol
- PEP 3119: Abstract Base Classes
- PEP 3127: Integer Literal Support and Syntax
- PEP 3129: Class Decorators
- PEP 3141: A Type Hierarchy for Numbers
- 其他語言特性修改
- New and Improved Modules
- Deprecations and Removals
- Build and C API Changes
- Porting to Python 2.6
- Acknowledgements
- What's New in Python 2.5
- PEP 308: Conditional Expressions
- PEP 309: Partial Function Application
- PEP 314: Metadata for Python Software Packages v1.1
- PEP 328: Absolute and Relative Imports
- PEP 338: Executing Modules as Scripts
- PEP 341: Unified try/except/finally
- PEP 342: New Generator Features
- PEP 343: The 'with' statement
- PEP 352: Exceptions as New-Style Classes
- PEP 353: Using ssize_t as the index type
- PEP 357: The 'index' method
- 其他語言特性修改
- New, Improved, and Removed Modules
- Build and C API Changes
- Porting to Python 2.5
- Acknowledgements
- What's New in Python 2.4
- PEP 218: Built-In Set Objects
- PEP 237: Unifying Long Integers and Integers
- PEP 289: Generator Expressions
- PEP 292: Simpler String Substitutions
- PEP 318: Decorators for Functions and Methods
- PEP 322: Reverse Iteration
- PEP 324: New subprocess Module
- PEP 327: Decimal Data Type
- PEP 328: Multi-line Imports
- PEP 331: Locale-Independent Float/String Conversions
- 其他語言特性修改
- New, Improved, and Deprecated Modules
- Build and C API Changes
- Porting to Python 2.4
- Acknowledgements
- What's New in Python 2.3
- PEP 218: A Standard Set Datatype
- PEP 255: Simple Generators
- PEP 263: Source Code Encodings
- PEP 273: Importing Modules from ZIP Archives
- PEP 277: Unicode file name support for Windows NT
- PEP 278: Universal Newline Support
- PEP 279: enumerate()
- PEP 282: The logging Package
- PEP 285: A Boolean Type
- PEP 293: Codec Error Handling Callbacks
- PEP 301: Package Index and Metadata for Distutils
- PEP 302: New Import Hooks
- PEP 305: Comma-separated Files
- PEP 307: Pickle Enhancements
- Extended Slices
- 其他語言特性修改
- New, Improved, and Deprecated Modules
- Pymalloc: A Specialized Object Allocator
- Build and C API Changes
- Other Changes and Fixes
- Porting to Python 2.3
- Acknowledgements
- What's New in Python 2.2
- 概述
- PEPs 252 and 253: Type and Class Changes
- PEP 234: Iterators
- PEP 255: Simple Generators
- PEP 237: Unifying Long Integers and Integers
- PEP 238: Changing the Division Operator
- Unicode Changes
- PEP 227: Nested Scopes
- New and Improved Modules
- Interpreter Changes and Fixes
- Other Changes and Fixes
- Acknowledgements
- What's New in Python 2.1
- 概述
- PEP 227: Nested Scopes
- PEP 236: future Directives
- PEP 207: Rich Comparisons
- PEP 230: Warning Framework
- PEP 229: New Build System
- PEP 205: Weak References
- PEP 232: Function Attributes
- PEP 235: Importing Modules on Case-Insensitive Platforms
- PEP 217: Interactive Display Hook
- PEP 208: New Coercion Model
- PEP 241: Metadata in Python Packages
- New and Improved Modules
- Other Changes and Fixes
- Acknowledgements
- What's New in Python 2.0
- 概述
- What About Python 1.6?
- New Development Process
- Unicode
- 列表推導式
- Augmented Assignment
- 字符串的方法
- Garbage Collection of Cycles
- Other Core Changes
- Porting to 2.0
- Extending/Embedding Changes
- Distutils: Making Modules Easy to Install
- XML Modules
- Module changes
- New modules
- IDLE Improvements
- Deleted and Deprecated Modules
- Acknowledgements
- 更新日志
- Python 下一版
- Python 3.7.3 最終版
- Python 3.7.3 發布候選版 1
- Python 3.7.2 最終版
- Python 3.7.2 發布候選版 1
- Python 3.7.1 最終版
- Python 3.7.1 RC 2版本
- Python 3.7.1 發布候選版 1
- Python 3.7.0 正式版
- Python 3.7.0 release candidate 1
- Python 3.7.0 beta 5
- Python 3.7.0 beta 4
- Python 3.7.0 beta 3
- Python 3.7.0 beta 2
- Python 3.7.0 beta 1
- Python 3.7.0 alpha 4
- Python 3.7.0 alpha 3
- Python 3.7.0 alpha 2
- Python 3.7.0 alpha 1
- Python 3.6.6 final
- Python 3.6.6 RC 1
- Python 3.6.5 final
- Python 3.6.5 release candidate 1
- Python 3.6.4 final
- Python 3.6.4 release candidate 1
- Python 3.6.3 final
- Python 3.6.3 release candidate 1
- Python 3.6.2 final
- Python 3.6.2 release candidate 2
- Python 3.6.2 release candidate 1
- Python 3.6.1 final
- Python 3.6.1 release candidate 1
- Python 3.6.0 final
- Python 3.6.0 release candidate 2
- Python 3.6.0 release candidate 1
- Python 3.6.0 beta 4
- Python 3.6.0 beta 3
- Python 3.6.0 beta 2
- Python 3.6.0 beta 1
- Python 3.6.0 alpha 4
- Python 3.6.0 alpha 3
- Python 3.6.0 alpha 2
- Python 3.6.0 alpha 1
- Python 3.5.5 final
- Python 3.5.5 release candidate 1
- Python 3.5.4 final
- Python 3.5.4 release candidate 1
- Python 3.5.3 final
- Python 3.5.3 release candidate 1
- Python 3.5.2 final
- Python 3.5.2 release candidate 1
- Python 3.5.1 final
- Python 3.5.1 release candidate 1
- Python 3.5.0 final
- Python 3.5.0 release candidate 4
- Python 3.5.0 release candidate 3
- Python 3.5.0 release candidate 2
- Python 3.5.0 release candidate 1
- Python 3.5.0 beta 4
- Python 3.5.0 beta 3
- Python 3.5.0 beta 2
- Python 3.5.0 beta 1
- Python 3.5.0 alpha 4
- Python 3.5.0 alpha 3
- Python 3.5.0 alpha 2
- Python 3.5.0 alpha 1
- Python 教程
- 課前甜點
- 使用 Python 解釋器
- 調用解釋器
- 解釋器的運行環境
- Python 的非正式介紹
- Python 作為計算器使用
- 走向編程的第一步
- 其他流程控制工具
- if 語句
- for 語句
- range() 函數
- break 和 continue 語句,以及循環中的 else 子句
- pass 語句
- 定義函數
- 函數定義的更多形式
- 小插曲:編碼風格
- 數據結構
- 列表的更多特性
- del 語句
- 元組和序列
- 集合
- 字典
- 循環的技巧
- 深入條件控制
- 序列和其它類型的比較
- 模塊
- 有關模塊的更多信息
- 標準模塊
- dir() 函數
- 包
- 輸入輸出
- 更漂亮的輸出格式
- 讀寫文件
- 錯誤和異常
- 語法錯誤
- 異常
- 處理異常
- 拋出異常
- 用戶自定義異常
- 定義清理操作
- 預定義的清理操作
- 類
- 名稱和對象
- Python 作用域和命名空間
- 初探類
- 補充說明
- 繼承
- 私有變量
- 雜項說明
- 迭代器
- 生成器
- 生成器表達式
- 標準庫簡介
- 操作系統接口
- 文件通配符
- 命令行參數
- 錯誤輸出重定向和程序終止
- 字符串模式匹配
- 數學
- 互聯網訪問
- 日期和時間
- 數據壓縮
- 性能測量
- 質量控制
- 自帶電池
- 標準庫簡介 —— 第二部分
- 格式化輸出
- 模板
- 使用二進制數據記錄格式
- 多線程
- 日志
- 弱引用
- 用于操作列表的工具
- 十進制浮點運算
- 虛擬環境和包
- 概述
- 創建虛擬環境
- 使用pip管理包
- 接下來?
- 交互式編輯和編輯歷史
- Tab 補全和編輯歷史
- 默認交互式解釋器的替代品
- 浮點算術:爭議和限制
- 表示性錯誤
- 附錄
- 交互模式
- 安裝和使用 Python
- 命令行與環境
- 命令行
- 環境變量
- 在Unix平臺中使用Python
- 獲取最新版本的Python
- 構建Python
- 與Python相關的路徑和文件
- 雜項
- 編輯器和集成開發環境
- 在Windows上使用 Python
- 完整安裝程序
- Microsoft Store包
- nuget.org 安裝包
- 可嵌入的包
- 替代捆綁包
- 配置Python
- 適用于Windows的Python啟動器
- 查找模塊
- 附加模塊
- 在Windows上編譯Python
- 其他平臺
- 在蘋果系統上使用 Python
- 獲取和安裝 MacPython
- IDE
- 安裝額外的 Python 包
- Mac 上的圖形界面編程
- 在 Mac 上分發 Python 應用程序
- 其他資源
- Python 語言參考
- 概述
- 其他實現
- 標注
- 詞法分析
- 行結構
- 其他形符
- 標識符和關鍵字
- 字面值
- 運算符
- 分隔符
- 數據模型
- 對象、值與類型
- 標準類型層級結構
- 特殊方法名稱
- 協程
- 執行模型
- 程序的結構
- 命名與綁定
- 異常
- 導入系統
- importlib
- 包
- 搜索
- 加載
- 基于路徑的查找器
- 替換標準導入系統
- Package Relative Imports
- 有關 main 的特殊事項
- 開放問題項
- 參考文獻
- 表達式
- 算術轉換
- 原子
- 原型
- await 表達式
- 冪運算符
- 一元算術和位運算
- 二元算術運算符
- 移位運算
- 二元位運算
- 比較運算
- 布爾運算
- 條件表達式
- lambda 表達式
- 表達式列表
- 求值順序
- 運算符優先級
- 簡單語句
- 表達式語句
- 賦值語句
- assert 語句
- pass 語句
- del 語句
- return 語句
- yield 語句
- raise 語句
- break 語句
- continue 語句
- import 語句
- global 語句
- nonlocal 語句
- 復合語句
- if 語句
- while 語句
- for 語句
- try 語句
- with 語句
- 函數定義
- 類定義
- 協程
- 最高層級組件
- 完整的 Python 程序
- 文件輸入
- 交互式輸入
- 表達式輸入
- 完整的語法規范
- Python 標準庫
- 概述
- 可用性注釋
- 內置函數
- 內置常量
- 由 site 模塊添加的常量
- 內置類型
- 邏輯值檢測
- 布爾運算 — and, or, not
- 比較
- 數字類型 — int, float, complex
- 迭代器類型
- 序列類型 — list, tuple, range
- 文本序列類型 — str
- 二進制序列類型 — bytes, bytearray, memoryview
- 集合類型 — set, frozenset
- 映射類型 — dict
- 上下文管理器類型
- 其他內置類型
- 特殊屬性
- 內置異常
- 基類
- 具體異常
- 警告
- 異常層次結構
- 文本處理服務
- string — 常見的字符串操作
- re — 正則表達式操作
- 模塊 difflib 是一個計算差異的助手
- textwrap — Text wrapping and filling
- unicodedata — Unicode 數據庫
- stringprep — Internet String Preparation
- readline — GNU readline interface
- rlcompleter — GNU readline的完成函數
- 二進制數據服務
- struct — Interpret bytes as packed binary data
- codecs — Codec registry and base classes
- 數據類型
- datetime — 基礎日期/時間數據類型
- calendar — General calendar-related functions
- collections — 容器數據類型
- collections.abc — 容器的抽象基類
- heapq — 堆隊列算法
- bisect — Array bisection algorithm
- array — Efficient arrays of numeric values
- weakref — 弱引用
- types — Dynamic type creation and names for built-in types
- copy — 淺層 (shallow) 和深層 (deep) 復制操作
- pprint — 數據美化輸出
- reprlib — Alternate repr() implementation
- enum — Support for enumerations
- 數字和數學模塊
- numbers — 數字的抽象基類
- math — 數學函數
- cmath — Mathematical functions for complex numbers
- decimal — 十進制定點和浮點運算
- fractions — 分數
- random — 生成偽隨機數
- statistics — Mathematical statistics functions
- 函數式編程模塊
- itertools — 為高效循環而創建迭代器的函數
- functools — 高階函數和可調用對象上的操作
- operator — 標準運算符替代函數
- 文件和目錄訪問
- pathlib — 面向對象的文件系統路徑
- os.path — 常見路徑操作
- fileinput — Iterate over lines from multiple input streams
- stat — Interpreting stat() results
- filecmp — File and Directory Comparisons
- tempfile — Generate temporary files and directories
- glob — Unix style pathname pattern expansion
- fnmatch — Unix filename pattern matching
- linecache — Random access to text lines
- shutil — High-level file operations
- macpath — Mac OS 9 路徑操作函數
- 數據持久化
- pickle —— Python 對象序列化
- copyreg — Register pickle support functions
- shelve — Python object persistence
- marshal — Internal Python object serialization
- dbm — Interfaces to Unix “databases”
- sqlite3 — SQLite 數據庫 DB-API 2.0 接口模塊
- 數據壓縮和存檔
- zlib — 與 gzip 兼容的壓縮
- gzip — 對 gzip 格式的支持
- bz2 — 對 bzip2 壓縮算法的支持
- lzma — 用 LZMA 算法壓縮
- zipfile — 在 ZIP 歸檔中工作
- tarfile — Read and write tar archive files
- 文件格式
- csv — CSV 文件讀寫
- configparser — Configuration file parser
- netrc — netrc file processing
- xdrlib — Encode and decode XDR data
- plistlib — Generate and parse Mac OS X .plist files
- 加密服務
- hashlib — 安全哈希與消息摘要
- hmac — 基于密鑰的消息驗證
- secrets — Generate secure random numbers for managing secrets
- 通用操作系統服務
- os — 操作系統接口模塊
- io — 處理流的核心工具
- time — 時間的訪問和轉換
- argparse — 命令行選項、參數和子命令解析器
- getopt — C-style parser for command line options
- 模塊 logging — Python 的日志記錄工具
- logging.config — 日志記錄配置
- logging.handlers — Logging handlers
- getpass — 便攜式密碼輸入工具
- curses — 終端字符單元顯示的處理
- curses.textpad — Text input widget for curses programs
- curses.ascii — Utilities for ASCII characters
- curses.panel — A panel stack extension for curses
- platform — Access to underlying platform's identifying data
- errno — Standard errno system symbols
- ctypes — Python 的外部函數庫
- 并發執行
- threading — 基于線程的并行
- multiprocessing — 基于進程的并行
- concurrent 包
- concurrent.futures — 啟動并行任務
- subprocess — 子進程管理
- sched — 事件調度器
- queue — 一個同步的隊列類
- _thread — 底層多線程 API
- _dummy_thread — _thread 的替代模塊
- dummy_threading — 可直接替代 threading 模塊。
- contextvars — Context Variables
- Context Variables
- Manual Context Management
- asyncio support
- 網絡和進程間通信
- asyncio — 異步 I/O
- socket — 底層網絡接口
- ssl — TLS/SSL wrapper for socket objects
- select — Waiting for I/O completion
- selectors — 高級 I/O 復用庫
- asyncore — 異步socket處理器
- asynchat — 異步 socket 指令/響應 處理器
- signal — Set handlers for asynchronous events
- mmap — Memory-mapped file support
- 互聯網數據處理
- email — 電子郵件與 MIME 處理包
- json — JSON 編碼和解碼器
- mailcap — Mailcap file handling
- mailbox — Manipulate mailboxes in various formats
- mimetypes — Map filenames to MIME types
- base64 — Base16, Base32, Base64, Base85 數據編碼
- binhex — 對binhex4文件進行編碼和解碼
- binascii — 二進制和 ASCII 碼互轉
- quopri — Encode and decode MIME quoted-printable data
- uu — Encode and decode uuencode files
- 結構化標記處理工具
- html — 超文本標記語言支持
- html.parser — 簡單的 HTML 和 XHTML 解析器
- html.entities — HTML 一般實體的定義
- XML處理模塊
- xml.etree.ElementTree — The ElementTree XML API
- xml.dom — The Document Object Model API
- xml.dom.minidom — Minimal DOM implementation
- xml.dom.pulldom — Support for building partial DOM trees
- xml.sax — Support for SAX2 parsers
- xml.sax.handler — Base classes for SAX handlers
- xml.sax.saxutils — SAX Utilities
- xml.sax.xmlreader — Interface for XML parsers
- xml.parsers.expat — Fast XML parsing using Expat
- 互聯網協議和支持
- webbrowser — 方便的Web瀏覽器控制器
- cgi — Common Gateway Interface support
- cgitb — Traceback manager for CGI scripts
- wsgiref — WSGI Utilities and Reference Implementation
- urllib — URL 處理模塊
- urllib.request — 用于打開 URL 的可擴展庫
- urllib.response — Response classes used by urllib
- urllib.parse — Parse URLs into components
- urllib.error — Exception classes raised by urllib.request
- urllib.robotparser — Parser for robots.txt
- http — HTTP 模塊
- http.client — HTTP協議客戶端
- ftplib — FTP protocol client
- poplib — POP3 protocol client
- imaplib — IMAP4 protocol client
- nntplib — NNTP protocol client
- smtplib —SMTP協議客戶端
- smtpd — SMTP Server
- telnetlib — Telnet client
- uuid — UUID objects according to RFC 4122
- socketserver — A framework for network servers
- http.server — HTTP 服務器
- http.cookies — HTTP state management
- http.cookiejar — Cookie handling for HTTP clients
- xmlrpc — XMLRPC 服務端與客戶端模塊
- xmlrpc.client — XML-RPC client access
- xmlrpc.server — Basic XML-RPC servers
- ipaddress — IPv4/IPv6 manipulation library
- 多媒體服務
- audioop — Manipulate raw audio data
- aifc — Read and write AIFF and AIFC files
- sunau — 讀寫 Sun AU 文件
- wave — 讀寫WAV格式文件
- chunk — Read IFF chunked data
- colorsys — Conversions between color systems
- imghdr — 推測圖像類型
- sndhdr — 推測聲音文件的類型
- ossaudiodev — Access to OSS-compatible audio devices
- 國際化
- gettext — 多語種國際化服務
- locale — 國際化服務
- 程序框架
- turtle — 海龜繪圖
- cmd — 支持面向行的命令解釋器
- shlex — Simple lexical analysis
- Tk圖形用戶界面(GUI)
- tkinter — Tcl/Tk的Python接口
- tkinter.ttk — Tk themed widgets
- tkinter.tix — Extension widgets for Tk
- tkinter.scrolledtext — 滾動文字控件
- IDLE
- 其他圖形用戶界面(GUI)包
- 開發工具
- typing — 類型標注支持
- pydoc — Documentation generator and online help system
- doctest — Test interactive Python examples
- unittest — 單元測試框架
- unittest.mock — mock object library
- unittest.mock 上手指南
- 2to3 - 自動將 Python 2 代碼轉為 Python 3 代碼
- test — Regression tests package for Python
- test.support — Utilities for the Python test suite
- test.support.script_helper — Utilities for the Python execution tests
- 調試和分析
- bdb — Debugger framework
- faulthandler — Dump the Python traceback
- pdb — The Python Debugger
- The Python Profilers
- timeit — 測量小代碼片段的執行時間
- trace — Trace or track Python statement execution
- tracemalloc — Trace memory allocations
- 軟件打包和分發
- distutils — 構建和安裝 Python 模塊
- ensurepip — Bootstrapping the pip installer
- venv — 創建虛擬環境
- zipapp — Manage executable Python zip archives
- Python運行時服務
- sys — 系統相關的參數和函數
- sysconfig — Provide access to Python's configuration information
- builtins — 內建對象
- main — 頂層腳本環境
- warnings — Warning control
- dataclasses — 數據類
- contextlib — Utilities for with-statement contexts
- abc — 抽象基類
- atexit — 退出處理器
- traceback — Print or retrieve a stack traceback
- future — Future 語句定義
- gc — 垃圾回收器接口
- inspect — 檢查對象
- site — Site-specific configuration hook
- 自定義 Python 解釋器
- code — Interpreter base classes
- codeop — Compile Python code
- 導入模塊
- zipimport — Import modules from Zip archives
- pkgutil — Package extension utility
- modulefinder — 查找腳本使用的模塊
- runpy — Locating and executing Python modules
- importlib — The implementation of import
- Python 語言服務
- parser — Access Python parse trees
- ast — 抽象語法樹
- symtable — Access to the compiler's symbol tables
- symbol — 與 Python 解析樹一起使用的常量
- token — 與Python解析樹一起使用的常量
- keyword — 檢驗Python關鍵字
- tokenize — Tokenizer for Python source
- tabnanny — 模糊縮進檢測
- pyclbr — Python class browser support
- py_compile — Compile Python source files
- compileall — Byte-compile Python libraries
- dis — Python 字節碼反匯編器
- pickletools — Tools for pickle developers
- 雜項服務
- formatter — Generic output formatting
- Windows系統相關模塊
- msilib — Read and write Microsoft Installer files
- msvcrt — Useful routines from the MS VC++ runtime
- winreg — Windows 注冊表訪問
- winsound — Sound-playing interface for Windows
- Unix 專有服務
- posix — The most common POSIX system calls
- pwd — 用戶密碼數據庫
- spwd — The shadow password database
- grp — The group database
- crypt — Function to check Unix passwords
- termios — POSIX style tty control
- tty — 終端控制功能
- pty — Pseudo-terminal utilities
- fcntl — The fcntl and ioctl system calls
- pipes — Interface to shell pipelines
- resource — Resource usage information
- nis — Interface to Sun's NIS (Yellow Pages)
- Unix syslog 庫例程
- 被取代的模塊
- optparse — Parser for command line options
- imp — Access the import internals
- 未創建文檔的模塊
- 平臺特定模塊
- 擴展和嵌入 Python 解釋器
- 推薦的第三方工具
- 不使用第三方工具創建擴展
- 使用 C 或 C++ 擴展 Python
- 自定義擴展類型:教程
- 定義擴展類型:已分類主題
- 構建C/C++擴展
- 在Windows平臺編譯C和C++擴展
- 在更大的應用程序中嵌入 CPython 運行時
- Embedding Python in Another Application
- Python/C API 參考手冊
- 概述
- 代碼標準
- 包含文件
- 有用的宏
- 對象、類型和引用計數
- 異常
- 嵌入Python
- 調試構建
- 穩定的應用程序二進制接口
- The Very High Level Layer
- Reference Counting
- 異常處理
- Printing and clearing
- 拋出異常
- Issuing warnings
- Querying the error indicator
- Signal Handling
- Exception Classes
- Exception Objects
- Unicode Exception Objects
- Recursion Control
- 標準異常
- 標準警告類別
- 工具
- 操作系統實用程序
- 系統功能
- 過程控制
- 導入模塊
- Data marshalling support
- 語句解釋及變量編譯
- 字符串轉換與格式化
- 反射
- 編解碼器注冊與支持功能
- 抽象對象層
- Object Protocol
- 數字協議
- Sequence Protocol
- Mapping Protocol
- 迭代器協議
- 緩沖協議
- Old Buffer Protocol
- 具體的對象層
- 基本對象
- 數值對象
- 序列對象
- 容器對象
- 函數對象
- 其他對象
- Initialization, Finalization, and Threads
- 在Python初始化之前
- 全局配置變量
- Initializing and finalizing the interpreter
- Process-wide parameters
- Thread State and the Global Interpreter Lock
- Sub-interpreter support
- Asynchronous Notifications
- Profiling and Tracing
- Advanced Debugger Support
- Thread Local Storage Support
- 內存管理
- 概述
- 原始內存接口
- Memory Interface
- 對象分配器
- 默認內存分配器
- Customize Memory Allocators
- The pymalloc allocator
- tracemalloc C API
- 示例
- 對象實現支持
- 在堆中分配對象
- Common Object Structures
- Type 對象
- Number Object Structures
- Mapping Object Structures
- Sequence Object Structures
- Buffer Object Structures
- Async Object Structures
- 使對象類型支持循環垃圾回收
- API 和 ABI 版本管理
- 分發 Python 模塊
- 關鍵術語
- 開源許可與協作
- 安裝工具
- 閱讀指南
- 我該如何...?
- ...為我的項目選擇一個名字?
- ...創建和分發二進制擴展?
- 安裝 Python 模塊
- 關鍵術語
- 基本使用
- 我應如何 ...?
- ... 在 Python 3.4 之前的 Python 版本中安裝 pip ?
- ... 只為當前用戶安裝軟件包?
- ... 安裝科學計算類 Python 軟件包?
- ... 使用并行安裝的多個 Python 版本?
- 常見的安裝問題
- 在 Linux 的系統 Python 版本上安裝
- 未安裝 pip
- 安裝二進制編譯擴展
- Python 常用指引
- 將 Python 2 代碼遷移到 Python 3
- 簡要說明
- 詳情
- 將擴展模塊移植到 Python 3
- 條件編譯
- 對象API的更改
- 模塊初始化和狀態
- CObject 替換為 Capsule
- 其他選項
- Curses Programming with Python
- What is curses?
- Starting and ending a curses application
- Windows and Pads
- Displaying Text
- User Input
- For More Information
- 實現描述器
- 摘要
- 定義和簡介
- 描述器協議
- 發起調用描述符
- 描述符示例
- Properties
- 函數和方法
- Static Methods and Class Methods
- 函數式編程指引
- 概述
- 迭代器
- 生成器表達式和列表推導式
- 生成器
- 內置函數
- itertools 模塊
- The functools module
- Small functions and the lambda expression
- Revision History and Acknowledgements
- 引用文獻
- 日志 HOWTO
- 日志基礎教程
- 進階日志教程
- 日志級別
- 有用的處理程序
- 記錄日志中引發的異常
- 使用任意對象作為消息
- 優化
- 日志操作手冊
- 在多個模塊中使用日志
- 在多線程中使用日志
- 使用多個日志處理器和多種格式化
- 在多個地方記錄日志
- 日志服務器配置示例
- 處理日志處理器的阻塞
- Sending and receiving logging events across a network
- Adding contextual information to your logging output
- Logging to a single file from multiple processes
- Using file rotation
- Use of alternative formatting styles
- Customizing LogRecord
- Subclassing QueueHandler - a ZeroMQ example
- Subclassing QueueListener - a ZeroMQ example
- An example dictionary-based configuration
- Using a rotator and namer to customize log rotation processing
- A more elaborate multiprocessing example
- Inserting a BOM into messages sent to a SysLogHandler
- Implementing structured logging
- Customizing handlers with dictConfig()
- Using particular formatting styles throughout your application
- Configuring filters with dictConfig()
- Customized exception formatting
- Speaking logging messages
- Buffering logging messages and outputting them conditionally
- Formatting times using UTC (GMT) via configuration
- Using a context manager for selective logging
- 正則表達式HOWTO
- 概述
- 簡單模式
- 使用正則表達式
- 更多模式能力
- 修改字符串
- 常見問題
- 反饋
- 套接字編程指南
- 套接字
- 創建套接字
- 使用一個套接字
- 斷開連接
- 非阻塞的套接字
- 排序指南
- 基本排序
- 關鍵函數
- Operator 模塊函數
- 升序和降序
- 排序穩定性和排序復雜度
- 使用裝飾-排序-去裝飾的舊方法
- 使用 cmp 參數的舊方法
- 其它
- Unicode 指南
- Unicode 概述
- Python's Unicode Support
- Reading and Writing Unicode Data
- Acknowledgements
- 如何使用urllib包獲取網絡資源
- 概述
- Fetching URLs
- 處理異常
- info and geturl
- Openers and Handlers
- Basic Authentication
- Proxies
- Sockets and Layers
- 腳注
- Argparse 教程
- 概念
- 基礎
- 位置參數介紹
- Introducing Optional arguments
- Combining Positional and Optional arguments
- Getting a little more advanced
- Conclusion
- ipaddress模塊介紹
- 創建 Address/Network/Interface 對象
- 審查 Address/Network/Interface 對象
- Network 作為 Address 列表
- 比較
- 將IP地址與其他模塊一起使用
- 實例創建失敗時獲取更多詳細信息
- Argument Clinic How-To
- The Goals Of Argument Clinic
- Basic Concepts And Usage
- Converting Your First Function
- Advanced Topics
- 使用 DTrace 和 SystemTap 檢測CPython
- Enabling the static markers
- Static DTrace probes
- Static SystemTap markers
- Available static markers
- SystemTap Tapsets
- 示例
- Python 常見問題
- Python常見問題
- 一般信息
- 現實世界中的 Python
- 編程常見問題
- 一般問題
- 核心語言
- 數字和字符串
- 性能
- 序列(元組/列表)
- 對象
- 模塊
- 設計和歷史常見問題
- 為什么Python使用縮進來分組語句?
- 為什么簡單的算術運算得到奇怪的結果?
- 為什么浮點計算不準確?
- 為什么Python字符串是不可變的?
- 為什么必須在方法定義和調用中顯式使用“self”?
- 為什么不能在表達式中賦值?
- 為什么Python對某些功能(例如list.index())使用方法來實現,而其他功能(例如len(List))使用函數實現?
- 為什么 join()是一個字符串方法而不是列表或元組方法?
- 異常有多快?
- 為什么Python中沒有switch或case語句?
- 難道不能在解釋器中模擬線程,而非得依賴特定于操作系統的線程實現嗎?
- 為什么lambda表達式不能包含語句?
- 可以將Python編譯為機器代碼,C或其他語言嗎?
- Python如何管理內存?
- 為什么CPython不使用更傳統的垃圾回收方案?
- CPython退出時為什么不釋放所有內存?
- 為什么有單獨的元組和列表數據類型?
- 列表是如何在CPython中實現的?
- 字典是如何在CPython中實現的?
- 為什么字典key必須是不可變的?
- 為什么 list.sort() 沒有返回排序列表?
- 如何在Python中指定和實施接口規范?
- 為什么沒有goto?
- 為什么原始字符串(r-strings)不能以反斜杠結尾?
- 為什么Python沒有屬性賦值的“with”語句?
- 為什么 if/while/def/class語句需要冒號?
- 為什么Python在列表和元組的末尾允許使用逗號?
- 代碼庫和插件 FAQ
- 通用的代碼庫問題
- 通用任務
- 線程相關
- 輸入輸出
- 網絡 / Internet 編程
- 數據庫
- 數學和數字
- 擴展/嵌入常見問題
- 可以使用C語言中創建自己的函數嗎?
- 可以使用C++語言中創建自己的函數嗎?
- C很難寫,有沒有其他選擇?
- 如何從C執行任意Python語句?
- 如何從C中評估任意Python表達式?
- 如何從Python對象中提取C的值?
- 如何使用Py_BuildValue()創建任意長度的元組?
- 如何從C調用對象的方法?
- 如何捕獲PyErr_Print()(或打印到stdout / stderr的任何內容)的輸出?
- 如何從C訪問用Python編寫的模塊?
- 如何從Python接口到C ++對象?
- 我使用Setup文件添加了一個模塊,為什么make失敗了?
- 如何調試擴展?
- 我想在Linux系統上編譯一個Python模塊,但是缺少一些文件。為什么?
- 如何區分“輸入不完整”和“輸入無效”?
- 如何找到未定義的g++符號__builtin_new或__pure_virtual?
- 能否創建一個對象類,其中部分方法在C中實現,而其他方法在Python中實現(例如通過繼承)?
- Python在Windows上的常見問題
- 我怎樣在Windows下運行一個Python程序?
- 我怎么讓 Python 腳本可執行?
- 為什么有時候 Python 程序會啟動緩慢?
- 我怎樣使用Python腳本制作可執行文件?
- *.pyd 文件和DLL文件相同嗎?
- 我怎樣將Python嵌入一個Windows程序?
- 如何讓編輯器不要在我的 Python 源代碼中插入 tab ?
- 如何在不阻塞的情況下檢查按鍵?
- 圖形用戶界面(GUI)常見問題
- 圖形界面常見問題
- Python 是否有平臺無關的圖形界面工具包?
- 有哪些Python的GUI工具是某個平臺專用的?
- 有關Tkinter的問題
- “為什么我的電腦上安裝了 Python ?”
- 什么是Python?
- 為什么我的電腦上安裝了 Python ?
- 我能刪除 Python 嗎?
- 術語對照表
- 文檔說明
- Python 文檔貢獻者
- 解決 Bug
- 文檔錯誤
- 使用 Python 的錯誤追蹤系統
- 開始為 Python 貢獻您的知識
- 版權
- 歷史和許可證
- 軟件歷史
- 訪問Python或以其他方式使用Python的條款和條件
- Python 3.7.3 的 PSF 許可協議
- Python 2.0 的 BeOpen.com 許可協議
- Python 1.6.1 的 CNRI 許可協議
- Python 0.9.0 至 1.2 的 CWI 許可協議
- 集成軟件的許可和認可
- Mersenne Twister
- 套接字
- Asynchronous socket services
- Cookie management
- Execution tracing
- UUencode and UUdecode functions
- XML Remote Procedure Calls
- test_epoll
- Select kqueue
- SipHash24
- strtod and dtoa
- OpenSSL
- expat
- libffi
- zlib
- cfuhash
- libmpdec