exceptions
 

Class based built-in exception hierarchy.

New with Python 1.5, all standard built-in exceptions are now class objects by
default.  This gives Python's exception handling mechanism a more
object-oriented feel.  Traditionally they were string objects.  Python will
fallback to string based exceptions if the interpreter is invoked with the -X
option, or if some failure occurs during class exception initialization (in
this case a warning will be printed).

Most existing code should continue to work with class based exceptions.  Some
tricky uses of IOError may break, but the most common uses should work.

Here is a rundown of the class hierarchy.  You can change this by editing this
file, but it isn't recommended because the old string based exceptions won't
be kept in sync.  The class names described here are expected to be found by
the bltinmodule.c file.  If you add classes here, you must modify
bltinmodule.c or the exceptions won't be available in the __builtin__ module,
nor will they be accessible from C.

The classes with a `*' are new since Python 1.5.  They are defined as tuples
containing the derived exceptions when string-based exceptions are used.  If
you define your own class based exceptions, they should be derived from
Exception.

Exception(*)
 |
 +-- SystemExit
 +-- StandardError(*)
      |
      +-- KeyboardInterrupt
      +-- ImportError
      +-- EnvironmentError(*)
      |    |
      |    +-- IOError
      |    +-- OSError(*)
      |
      +-- EOFError
      +-- RuntimeError
      |    |
      |    +-- NotImplementedError(*)
      |
      +-- NameError
      +-- AttributeError
      +-- SyntaxError
      +-- TypeError
      +-- AssertionError
      +-- LookupError(*)
      |    |
      |    +-- IndexError
      |    +-- KeyError
      |
      +-- ArithmeticError(*)
      |    |
      |    +-- OverflowError
      |    +-- ZeroDivisionError
      |    +-- FloatingPointError
      |
      +-- ValueError
      +-- SystemError
      +-- MemoryError


 Classes
                                                                                                                                                                                                                               
Exception
StandardError
ArithmeticError
FloatingPointError
OverflowError
ZeroDivisionError
AssertionError
AttributeError
EOFError
EnvironmentError
IOError
OSError
ImportError
KeyboardInterrupt
LookupError
IndexError
KeyError
MemoryError
NameError
RuntimeError
NotImplementedError
SyntaxError
SystemError
TypeError
ValueError
SystemExit


 class ArithmeticError(StandardError)
           Base class for arithmetic errors.
 
                                                                                                                                                                                                                     


 class AssertionError(StandardError)
           Assertion failed.
 
                                                                                                                                                                                                                     


 class AttributeError(StandardError)
           Attribute not found.
 
                                                                                                                                                                                                                     


 class EOFError(StandardError)
           Read beyond end of file.
 
                                                                                                                                                                                                                     


 class EnvironmentError(StandardError)
           Base class for I/O related errors.
 
                                                                                                                                                                                                                     
__init__(self, *args)
no doc string
__str__(self)
no doc string


 class Exception
           Proposed base class for all exceptions.
 
                                                                                                                                                                                                                     
__getitem__(self, i)
no doc string
__init__(self, *args)
no doc string
__str__(self)
no doc string


 class FloatingPointError(ArithmeticError)
           Floating point operation failed.
 
                                                                                                                                                                                                                     


 class IOError(EnvironmentError)
           I/O operation failed.
 
                                                                                                                                                                                                                     


 class ImportError(StandardError)
           Import can't find module, or can't find name in module.
 
                                                                                                                                                                                                                     


 class IndexError(LookupError)
           Sequence index out of range.
 
                                                                                                                                                                                                                     


 class KeyError(LookupError)
           Mapping key not found.
 
                                                                                                                                                                                                                     


 class KeyboardInterrupt(StandardError)
           Program interrupted by user.
 
                                                                                                                                                                                                                     


 class LookupError(StandardError)
           Base class for lookup errors.
 
                                                                                                                                                                                                                     


 class MemoryError(StandardError)
           Out of memory.
 
                                                                                                                                                                                                                     


 class NameError(StandardError)
           Name not found locally or globally.
 
                                                                                                                                                                                                                     


 class NotImplementedError(RuntimeError)
           Method or function hasn't been implemented yet.
 
                                                                                                                                                                                                                     


 class OSError(EnvironmentError)
           OS system call failed.
 
                                                                                                                                                                                                                     


 class OverflowError(ArithmeticError)
           Result too large to be represented.
 
                                                                                                                                                                                                                     


 class RuntimeError(StandardError)
           Unspecified run-time error.
 
                                                                                                                                                                                                                     


 class StandardError(Exception)
           Base class for all standard Python exceptions.
 
                                                                                                                                                                                                                     


 class SyntaxError(StandardError)
           Invalid syntax.
 
                                                                                                                                                                                                                     
__init__(self, *args)
no doc string
__str__(self)
no doc string


 class SystemError(StandardError)
           Internal error in the Python interpreter.

Please report this to the Python maintainer, along with the traceback,
the Python version, and the hardware/OS platform and version.
 
                                                                                                                                                                                                                     


 class SystemExit(Exception)
           Request to exit from the interpreter.
 
                                                                                                                                                                                                                     
__init__(self, *args)
no doc string


 class TypeError(StandardError)
           Inappropriate argument type.
 
                                                                                                                                                                                                                     


 class ValueError(StandardError)
           Inappropriate argument value (of correct type).
 
                                                                                                                                                                                                                     


 class ZeroDivisionError(ArithmeticError)
           Second argument to a division or modulo operation was zero.