PythonExtra/docs/library/builtins.rst
Damien George 3c4bfd1dec py/objexcept: Support errno attribute on OSError exceptions.
This commit adds the errno attribute to exceptions, so code can retrieve
errno codes from an OSError using exc.errno.

The implementation here simply lets `errno` (and the existing `value`)
attributes work on any exception instance (they both alias args[0]).  This
is for efficiency and to keep code size down.  The pros and cons of this
are:

Pros:
- more compatible with CPython, less difference to document and learn
- OSError().errno will correctly return None, whereas the current way of
  doing it via OSError().args[0] will raise an IndexError
- it reduces code size on most bare-metal ports (because they already have
  the errno qstr)
- for Python code that uses exc.errno the generated bytecode is 2 bytes
  smaller and more efficient to execute (compared with exc.args[0]); so
  bytecode loaded to RAM saves 2 bytes RAM for each use of this attribute,
  and bytecode that is frozen saves 2 bytes flash/ROM for each use
- it's easier/shorter to type, and saves 2 bytes of space in .py files that
  use it (for each use)

Cons:
- increases code size by 4-8 bytes on minimal ports that don't already have
  the `errno` qstr
- all exceptions now have .errno and .value attributes (a cpydiff test is
  added to address this)

See also #2407.

Signed-off-by: Damien George <damien@micropython.org>
2021-04-23 22:03:46 +10:00

2.7 KiB

Builtin functions and exceptions

All builtin functions and exceptions are described here. They are also available via builtins module.

Functions and types

abs()

all()

any()

bin()

python:bytes.

callable()

chr()

classmethod()

compile()

delattr(obj, name)

The argument name should be a string, and this function deletes the named attribute from the object given by obj.

dir()

divmod()

enumerate()

eval()

exec()

filter()

getattr()

globals()

hasattr()

hash()

hex()

id()

input()

from_bytes(bytes, byteorder)

In MicroPython, byteorder parameter must be positional (this is compatible with CPython).

to_bytes(size, byteorder)

In MicroPython, byteorder parameter must be positional (this is compatible with CPython).

isinstance()

issubclass()

iter()

len()

locals()

map()

max()

min()

next()

oct()

open()

ord()

pow()

print()

property()

range()

repr()

reversed()

round()

setattr()

The slice builtin is the type that slice objects have.

sorted()

staticmethod()

sum()

super()

type()

zip()

Exceptions

AssertionError

AttributeError

Exception

ImportError

IndexError

KeyboardInterrupt

KeyError

MemoryError

NameError

NotImplementedError

OSError

RuntimeError

StopIteration

SyntaxError

SystemExit

python:SystemExit.

TypeError

python:TypeError.

ValueError

ZeroDivisionError