Вбудовані типи¶

Generated Thu 18 Jun 2026 19:58:13 UTC

Виняток¶

Усі винятки мають доступні для читання атрибути `value` та `errno`, а не лише `StopIteration` та `OSError`.¶

Причина: MicroPython оптимізовано для зменшення розміру коду.

Обхідний шлях: Використовуйте value лише для винятків StopIteration, а errno — лише для OSError. Не використовуйте та не покладайтесь на ці атрибути в інших винятках.

Зразок коду:

e = Exception(1)
print(e.value)
print(e.errno)

CPython output:	MicroPython output:
Traceback (most recent call last): File "<stdin>", line 9, in <module> AttributeError: 'Exception' object has no attribute 'value'	1 1

Ланцюжок винятків не реалізовано¶

Зразок коду:

try:
    raise TypeError
except TypeError:
    raise ValueError

CPython output:

MicroPython output:

Traceback (most recent call last):
  File "<stdin>", line 9, in <module>
TypeError

During handling of the above exception, another exception occurred:

Traceback (most recent call last):
  File "<stdin>", line 11, in <module>
ValueError

Traceback (most recent call last):
  File "<stdin>", line 11, in <module>
ValueError:

Атрибути, визначені користувачем, для вбудованих винятків не підтримуються¶

Причина: MicroPython оптимізовано для мінімального використання пам’яті.

Обхідний шлях: Використовуйте підкласи винятків, визначені користувачем.

Зразок коду:

e = Exception()
e.x = 0
print(e.x)

CPython output:	MicroPython output:
0	Traceback (most recent call last): File "<stdin>", line 9, in <module> AttributeError: 'Exception' object has no attribute 'x'

Виняток у умові циклу while може мати неочікуваний номер рядка¶

Причина: Перевірки умов оптимізовано так, що вони виконуються в кінці тіла циклу, і саме цей номер рядка повідомляється.

Зразок коду:

l = ["-foo", "-bar"]

i = 0
while l[i][0] == "-":
    print("iter")
    i += 1

CPython output:

MicroPython output:

iter
iter
Traceback (most recent call last):
  File "<stdin>", line 11, in <module>
IndexError: list index out of range

iter
iter
Traceback (most recent call last):
  File "<stdin>", line 13, in <module>
IndexError: list index out of range

Метод Exception.init не існує.¶

Причина: Підкласи нативних класів не повністю підтримуються в MicroPython.

Обхідний шлях: Використовуйте super() натомість:

class A(Exception):
    def __init__(self):
        super().__init__()

Зразок коду:

class A(Exception):
    def __init__(self):
        Exception.__init__(self)


a = A()

CPython output:	MicroPython output:
	Traceback (most recent call last): File "<stdin>", line 18, in <module> File "<stdin>", line 15, in __init__ AttributeError: type object 'Exception' has no attribute '__init__'

OSError¶

OSError constructor returns a plain OSError for all errno values, rather than a relevant subtype.¶

Cause: MicroPython does not include the CPython-standard OSError subclasses.

Workaround: Catch OSError and use its errno attribute to discriminate the cause.

Зразок коду:

import errno

errno_list = [  # i.e. the set implemented by micropython
    errno.EPERM,
    errno.ENOENT,
    errno.EIO,
    errno.EBADF,
    errno.EAGAIN,
    errno.ENOMEM,
    errno.EACCES,
    errno.EEXIST,
    errno.ENODEV,
    errno.EISDIR,
    errno.EINVAL,
    errno.EOPNOTSUPP,
    errno.EADDRINUSE,
    errno.ECONNABORTED,
    errno.ECONNRESET,
    errno.ENOBUFS,
    errno.ENOTCONN,
    errno.ETIMEDOUT,
    errno.ECONNREFUSED,
    errno.EHOSTUNREACH,
    errno.EALREADY,
    errno.EINPROGRESS,
]


def errno_output_type(n):
    try:
        raise OSError(n, "")
    except OSError as e:
        return f"{type(e).__name__}"
    except Exception as e:
        return f"non-OSError {type(e).__name__}"
    else:
        return "no error"


for n in errno_list:
    print(errno.errorcode[n], "=", errno_output_type(n))

CPython output:

MicroPython output:

EPERM = PermissionError
ENOENT = FileNotFoundError
EIO = OSError
EBADF = OSError
EAGAIN = BlockingIOError
ENOMEM = OSError
EACCES = PermissionError
EEXIST = FileExistsError
ENODEV = OSError
EISDIR = IsADirectoryError
EINVAL = OSError
ENOTSUP = OSError
EADDRINUSE = OSError
ECONNABORTED = ConnectionAbortedError
ECONNRESET = ConnectionResetError
ENOBUFS = OSError
ENOTCONN = OSError
ETIMEDOUT = TimeoutError
ECONNREFUSED = ConnectionRefusedError
EHOSTUNREACH = OSError
EALREADY = BlockingIOError
EINPROGRESS = BlockingIOError

EPERM = OSError
ENOENT = OSError
EIO = OSError
EBADF = OSError
EAGAIN = OSError
ENOMEM = OSError
EACCES = OSError
EEXIST = OSError
ENODEV = OSError
EISDIR = OSError
EINVAL = OSError
EOPNOTSUPP = OSError
EADDRINUSE = OSError
ECONNABORTED = OSError
ECONNRESET = OSError
ENOBUFS = OSError
ENOTCONN = OSError
ETIMEDOUT = OSError
ECONNREFUSED = OSError
EHOSTUNREACH = OSError
EALREADY = OSError
EINPROGRESS = OSError

bytearray¶

Присвоєння зрізу масиву з непідтримуваним правим операндом¶

Зразок коду:

b = bytearray(4)
b[0:1] = [1, 2]
print(b)

CPython output:	MicroPython output:
bytearray(b'\x01\x02\x00\x00\x00')	Traceback (most recent call last): File "<stdin>", line 9, in <module> NotImplementedError: array/bytes required on right side

bytes¶

Об’єкти bytes підтримують метод .format()¶

Причина: MicroPython прагне бути більш однорідною реалізацією, тому якщо як str, так і bytes підтримують __mod__() (оператор %), логічно також підтримувати format() для обох. Підтримку __mod__ можна виключити під час компіляції, що залишає лише format() для форматування bytes.

Обхідний шлях: Якщо вам важлива сумісність із CPython, не використовуйте .format() на об’єктах bytes.

Зразок коду:

print(b"{}".format(1))

CPython output:	MicroPython output:
Traceback (most recent call last): File "<stdin>", line 8, in <module> AttributeError: 'bytes' object has no attribute 'format'	b'1'

bytes() з ключовими аргументами не реалізовано¶

Обхідний шлях: Передайте кодування як позиційний параметр, наприклад print(bytes('abc', 'utf-8'))

Зразок коду:

print(bytes("abc", encoding="utf8"))

CPython output:	MicroPython output:
b'abc'	Traceback (most recent call last): File "<stdin>", line 8, in <module> NotImplementedError: keyword argument(s) not implemented - use normal args instead

Індексування bytes із кроком != 1 не реалізовано¶

Причина: MicroPython оптимізовано для мінімального використання пам’яті.

Обхідний шлях: Для цієї вкрай рідкісної операції використовуйте явний цикл.

Зразок коду:

print(b"123"[0:3:2])

CPython output:	MicroPython output:
b'13'	Traceback (most recent call last): File "<stdin>", line 8, in <module> NotImplementedError: only slices with step=1 (aka None) are supported

complex¶

MicroPython’s complex() accepts certain incorrect values that CPython rejects¶

Причина: MicroPython оптимізовано для мінімального використання пам’яті.

Workaround: Do not use non-standard complex literals as argument to complex()

MicroPython’s complex() function accepts literals that contain a space and no sign between the real and imaginary parts, and interprets it as a plus.

Зразок коду:

try:
    print(complex("1 1j"))
except ValueError:
    print("ValueError")

CPython output:	MicroPython output:
ValueError	(1+1j)

dict¶

Подання ключів словника не поводиться як множина.¶

Причина: Не реалізовано.

Обхідний шлях: Явно перетворіть ключі на множину перед виконанням операцій із множинами.

Зразок коду:

print({1: 2, 3: 4}.keys() & {1})

CPython output:	MicroPython output:
{1}	Traceback (most recent call last): File "<stdin>", line 8, in <module> TypeError: unsupported types for __and__: 'dict_view', 'set'

float¶

MicroPython allows implicit conversion of objects in maths operations while CPython does not.¶

Обхідний шлях: Для сумісності з CPython об’єкти слід загортати у float(obj).

Зразок коду:

class Test:
    def __float__(self):
        return 0.5


print(2.0 * Test())

CPython output:	MicroPython output:
Traceback (most recent call last): File "<stdin>", line 14, in <module> TypeError: unsupported operand type(s) for *: 'float' and 'Test'	1.0

int¶

Метод `bit_length` не існує.¶

Причина: Метод bit_length не реалізовано.

Обхідний шлях: Уникайте використання цього методу в MicroPython.

Зразок коду:

x = 255
print("{} is {} bits long.".format(x, x.bit_length()))

CPython output:	MicroPython output:
255 is 8 bits long.	Traceback (most recent call last): File "<stdin>", line 9, in <module> AttributeError: 'int' object has no attribute 'bit_length'

Перетворення на int для типів, похідних від int, недоступне¶

Обхідний шлях: Уникайте підкласів вбудованих типів, якщо це справді не потрібно. Надавайте перевагу https://en.wikipedia.org/wiki/Composition_over_inheritance .

Зразок коду:

class A(int):
    __add__ = lambda self, other: A(int(self) + other)


a = A(42)
print(a + a)

CPython output:	MicroPython output:
84	Traceback (most recent call last): File "<stdin>", line 14, in <module> File "<stdin>", line 10, in <lambda> TypeError: unsupported types for __radd__: 'int', 'int'

Метод `to_bytes` не реалізує параметр signed.¶

Причина: Параметр лише за ключовим словом signed не реалізовано для int.to_bytes().

Якщо ціле число від’ємне, MicroPython поводиться так само, як CPython int.to_bytes(..., signed=True)

Якщо ціле число невід’ємне, MicroPython поводиться так само, як CPython int.to_bytes(..., signed=False).

(Різниця незначна, але в CPython додатне ціле число, перетворене з signed=True, може потребувати на один байт більше у вихідній довжині, щоб вмістити знаковий біт 0.)

Обхідний шлях: Будьте обережні під час виклику to_bytes() для значення цілого числа, яке може бути від’ємним.

Зразок коду:

x = -1
print(x.to_bytes(1, "big"))

CPython output:	MicroPython output:
Traceback (most recent call last): File "<stdin>", line 16, in <module> OverflowError: can't convert negative int to unsigned	b'\xff'

list¶

Видалення елементів списку із кроком != 1 не реалізовано¶

Обхідний шлях: Для цієї рідкісної операції використовуйте явний цикл.

Зразок коду:

l = [1, 2, 3, 4]
del l[0:4:2]
print(l)

CPython output:	MicroPython output:
[2, 4]	Traceback (most recent call last): File "<stdin>", line 9, in <module> NotImplementedError:

Присвоєння зрізу списку з неітерованим правим операндом не реалізовано¶

Причина: Правий операнд обмежений кортежем або списком

Обхідний шлях: Використовуйте list(<iter>) для правого операнду, щоб перетворити ітерований об’єкт на список

Зразок коду:

l = [10, 20]
l[0:1] = range(4)
print(l)

CPython output:	MicroPython output:
[0, 1, 2, 3, 20]	Traceback (most recent call last): File "<stdin>", line 9, in <module> TypeError: object 'range' isn't a tuple or list

Збереження елементів списку із кроком != 1 не реалізовано¶

Обхідний шлях: Для цієї рідкісної операції використовуйте явний цикл.

Зразок коду:

l = [1, 2, 3, 4]
l[0:4:2] = [5, 6]
print(l)

CPython output:	MicroPython output:
[5, 2, 6, 4]	Traceback (most recent call last): File "<stdin>", line 9, in <module> NotImplementedError:

memoryview¶

memoryview може стати недійсним, якщо змінити розмір його цільового об’єкта¶

Причина: CPython запобігає зміні розміру об’єкта bytearray або io.bytesIO, доки на нього посилається об’єкт memoryview. MicroPython вимагає від програміста вручну переконатися, що розмір об’єкта не змінюється, поки на нього посилається будь-який memoryview.

У найгіршому випадку зміна розміру об’єкта, на який вказує memoryview, може призвести до того, що memoryview посилатиметься на недійсну звільнену пам’ять (помилка використання після звільнення) і пошкодить середовище виконання MicroPython.

Обхідний шлях: Не змінюйте розмір жодного об’єкта bytearray або io.bytesIO, якому призначено memoryview.

Зразок коду:

b = bytearray(b"abcdefg")
m = memoryview(b)
b.extend(b"hijklmnop")
print(b, bytes(m))

CPython output:	MicroPython output:
Traceback (most recent call last): File "<stdin>", line 12, in <module> BufferError: Existing exports of data: object cannot be re-sized	bytearray(b'abcdefghijklmnop') b'abcdefg'

range¶

Range objects with large start or stop arguments misbehave.¶

Cause: Intermediate calculations overflow the C mp_int_t type

Workaround: Avoid using such ranges

Зразок коду:

from sys import maxsize

# A range including `maxsize-1` cannot be created
try:
    print(range(-maxsize - 1, 0))
except OverflowError:
    print("OverflowError")

# A range with `stop-start` exceeding sys.maxsize has incorrect len(), while CPython cannot calculate len().
try:
    print(len(range(-maxsize, maxsize)))
except OverflowError:
    print("OverflowError")

# A range with `stop-start` exceeding sys.maxsize has incorrect len()
try:
    print(len(range(-maxsize, maxsize, maxsize)))
except OverflowError:
    print("OverflowError")

CPython output:	MicroPython output:
range(-9223372036854775808, 0) OverflowError 2	OverflowError 0 0

str¶

MicroPython accepts the «,» grouping option with any radix, unlike CPython¶

Cause: To reduce code size, MicroPython does not issue an error for this combination

Workaround: Do not use a format string like {:,b} if CPython compatibility is required.

Зразок коду:

try:
    print("{:,b}".format(99))
except ValueError:
    print("ValueError")
try:
    print("{:,x}".format(99))
except ValueError:
    print("ValueError")
try:
    print("{:,o}".format(99))
except ValueError:
    print("ValueError")

CPython output:	MicroPython output:
ValueError ValueError ValueError	110,0011 63 143

MicroPython accepts but does not properly implement the «,» or «_» grouping character for float values¶

Cause: To reduce code size, MicroPython does not implement this combination. Grouping characters will not appear in the number’s significant digits and will appear at incorrect locations in leading zeros.

Workaround: Do not use a format string like {:,f} if exact CPython compatibility is required.

Зразок коду:

print("{:,f}".format(3141.159))
print("{:_f}".format(3141.159))
print("{:011,.2f}".format(3141.159))
print("{:011_.2f}".format(3141.159))

CPython output:	MicroPython output:
3,141.159000 3_141.159000 0,003,141.16 0_003_141.16	3141.159000 3141.159000 000,3141.16 0_003141.16

Атрибути/індексування не реалізовано¶

Зразок коду:

print("{a[0]}".format(a=[1, 2]))

CPython output:	MicroPython output:
1	Traceback (most recent call last): File "<stdin>", line 8, in <module> NotImplementedError: attributes not supported

str(…) з ключовими аргументами не реалізовано¶

Обхідний шлях: Вводьте формат кодування безпосередньо. Наприклад, print(bytes('abc', 'utf-8'))

Зразок коду:

print(str(b"abc", encoding="utf8"))

CPython output:	MicroPython output:
abc	Traceback (most recent call last): File "<stdin>", line 8, in <module> NotImplementedError: keyword argument(s) not implemented - use normal args instead

str.ljust() та str.rjust() не реалізовано¶

Причина: MicroPython оптимізовано для мінімального використання пам’яті. Доступні прості обхідні шляхи.

Обхідний шлях: Замість s.ljust(10) використовуйте "%-10s" % s, замість s.rjust(10) — "% 10s" % s. Або "{:<10}".format(s) чи "{:>10}".format(s).

Зразок коду:

print("abc".ljust(10))

CPython output:	MicroPython output:
abc	Traceback (most recent call last): File "<stdin>", line 8, in <module> AttributeError: 'str' object has no attribute 'ljust'

None як перший аргумент для rsplit, наприклад str.rsplit(None, n), не реалізовано¶

Зразок коду:

print("a a a".rsplit(None, 1))

CPython output:	MicroPython output:
['a a', 'a']	Traceback (most recent call last): File "<stdin>", line 8, in <module> NotImplementedError: rsplit(None,n)

Індексування з кроком != 1 ще не реалізовано¶

Зразок коду:

print("abcdefghi"[0:9:2])

CPython output:	MicroPython output:
acegi	Traceback (most recent call last): File "<stdin>", line 8, in <module> NotImplementedError: only slices with step=1 (aka None) are supported

tuple¶

Завантаження елементів кортежу із кроком != 1 не реалізовано¶

Зразок коду:

print((1, 2, 3, 4)[0:4:2])

CPython output:	MicroPython output:
(1, 3)	Traceback (most recent call last): File "<stdin>", line 8, in <module> NotImplementedError: only slices with step=1 (aka None) are supported

Вбудовані типи¶

Виняток¶

Усі винятки мають доступні для читання атрибути value та errno, а не лише StopIteration та OSError.¶

Ланцюжок винятків не реалізовано¶

Атрибути, визначені користувачем, для вбудованих винятків не підтримуються¶

Виняток у умові циклу while може мати неочікуваний номер рядка¶

Метод Exception.__init__ не існує.¶

OSError¶

OSError constructor returns a plain OSError for all errno values, rather than a relevant subtype.¶

bytearray¶

Присвоєння зрізу масиву з непідтримуваним правим операндом¶

bytes¶

Об’єкти bytes підтримують метод .format()¶

bytes() з ключовими аргументами не реалізовано¶

Індексування bytes із кроком != 1 не реалізовано¶

complex¶

MicroPython’s complex() accepts certain incorrect values that CPython rejects¶

dict¶

Подання ключів словника не поводиться як множина.¶

float¶

MicroPython allows implicit conversion of objects in maths operations while CPython does not.¶

int¶

Метод bit_length не існує.¶

Перетворення на int для типів, похідних від int, недоступне¶

Метод to_bytes не реалізує параметр signed.¶

list¶

Видалення елементів списку із кроком != 1 не реалізовано¶

Присвоєння зрізу списку з неітерованим правим операндом не реалізовано¶

Збереження елементів списку із кроком != 1 не реалізовано¶

memoryview¶

memoryview може стати недійсним, якщо змінити розмір його цільового об’єкта¶

range¶

Range objects with large start or stop arguments misbehave.¶

str¶

MicroPython accepts the «,» grouping option with any radix, unlike CPython¶

MicroPython accepts but does not properly implement the «,» or «_» grouping character for float values¶

Атрибути/індексування не реалізовано¶

str(…) з ключовими аргументами не реалізовано¶

str.ljust() та str.rjust() не реалізовано¶

None як перший аргумент для rsplit, наприклад str.rsplit(None, n), не реалізовано¶

Індексування з кроком != 1 ще не реалізовано¶

tuple¶

Завантаження елементів кортежу із кроком != 1 не реалізовано¶

Усі винятки мають доступні для читання атрибути `value` та `errno`, а не лише `StopIteration` та `OSError`.¶

Метод Exception.init не існує.¶

Метод `bit_length` не існує.¶

Метод `to_bytes` не реалізує параметр signed.¶