Beépített típusok

Generated Fri 19 Jun 2026 22:08:45 UTC

Kivétel

Minden kivételnek van olvasható value és errno attribútuma, nem csak a StopIteration-nek és az OSError-nak.

Ok: A MicroPython a kódméret csökkentésére van optimalizálva.

Megkerülés: Csak a StopIteration kivételeken használja a value attribútumot, és az OSError kivételeken az errno attribútumot. Ne használja, és ne támaszkodjon ezekre az attribútumokra más kivételeken.

Mintakód:

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

A kivételláncolás nincs megvalósítva

Mintakód:

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:

A beépített kivételek felhasználó által definiált attribútumai nem támogatottak

Ok: A MicroPython erősen optimalizált a memóriahasználat szempontjából.

Megkerülés: Használjon felhasználó által definiált kivétel-alosztályokat.

Mintakód:

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'

A while ciklus feltételében keletkező kivételhez váratlan sorszám tartozhat

Ok: A feltételvizsgálatok a ciklustest végén történnek az optimalizálás miatt, és az a sorszám kerül jelentésre.

Mintakód:

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

Az Exception.__init__ metódus nem létezik.

Ok: A natív osztályok alosztályozása nem teljes körűen támogatott a MicroPythonban.

Megkerülés: Helyette használja a super() hívást:

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

Mintakód:

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.

Mintakód:

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

Tömbszeletek hozzárendelése nem támogatott jobb oldali értékkel

Mintakód:

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

A bytes objektumok támogatják a .format() metódust

Ok: A MicroPython egységesebb megvalósításra törekszik, ezért ha mind a str, mind a bytes támogatja a __mod__() operátort (a % operátort), logikus mindkettőhöz támogatni a format()-ot is. A __mod__ támogatása ki is fordítható, ami csak a format()-ot hagyja meg a bytes formázáshoz.

Megkerülés: Ha a CPython-kompatibilitás fontos, ne használja a .format()-ot bytes objektumokon.

Mintakód:

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'

A bytes() kulcsszavas argumentumokkal nincs megvalósítva

Megkerülés: Adja meg a kódolást pozicionális paraméterként, pl. print(bytes('abc', 'utf-8'))

Mintakód:

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

A bytes indexelése 1-től eltérő lépéssel nincs megvalósítva

Ok: A MicroPython erősen optimalizált a memóriahasználat szempontjából.

Megkerülés: Használjon explicit ciklust ehhez a rendkívül ritka művelethez.

Mintakód:

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

Ok: A MicroPython erősen optimalizált a memóriahasználat szempontjából.

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.

Mintakód:

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

CPython output:

MicroPython output:

ValueError
(1+1j)

dict

A szótár kulcsnézete nem viselkedik halmazként.

Ok: Nincs megvalósítva.

Megkerülés: A halmazműveletek előtt explicit módon alakítsa a kulcsokat halmazzá.

Mintakód:

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.

Megkerülés: A CPython-kompatibilitás érdekében az objektumokat csomagolja float(obj)-ba.

Mintakód:

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

A bit_length metódus nem létezik.

Ok: A bit_length metódus nincs megvalósítva.

Megkerülés: Kerülje ennek a metódusnak a használatát MicroPythonban.

Mintakód:

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'

Az int-ből származtatott típusokhoz nem áll rendelkezésre int konverzió

Megkerülés: Kerülje a beépített típusok alosztályozását, hacsak valóban szükséges. Részesítse előnyben a https://en.wikipedia.org/wiki/Composition_over_inheritance megközelítést.

Mintakód:

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'

A to_bytes metódus nem valósítja meg a signed paramétert.

Ok: A signed kulcsszó-csak paraméter nincs megvalósítva az int.to_bytes()-hoz.

Ha az egész negatív, a MicroPython ugyanúgy viselkedik, mint a CPython int.to_bytes(..., signed=True)

Ha az egész nem negatív, a MicroPython ugyanúgy viselkedik, mint a CPython int.to_bytes(..., signed=False).

(A különbség finom, de CPythonban egy pozitív egész signed=True konverziójakor a kimenet eggyel több bájtot igényelhet, hogy elférjen a 0 előjelbit.)

Megkerülés: Legyen körültekintő a to_bytes() hívásakor olyan egész értéken, amely negatív lehet.

Mintakód:

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

Lista törlése 1-től eltérő lépéssel nincs megvalósítva

Megkerülés: Használjon explicit ciklust ehhez a ritka művelethez.

Mintakód:

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:

Lista szeletének tárolása nem iterálható jobb oldali értékkel nincs megvalósítva

Ok: A jobb oldali értéknek tuple-nak vagy listának kell lennie

Megkerülés: Használja a list(<iter>)-t a jobb oldalon az iterálható objektum listává alakításához

Mintakód:

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

Lista tárolása 1-től eltérő lépéssel nincs megvalósítva

Megkerülés: Használjon explicit ciklust ehhez a ritka művelethez.

Mintakód:

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

A memoryview érvénytelenné válhat, ha a célját átméretezik

Ok: A CPython megakadályozza, hogy egy bytearray vagy io.bytesIO objektum méretet változtasson, amíg egy memoryview objektum hivatkozik rá. A MicroPython megköveteli a programozótól, hogy kézzel gondoskodjon arról, hogy egy objektumot ne méretezzenek át, amíg bármely memoryview hivatkozik rá.

A legrosszabb esetben egy memoryview céljaként szolgáló objektum átméretezése azt okozhatja, hogy a memoryview(k) érvénytelen, felszabadított memóriaterületre hivatkoznak (use-after-free hiba), és megrongálják a MicroPython futtatókörnyezetet.

Megkerülés: Ne változtassa meg egyetlen olyan bytearray vagy io.bytesIO objektum méretét sem, amelyhez memoryview van rendelve.

Mintakód:

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

Mintakód:

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.

Mintakód:

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.

Mintakód:

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

Attribútumok/indexelés nincs megvalósítva

Mintakód:

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

A str(…) kulcsszavas argumentumokkal nincs megvalósítva

Megkerülés: Adja meg közvetlenül a kódolási formátumot, pl. print(bytes('abc', 'utf-8'))

Mintakód:

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

A str.ljust() és str.rjust() nincs megvalósítva

Ok: A MicroPython erősen optimalizált a memóriahasználat szempontjából. Egyszerű megkerülési lehetőségek állnak rendelkezésre.

Megkerülés: Az s.ljust(10) helyett használja a "%-10s" % s kifejezést, az s.rjust(10) helyett a "% 10s" % s kifejezést. Alternatívaként a "{:<10}".format(s) vagy a "{:>10}".format(s) is megfelelő.

Mintakód:

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'

A None első argumentumként az rsplit számára, pl. str.rsplit(None, n), nincs megvalósítva

Mintakód:

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)

Az indexelés 1-től eltérő lépéssel még nincs megvalósítva

Mintakód:

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

Tuple betöltése 1-től eltérő lépéssel nincs megvalósítva

Mintakód:

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