circuitpython/docs/library/errno.rst

Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.

34 lines
899 B
ReStructuredText
Raw Normal View History

2021-05-06 19:21:58 -04:00
:mod:`errno` -- system error codes
2017-07-02 17:55:09 -04:00
===================================
2021-05-06 19:21:58 -04:00
.. module:: errno
2017-07-02 17:55:09 -04:00
:synopsis: system error codes
|see_cpython_module| :mod:`python:errno`.
This module provides access to symbolic error codes for `OSError` exception.
The codes available may vary per CircuitPython build.
2017-07-02 17:55:09 -04:00
Constants
---------
.. data:: EEXIST, EAGAIN, etc.
Error codes, based on ANSI C/POSIX standard. All error codes start with
"E". Errors are usually accessible as ``exc.errno``
2017-12-03 08:50:37 -05:00
where ``exc`` is an instance of `OSError`. Usage example::
2017-07-02 17:55:09 -04:00
try:
2021-05-06 19:21:58 -04:00
os.mkdir("my_dir")
2017-07-02 17:55:09 -04:00
except OSError as exc:
if exc.errno == errno.EEXIST:
2017-07-02 17:55:09 -04:00
print("Directory already exists")
.. data:: errorcode
Dictionary mapping numeric error codes to strings with symbolic error
code (see above)::
2021-05-06 19:21:58 -04:00
>>> print(errno.errorcode[errno.EEXIST])
2017-07-02 17:55:09 -04:00
EEXIST