_thread
--- 底層多線程 API?
該模塊提供了操作多個(gè)線程(也被稱為 輕量級(jí)進(jìn)程 或 任務(wù))的底層原語 —— 多個(gè)控制線程共享全局?jǐn)?shù)據(jù)空間。為了處理同步問題,也提供了簡單的鎖機(jī)制(也稱為 互斥鎖 或 二進(jìn)制信號(hào))。threading
模塊基于該模塊提供了更易用的高級(jí)多線程 API。
在 3.7 版更改: 這個(gè)模塊曾經(jīng)為可選項(xiàng),但現(xiàn)在總是可用。
這個(gè)模塊定義了以下常量和函數(shù):
- exception _thread.error?
發(fā)生線程相關(guān)錯(cuò)誤時(shí)拋出。
在 3.3 版更改: 現(xiàn)在是內(nèi)建異常
RuntimeError
的別名。
- _thread.LockType?
鎖對(duì)象的類型。
- _thread.start_new_thread(function, args[, kwargs])?
開啟一個(gè)新線程并返回其標(biāo)識(shí)。 線程執(zhí)行函數(shù) function 并附帶參數(shù)列表 args (必須是元組)。 可選的 kwargs 參數(shù)指定一個(gè)關(guān)鍵字參數(shù)字典。
當(dāng)函數(shù)返回時(shí),線程會(huì)靜默地退出。
當(dāng)函數(shù)因某個(gè)未處理異常而終結(jié)時(shí),
sys.unraisablehook()
會(huì)被調(diào)用以處理異常。 鉤子參數(shù)的 object 屬性為 function。 在默認(rèn)情況下,會(huì)打印堆棧回溯然后該線程將退出(但其他線程會(huì)繼續(xù)運(yùn)行)。當(dāng)函數(shù)引發(fā)
SystemExit
異常時(shí),它會(huì)被靜默地忽略。在 3.8 版更改: 現(xiàn)在會(huì)使用
sys.unraisablehook()
來處理未處理的異常。
- _thread.interrupt_main(signum=signal.SIGINT, /)?
模擬一個(gè)信號(hào)到達(dá)主線程的效果。 線程可使用此函數(shù)來打斷主線程,雖然并不保證打斷將立即發(fā)生。
如果給出 signum,則表示要模擬的信號(hào)的編號(hào)。 如果未給出 signum,則將模擬
signal.SIGINT
。如果 Python 沒有處理給定的信號(hào) (它被設(shè)為
signal.SIG_DFL
或signal.SIG_IGN
),此函數(shù)將不做任何操作。在 3.10 版更改: 添加了 signum 參數(shù)來定制信號(hào)的編號(hào)。
備注
這并不會(huì)發(fā)出對(duì)應(yīng)的信號(hào)而是將一個(gè)調(diào)用排入關(guān)聯(lián)處理句柄的計(jì)劃任務(wù)(如果句柄存在的話)。 如果你想要真的發(fā)出信號(hào),請(qǐng)使用
signal.raise_signal()
。
- _thread.exit()?
拋出
SystemExit
異常。如果沒有捕獲的話,這個(gè)異常會(huì)使線程退出。
- _thread.allocate_lock()?
返回一個(gè)新的鎖對(duì)象。鎖中的方法在后面描述。初始情況下鎖處于解鎖狀態(tài)。
- _thread.get_ident()?
返回當(dāng)前線程的 “線程標(biāo)識(shí)符”。它是一個(gè)非零的整數(shù)。它的值沒有直接含義,主要是用作 magic cookie,比如作為含有線程相關(guān)數(shù)據(jù)的字典的索引。線程標(biāo)識(shí)符可能會(huì)在線程退出,新線程創(chuàng)建時(shí)被復(fù)用。
- _thread.get_native_id()?
返回內(nèi)核分配給當(dāng)前線程的原生集成線程 ID。 這是一個(gè)非負(fù)整數(shù)。 它的值可被用來在整個(gè)系統(tǒng)中唯一地標(biāo)識(shí)這個(gè)特定線程(直到線程終結(jié),在那之后該值可能會(huì)被 OS 回收再利用)。
Availability: Windows, FreeBSD, Linux, macOS, OpenBSD, NetBSD, AIX, DragonFlyBSD.
3.8 新版功能.
- _thread.stack_size([size])?
返回創(chuàng)建線程時(shí)使用的堆棧大小??蛇x參數(shù) size 指定之后新建的線程的堆棧大小,而且一定要是0(根據(jù)平臺(tái)或者默認(rèn)配置)或者最小是32,768(32KiB)的一個(gè)正整數(shù)。如果 size 沒有指定,默認(rèn)是0。如果不支持改變線程堆棧大小,會(huì)拋出
RuntimeError
錯(cuò)誤。如果指定的堆棧大小不合法,會(huì)拋出ValueError
錯(cuò)誤并且不會(huì)修改堆棧大小。32KiB是當(dāng)前最小的能保證解釋器有足夠堆棧空間的堆棧大小。需要注意的是部分平臺(tái)對(duì)于堆棧大小會(huì)有特定的限制,例如要求大于32KiB的堆棧大小或者需要根據(jù)系統(tǒng)內(nèi)存頁面的整數(shù)倍進(jìn)行分配 - 應(yīng)當(dāng)查閱平臺(tái)文檔有關(guān)詳細(xì)信息(4KiB頁面比較普遍,在沒有更具體信息的情況下,建議的方法是使用4096的倍數(shù)作為堆棧大?。?/p>適用于: Windows,具有 POSIX 線程的系統(tǒng)。
- _thread.TIMEOUT_MAX?
Lock.acquire()
方法中 timeout 參數(shù)允許的最大值。傳入超過這個(gè)值的 timeout 會(huì)拋出OverflowError
異常。3.2 新版功能.
鎖對(duì)象有以下方法:
- lock.acquire(waitflag=1, timeout=- 1)?
沒有任何可選參數(shù)時(shí),該方法無條件申請(qǐng)獲得鎖,有必要的話會(huì)等待其他線程釋放鎖(同時(shí)只有一個(gè)線程能獲得鎖 —— 這正是鎖存在的原因)。
如果傳入了整型參數(shù) waitflag,具體的行為取決于傳入的值:如果是 0 的話,只會(huì)在能夠立刻獲取到鎖時(shí)才獲取,不會(huì)等待,如果是非零的話,會(huì)像之前提到的一樣,無條件獲取鎖。
如果傳入正浮點(diǎn)數(shù)參數(shù) timeout,相當(dāng)于指定了返回之前等待得最大秒數(shù)。如果傳入負(fù)的 timeout,相當(dāng)于無限期等待。如果 waitflag 是 0 的話,不能指定 timeout。
如果成功獲取到所會(huì)返回
True
,否則返回False
。在 3.2 版更改: 新的 timeout 形參。
在 3.2 版更改: 現(xiàn)在獲取鎖的操作可以被 POSIX 信號(hào)中斷。
- lock.release()?
釋放鎖。鎖必須已經(jīng)被獲取過,但不一定是同一個(gè)線程獲取的。
- lock.locked()?
返回鎖的狀態(tài):如果已被某個(gè)線程獲取,返回
True
,否則返回False
。
除了這些方法之外,鎖對(duì)象也可以通過 with
語句使用,例如:
import _thread
a_lock = _thread.allocate_lock()
with a_lock:
print("a_lock is locked while this executes")
注意事項(xiàng):
線程與中斷奇怪地交互:
KeyboardInterrupt
異常可能會(huì)被任意一個(gè)線程捕獲。(如果signal
模塊可用的話,中斷總是會(huì)進(jìn)入主線程。)調(diào)用
sys.exit()
或是拋出SystemExit
異常等效于調(diào)用_thread.exit()
。不可能中斷鎖的
acquire()
方法 ——KeyboardInterrupt
一場會(huì)在鎖獲取到之后發(fā)生。當(dāng)主線程退出時(shí),由系統(tǒng)決定其他線程是否存活。在大多數(shù)系統(tǒng)中,這些線程會(huì)直接被殺掉,不會(huì)執(zhí)行
try
...finally
語句,也不會(huì)執(zhí)行對(duì)象析構(gòu)函數(shù)。當(dāng)主線程退出時(shí),不會(huì)進(jìn)行正常的清理工作(除非使用了
try
...finally
語句),標(biāo)準(zhǔn) I/O 文件也不會(huì)刷新。