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
|