内置异常 ¶

基类 ¶

以下异常主要用作其它异常的基类。

exception BaseException ¶

The base class for all built-in exceptions. It is not meant to be directly inherited by user-defined classes (for that, use Exception )。若 str() is called on an instance of this class, the representation of the argument(s) to the instance are returned, or the empty string when there were no arguments.

args ¶

The tuple of arguments given to the exception constructor. Some built-in exceptions (like OSError ) expect a certain number of arguments and assign a special meaning to the elements of this tuple, while others are usually called only with a single string giving an error message.

with_traceback ( tb ) ¶

此方法设置 tb as the new traceback for the exception and returns the exception object. It is usually used in exception handling code like this:

try:
    ...
except SomeException:
    tb = sys.exc_info()[2]
    raise OtherException(...).with_traceback(tb)
												

exception Exception ¶

所有内置、非系统退出异常都派生自此类。所有用户定义异常也应派生自此类。

exception ArithmeticError ¶

The base class for those built-in exceptions that are raised for various arithmetic errors: OverflowError , ZeroDivisionError , FloatingPointError .

exception BufferError ¶

被引发当 buffer 相关操作无法履行。

exception LookupError ¶

The base class for the exceptions that are raised when a key or index used on a mapping or sequence is invalid: IndexError , KeyError . This can be raised directly by codecs.lookup() .

具体异常 ¶

以下异常是通常引发的异常。

exception AssertionError ¶

被引发当 assert 语句失败。

exception AttributeError ¶

被引发当属性引用 (见 属性引用 ) 或赋值失败。(当对象根本不支持属性引用或属性赋值时， TypeError 被引发。)

exception EOFError ¶

被引发当 input() function hits an end-of-file condition (EOF) without reading any data. (N.B.: the io.IOBase.read() and io.IOBase.readline() methods return an empty string when they hit EOF.)

exception FloatingPointError ¶

目前不使用。

exception GeneratorExit ¶

被引发当 generator or 协程 被关闭；见 generator.close() and coroutine.close() . It directly inherits from BaseException 而不是 Exception since it is technically not an error.

exception ImportError ¶

被引发当 import statement has troubles trying to load a module. Also raised when the “from list” in from ... import has a name that cannot be found.

name and path attributes can be set using keyword-only arguments to the constructor. When set they represent the name of the module that was attempted to be imported and the path to any file which triggered the exception, respectively.

3.3 版改变： 添加 name and path 属性。

exception ModuleNotFoundError ¶

子类化的 ImportError 其被引发通过 import when a module could not be located. It is also raised when None is found in sys.modules .

3.6 版新增。

exception IndexError ¶

Raised when a sequence subscript is out of range. (Slice indices are silently truncated to fall in the allowed range; if an index is not an integer, TypeError 被引发。)

exception KeyError ¶

被引发当在现有键集中找不到映射 (字典) 键时。

exception KeyboardInterrupt ¶

被引发当用户命中中断键时 (通常 Control-C or Delete ). During execution, a check for interrupts is made regularly. The exception inherits from BaseException so as to not be accidentally caught by code that catches Exception and thus prevent the interpreter from exiting.

exception MemoryError ¶

Raised when an operation runs out of memory but the situation may still be rescued (by deleting some objects). The associated value is a string indicating what kind of (internal) operation ran out of memory. Note that because of the underlying memory management architecture (C’s malloc() function), the interpreter may not always be able to completely recover from this situation; it nevertheless raises an exception so that a stack traceback can be printed, in case a run-away program was the cause.

exception NameError ¶

Raised when a local or global name is not found. This applies only to unqualified names. The associated value is an error message that includes the name that could not be found.

exception NotImplementedError ¶

此异常派生自 RuntimeError 。在用户定义的基类中，抽象方法应引发此异常当它们要求派生类覆盖方法时，或者当在开发类指示仍然需要添加真正实现时。

注意

它不应该被用于指示意味着根本不支持的运算符 (或方法) – 在这种情况下，要么不定义运算符 (或方法)，要么若是子类，则将它设为 None .

注意

NotImplementedError and NotImplemented 不可互换，即使它们拥有相似的名称和用途。见 NotImplemented 了解当使用它时的有关细节。

exception OSError ( [ arg ] ) ¶

exception OSError ( errno , strerror [ , filename [ , winerror [ , filename2 ] ] ] )

此异常被引发当系统函数返回系统相关错误时，包括 I/O 故障，譬如 file not found 或 disk full (不针对非法自变量类型或其它偶然错误)。

构造函数的第 2 种形式设置相应属性，描述见下文。属性默认为 None 若未指定。为向后兼容，若有传递 3 个自变量， args 属性是包含仅前 2 构造函数自变量的二元组。

构造函数经常实际返回子类化的 OSError ，作为描述在 OS 异常 下文。特定子类从属最终 errno 值。此行为才发生当构造 OSError 直接或凭借别名，且不被继承当子类化时。

errno ¶

数值错误代码来自 C 变量 errno .

winerror ¶

在 Windows，这给出本机 Windows 错误代码。 errno 属性那么是按 POSIX 术语的本机错误代码的近似翻译。

在 Windows，若 winerror 构造函数自变量是整数， errno 属性由 Windows 错误代码确定，和 errno 自变量被忽略。在其它平台， winerror 自变量被忽略，和 winerror 属性不存在。

strerror ¶

相应的错误消息，由操作系统提供。它被格式化由 C 函数 perror() 在 POSIX (便携式操作系统接口)，和 FormatMessage() 在 Windows。

filename ¶

filename2 ¶

对于涉及文件系统路径的异常 (譬如 open() or os.unlink() ), filename 是传递给函数的文件名。对于涉及 2 个文件系统路径的函数 (譬如 os.rename() ), filename2 相当于传递给函数的第 2 文件名。

3.3 版改变： EnvironmentError , IOError , WindowsError , socket.error , select.error and mmap.error 已合并成 OSError ，且构造函数可能返回子类。

3.4 版改变： filename 属性现在是传递给函数的原始文件名，而不是编码到或解码自文件系统编码的名称。另外， filename2 构造函数自变量和属性被添加。

exception OverflowError ¶

被引发当算术运算的结果太大不能表示时。这不会发生对于整数 (其宁愿引发 MemoryError 而不是放弃)。不管怎样，由于历史原因，有时会为超出要求范围的整数引发 OverflowError。因为 C 缺乏浮点异常处理的标准化，所以大多数浮点运算都不校验。

exception RecursionError ¶

此异常派生自 RuntimeError 。它被引发当解释器检测到最大递归深度时 (见 sys.getrecursionlimit() ) is exceeded.

3.5 版新增： 先前，纯 RuntimeError 被引发。

exception ReferenceError ¶

此异常被引发当弱引用代理时，创建通过 weakref.proxy() 函数，用于访问所指属性在它被垃圾收集之后。有关弱引用的更多信息，见 weakref 模块。

exception RuntimeError ¶

被引发当错误被检测到不属于任何其它类别时。关联值是准确指示哪里出错的字符串。

exception StopIteration ¶

被引发通过内置函数 next() 和 iterator ’s __next__() 方法以发出迭代器没有进一步项产生的信号。

异常对象拥有单属性 value ，其作为自变量给出当构造异常时，且默认为 None .

当 generator or 协程 函数返回，新的 StopIteration 实例被引发，且由函数返回的值被用作 value 参数到异常的构造函数。

若生成器代码直接 (或间接) 引发 StopIteration ，它被转换成 RuntimeError (保留 StopIteration 作为新异常的原因)。

3.3 版改变： 添加 value 属性和用于生成器函数的能力以使用它来返回值。

3.5 版改变： 引入 RuntimeError 变换凭借 from __future__ import generator_stop ，见 PEP 479 .

3.7 版改变： 启用 PEP 479 对于默认情况下的所有代码： StopIteration 在生成器中引发的错误被变换成 RuntimeError .

exception StopAsyncIteration ¶

必须被引发通过 __anext__() 方法对于 异步迭代器 对象以停止迭代。

3.5 版新增。

exception SyntaxError ( message , details ) ¶

被引发当剖析器遇到句法错误时。这可能发生在 import 语句，在调用内置函数 compile() , exec() ，或 eval() ，或当读取初始脚本或标准输入 (也交互) 时。

str() 为异常实例仅返回错误消息。详细信息是其成员还可用作单独属性的元组。

filename ¶

发生句法错误的文件名。

lineno ¶

Which line number in the file the error occurred in. This is 1-indexed: the first line in the file has a lineno of 1.

offset ¶

The column in the line where the error occurred. This is 1-indexed: the first character in the line has an offset of 1.

text ¶

错误中涉及的源代码文本。

For errors in f-string fields, the message is prefixed by “f-string: ” and the offsets are offsets in a text constructed from the replacement expression. For example, compiling f’Bad {a b} field’ results in this args attribute: (‘f-string: …’, (‘’, 1, 4, ‘(a b)n’)).

exception IndentationError ¶

Base class for syntax errors related to incorrect indentation. This is a subclass of SyntaxError .

exception TabError ¶

Raised when indentation contains an inconsistent use of tabs and spaces. This is a subclass of IndentationError .

exception SystemError ¶

Raised when the interpreter finds an internal error, but the situation does not look so serious to cause it to abandon all hope. The associated value is a string indicating what went wrong (in low-level terms).

You should report this to the author or maintainer of your Python interpreter. Be sure to report the version of the Python interpreter ( sys.version ; it is also printed at the start of an interactive Python session), the exact error message (the exception’s associated value) and if possible the source of the program that triggered the error.

exception SystemExit ¶

此异常被引发通过 sys.exit() 函数。它继承自 BaseException 而不是 Exception so that it is not accidentally caught by code that catches Exception . This allows the exception to properly propagate up and cause the interpreter to exit. When it is not handled, the Python interpreter exits; no stack traceback is printed. The constructor accepts the same optional argument passed to sys.exit() . If the value is an integer, it specifies the system exit status (passed to C’s exit() function); if it is None , the exit status is zero; if it has another type (such as a string), the object’s value is printed and the exit status is one.

调用 sys.exit() is translated into an exception so that clean-up handlers ( finally clauses of try statements) can be executed, and so that a debugger can execute a script without running the risk of losing control. The os._exit() function can be used if it is absolutely positively necessary to exit immediately (for example, in the child process after a call to os.fork() ).

code ¶

传递给构造函数的退出状态或错误消息。(默认为 None .)

exception TypeError ¶

被引发当操作 (或函数) 被应用于不适当类型的对象时。关联值是字符串，给出类型不匹配的有关细节。

此异常可能由用户代码引发，以指示不支持且不意味着支持对象所尝试的操作。若对象意味着支持给定操作但尚未提供实现， NotImplementedError 是要引发的适当异常。

Passing arguments of the wrong type (e.g. passing a list when an int is expected) should result in a TypeError , but passing arguments with the wrong value (e.g. a number outside expected boundaries) should result in a ValueError .

exception UnboundLocalError ¶

Raised when a reference is made to a local variable in a function or method, but no value has been bound to that variable. This is a subclass of NameError .

exception UnicodeError ¶

被引发当发生 Unicode 相关编码或解码错误时。它是子类化的 ValueError .

UnicodeError 拥有描述编码 (或解码) 错误的属性。例如， err.object[err.start:err.end] gives the particular invalid input that the codec failed on.

encoding ¶

引发错误的编码名称。

reason ¶

描述特定编解码器错误的字符串。

object ¶

试图编码 (或解码) 的编解码器对象。

start ¶

无效数据的第一索引在 object .

end ¶

最后无效数据之后的索引在 object .

exception UnicodeEncodeError ¶

Raised when a Unicode-related error occurs during encoding. It is a subclass of UnicodeError .

exception UnicodeDecodeError ¶

Raised when a Unicode-related error occurs during decoding. It is a subclass of UnicodeError .

exception UnicodeTranslateError ¶

Raised when a Unicode-related error occurs during translating. It is a subclass of UnicodeError .

exception ValueError ¶

被引发当操作 (或函数) 收到类型正确但值不合适的自变量，且未按更精确异常描述这种情况，譬如 IndexError .

exception ZeroDivisionError ¶

被引发当除法 (或模) 运算的第 2 自变量为 0。关联值是指示操作数和运算类型的字符串。

保留下列异常是为兼容先前版本；从 Python 3.3 开始，它们是别名化的 OSError .

exception EnvironmentError ¶

exception IOError ¶

exception WindowsError ¶

只可用于 Windows。

警告 ¶

The following exceptions are used as warning categories; see the 警告类别 文档编制了解更多细节。

exception Warning ¶

警告类别的基类。

exception UserWarning ¶

Base class for warnings generated by user code.

exception DeprecationWarning ¶

Base class for warnings about deprecated features when those warnings are intended for other Python developers.

Ignored by the default warning filters, except in the __main__ 模块 ( PEP 565 ). Enabling the Python 开发模式 展示此警告。

exception PendingDeprecationWarning ¶

Base class for warnings about features which are obsolete and expected to be deprecated in the future, but are not deprecated at the moment.

This class is rarely used as emitting a warning about a possible upcoming deprecation is unusual, and DeprecationWarning is preferred for already active deprecations.

Ignored by the default warning filters. Enabling the Python 开发模式 展示此警告。

exception SyntaxWarning ¶

Base class for warnings about dubious syntax.

exception RuntimeWarning ¶

Base class for warnings about dubious runtime behavior.

exception FutureWarning ¶

Base class for warnings about deprecated features when those warnings are intended for end users of applications that are written in Python.

exception ImportWarning ¶

Base class for warnings about probable mistakes in module imports.

Ignored by the default warning filters. Enabling the Python 开发模式 展示此警告。

exception UnicodeWarning ¶

Base class for warnings related to Unicode.

exception BytesWarning ¶

Base class for warnings related to bytes and bytearray .

exception ResourceWarning ¶

Base class for warnings related to resource usage.

Ignored by the default warning filters. Enabling the Python 开发模式 展示此警告。

3.2 版新增。

异常层次结构 ¶

内置异常的类层次结构：

BaseException
 +-- SystemExit
 +-- KeyboardInterrupt
 +-- GeneratorExit
 +-- Exception
      +-- StopIteration
      +-- StopAsyncIteration
      +-- ArithmeticError
      |    +-- FloatingPointError
      |    +-- OverflowError
      |    +-- ZeroDivisionError
      +-- AssertionError
      +-- AttributeError
      +-- BufferError
      +-- EOFError
      +-- ImportError
      |    +-- ModuleNotFoundError
      +-- LookupError
      |    +-- IndexError
      |    +-- KeyError
      +-- MemoryError
      +-- NameError
      |    +-- UnboundLocalError
      +-- OSError
      |    +-- BlockingIOError
      |    +-- ChildProcessError
      |    +-- ConnectionError
      |    |    +-- BrokenPipeError
      |    |    +-- ConnectionAbortedError
      |    |    +-- ConnectionRefusedError
      |    |    +-- ConnectionResetError
      |    +-- FileExistsError
      |    +-- FileNotFoundError
      |    +-- InterruptedError
      |    +-- IsADirectoryError
      |    +-- NotADirectoryError
      |    +-- PermissionError
      |    +-- ProcessLookupError
      |    +-- TimeoutError
      +-- ReferenceError
      +-- RuntimeError
      |    +-- NotImplementedError
      |    +-- RecursionError
      +-- SyntaxError
      |    +-- IndentationError
      |         +-- TabError
      +-- SystemError
      +-- TypeError
      +-- ValueError
      |    +-- UnicodeError
      |         +-- UnicodeDecodeError
      |         +-- UnicodeEncodeError
      |         +-- UnicodeTranslateError
      +-- Warning
           +-- DeprecationWarning
           +-- PendingDeprecationWarning
           +-- RuntimeWarning
           +-- SyntaxWarning
           +-- UserWarning
           +-- FutureWarning
           +-- ImportWarning
           +-- UnicodeWarning
           +-- BytesWarning
           +-- ResourceWarning