sched
模組內容很簡單,只定義了一個類別。它用來最為一個通用的事件調度模組。
class sched.scheduler(timefunc, delayfunc)
這個類別定義了調度事件的通用接口,它需要外部傳入兩個參數,timefunc
是一個沒有參數的傳回時間型數的函數(常用使用的如time模組裡面的time),delayfunc
應該是一個需要一個參數來呼叫、與timefunc的輸出相容、並且作用為延遲多個時間單位的函數(常用的如time模組的sleep)。
下面是一個列子:
1 2 3 4 5 6 |
|
看到的輸出結果,隔5秒中執行第一個事件,隔10秒後執行第二個事件:
1 |
|
在多執行緒場景中,會有執行緒安全性問題,run()函數會阻塞主執行緒。官方建議使用threading.Timer
類別來取代:
1 2 3 4 5 |
|
scheduler物件擁有以下這些方法或屬性:
#scheduler.enterabs(time, priority, action, argument)
加入一個事件,time
參數應該是一個與傳遞給建構函式的 timefunc
函數的傳回值相容的數值類型。在同一時間到達的事件將按照priority
順序執行。
執行事件其實就是執行action(argument)
。 argument必須是一個包含action
參數的序列。
傳回值是一個事件,它可以用於稍後取消事件(請參閱cancel()
)。
scheduler.enter(delay, priority, action, argument)
安排一個事件來延遲delay
個時間單位。除了時間外,其他參數、意義和傳回值與enterabs()
的值相同。其實內部enterabs
就是用來被enter
呼叫。
scheduler.cancel(event)
# 從佇列中刪除事件。如果事件不是目前佇列中的事件,則該方法將執行一個ValueError
。
scheduler.empty()
# 判斷佇列是否為空。
scheduler.run()
運行所有預定的事件。這個函數將等待(使用傳遞給建構函式的delayfunc()
函數),然後執行事件,直到不再有預定的事件。
任何action
或delayfunc
都可以引發例外。在這兩種情況下,調度器將保持一個一致的狀態並傳播異常。如果一個異常是由action
引起的,就不會再繼續執行run()
。
scheduler.queue
# 只讀屬性,傳回一個即將到達的事件清單(按到達事件排序),每個事件都是有time
、priority
、action
、argument
組成的namedtuple
。
以上是Python標準庫之sched模組介紹的詳細內容。更多資訊請關注PHP中文網其他相關文章!