Exceptions and error codes
=====================================================


List of all exceptions
----------------------

This section lists all available exceptions in alphabetical order.

.. autoclass:: ubuiltins.ArithmeticError
    :no-members:

.. autoclass:: ubuiltins.AssertionError
    :no-members:

.. autoclass:: ubuiltins.AttributeError
    :no-members:

.. autoclass:: ubuiltins.BaseException
    :no-members:

.. autoclass:: ubuiltins.EOFError
    :no-members:

.. autoclass:: ubuiltins.Exception
    :no-members:

.. autoclass:: ubuiltins.GeneratorExit
    :no-members:

.. autoclass:: ubuiltins.ImportError
    :no-members:

.. autoclass:: ubuiltins.IndentationError
    :no-members:

.. autoclass:: ubuiltins.IndexError
    :no-members:

.. autoclass:: ubuiltins.KeyboardInterrupt
    :no-members:

.. autoclass:: ubuiltins.KeyError
    :no-members:

.. autoclass:: ubuiltins.LookupError
    :no-members:

.. autoclass:: ubuiltins.MemoryError
    :no-members:

.. autoclass:: ubuiltins.NameError
    :no-members:

.. autoclass:: ubuiltins.NotImplementedError
    :no-members:

.. autoclass:: ubuiltins.OSError
    :noindex:

    See the `OSError`_ section for additional details.

.. autoclass:: ubuiltins.OverflowError
    :no-members:

.. autoclass:: ubuiltins.RuntimeError
    :no-members:

.. autoclass:: ubuiltins.StopIteration
    :no-members:

.. autoclass:: ubuiltins.SyntaxError
    :no-members:

.. autoclass:: ubuiltins.SystemExit
    :no-members:

.. autoclass:: ubuiltins.TypeError
    :no-members:

.. autoclass:: ubuiltins.ValueError
    :no-members:

.. autoclass:: ubuiltins.ZeroDivisionError
    :no-members:

.. _OSError:

Using ``OSError`` with :mod:`uerrno`
------------------------------------

The ``errno`` attribute of an ``OSError`` indicates why the exception was
raised. This attribute has one of the following values, which can be imported
from the ``uerrno`` module. See also :ref:`this example <device_detection>`.

.. module:: uerrno

.. autodata:: uerrno.EAGAIN

.. autodata:: uerrno.EBUSY

.. autodata:: uerrno.ECANCELED

.. autodata:: uerrno.EINVAL

.. autodata:: uerrno.EIO

.. autodata:: uerrno.ENODEV

.. autodata:: uerrno.EOPNOTSUPP

.. autodata:: uerrno.EPERM

.. autodata:: uerrno.ETIMEDOUT

.. autodata:: uerrno.errorcode

Examples
---------------------

Debugging in the REPL terminal
*****************************************

.. literalinclude::
    ../../../examples/micropython/keyboard_interrupt.py

Running code when the stop button is pressed
********************************************

.. literalinclude::
    ../../../examples/micropython/system_exit.py

.. _device_detection:

Detecting devices using ``OSError``
*****************************************

.. literalinclude::
    ../../../examples/micropython/oserror.py