mirror of
https://github.com/micropython/micropython.git
synced 2025-09-06 18:00:48 +02:00
908ab1ceca
Fixes and improvements to `int.to_bytes()` are: - No longer overflows if byte size is 0 (closes #13041). - Raises OverflowError in any case where number won't fit into byte length (now matches CPython, previously MicroPython would return a truncated bytes object). - Document that `micropython int.to_bytes()` doesn't implement the optional signed kwarg, but will behave as if `signed=True` when the integer is negative (this is the current behaviour). Add tests for this also. Requires changes for small ints, MPZ large ints, and "long long" large ints. Adds a new set of unit tests for ints between 32 and 64 bits to increase coverage of "long long" large ints, which are otherwise untested. Tested on unix port (64 bit small ints, MPZ long ints) and Zephyr STM32WB board (32 bit small ints, long long large ints). This work was funded through GitHub Sponsors. Signed-off-by: Angus Gratton <angus@redyak.com.au>
200 lines
3.0 KiB
ReStructuredText
200 lines
3.0 KiB
ReStructuredText
:mod:`builtins` -- builtin functions and exceptions
|
|
===================================================
|
|
|
|
All builtin functions and exceptions are described here. They are also
|
|
available via ``builtins`` module.
|
|
|
|
Functions and types
|
|
-------------------
|
|
|
|
.. function:: abs()
|
|
|
|
.. function:: all()
|
|
|
|
.. function:: any()
|
|
|
|
.. function:: bin()
|
|
|
|
.. class:: bool()
|
|
|
|
.. class:: bytearray()
|
|
|
|
.. class:: bytes()
|
|
|
|
|see_cpython| `python:bytes`.
|
|
|
|
.. function:: callable()
|
|
|
|
.. function:: chr()
|
|
|
|
.. function:: classmethod()
|
|
|
|
.. function:: compile()
|
|
|
|
.. class:: complex()
|
|
|
|
.. function:: delattr(obj, name)
|
|
|
|
The argument *name* should be a string, and this function deletes the named
|
|
attribute from the object given by *obj*.
|
|
|
|
.. class:: dict()
|
|
|
|
.. function:: dir()
|
|
|
|
.. function:: divmod()
|
|
|
|
.. function:: enumerate()
|
|
|
|
.. function:: eval()
|
|
|
|
.. function:: exec()
|
|
|
|
.. function:: filter()
|
|
|
|
.. class:: float()
|
|
|
|
.. class:: frozenset()
|
|
|
|
.. function:: getattr()
|
|
|
|
.. function:: globals()
|
|
|
|
.. function:: hasattr()
|
|
|
|
.. function:: hash()
|
|
|
|
.. function:: hex()
|
|
|
|
.. function:: id()
|
|
|
|
.. function:: input()
|
|
|
|
.. class:: int()
|
|
|
|
.. classmethod:: from_bytes(bytes, byteorder)
|
|
|
|
In MicroPython, `byteorder` parameter must be positional (this is
|
|
compatible with CPython).
|
|
|
|
.. method:: to_bytes(size, byteorder)
|
|
|
|
In MicroPython, `byteorder` parameter must be positional (this is
|
|
compatible with CPython).
|
|
|
|
.. note:: The optional ``signed`` kwarg from CPython is not supported.
|
|
MicroPython currently converts negative integers as signed,
|
|
and positive as unsigned. (:ref:`Details <cpydiff_types_int_to_bytes>`.)
|
|
|
|
.. function:: isinstance()
|
|
|
|
.. function:: issubclass()
|
|
|
|
.. function:: iter()
|
|
|
|
.. function:: len()
|
|
|
|
.. class:: list()
|
|
|
|
.. function:: locals()
|
|
|
|
.. function:: map()
|
|
|
|
.. function:: max()
|
|
|
|
.. class:: memoryview()
|
|
|
|
.. function:: min()
|
|
|
|
.. function:: next()
|
|
|
|
.. class:: object()
|
|
|
|
.. function:: oct()
|
|
|
|
.. function:: open()
|
|
|
|
.. function:: ord()
|
|
|
|
.. function:: pow()
|
|
|
|
.. function:: print()
|
|
|
|
.. function:: property()
|
|
|
|
.. function:: range()
|
|
|
|
.. function:: repr()
|
|
|
|
.. function:: reversed()
|
|
|
|
.. function:: round()
|
|
|
|
.. class:: set()
|
|
|
|
.. function:: setattr()
|
|
|
|
.. class:: slice()
|
|
|
|
The *slice* builtin is the type that slice objects have.
|
|
|
|
.. function:: sorted()
|
|
|
|
.. function:: staticmethod()
|
|
|
|
.. class:: str()
|
|
|
|
.. function:: sum()
|
|
|
|
.. function:: super()
|
|
|
|
.. class:: tuple()
|
|
|
|
.. function:: type()
|
|
|
|
.. function:: zip()
|
|
|
|
|
|
Exceptions
|
|
----------
|
|
|
|
.. exception:: AssertionError
|
|
|
|
.. exception:: AttributeError
|
|
|
|
.. exception:: Exception
|
|
|
|
.. exception:: ImportError
|
|
|
|
.. exception:: IndexError
|
|
|
|
.. exception:: KeyboardInterrupt
|
|
|
|
.. exception:: KeyError
|
|
|
|
.. exception:: MemoryError
|
|
|
|
.. exception:: NameError
|
|
|
|
.. exception:: NotImplementedError
|
|
|
|
.. exception:: OSError
|
|
|
|
.. exception:: RuntimeError
|
|
|
|
.. exception:: StopIteration
|
|
|
|
.. exception:: SyntaxError
|
|
|
|
.. exception:: SystemExit
|
|
|
|
|see_cpython| `python:SystemExit`.
|
|
|
|
.. exception:: TypeError
|
|
|
|
|see_cpython| `python:TypeError`.
|
|
|
|
.. exception:: ValueError
|
|
|
|
.. exception:: ZeroDivisionError
|