Python 技術手冊 第三版

536

|

第 16 章　測試、除錯和最佳化

resetwarnings resetwarnings()

從過濾器串列移除所有的過濾器。

resetwarnings

也會捨棄原本以

-W

命令列選項新增的任何過濾器。

showwarning showwarning(message,category,filename,lineno,file=sys.stderr)

輸出給定的警告到給定的檔案物件。輸出警告的過濾器動作

（actions）會呼叫

showwarning

，並讓引數

file

預設為

sys.stderr

。

要改變過濾器動作輸出警告時會發生什麼事，就編寫你自己的，

帶有這個特徵式（signature）的函式，並將之繫結至

warnings.

showwarning

，覆寫預設的實作。

warn warn(message,category=UserWarning,stacklevel=1)

送出一個警告，以讓過濾器檢視並條件式地輸出之。如果

stacklevel

為

1

，警告的位置就是目前的函式（

warn

的呼叫者），如果

stacklevel

為

2

，就為目前函式的呼叫者。因此，傳入

2

作為

stacklevel

的值能

讓你撰寫代表它們的呼叫者送出警告的函式，例如：

def toUnicode(bytestr):

try:

return bytestr.decode()

except UnicodeError:

warnings.warn(

'Invalid characters in {}'.format(bytestr),