Inbyggda typer¶

Generated Fri 19 Jun 2026 22:08:45 UTC

Undantag¶

Alla undantag har läsbara attributen `value` och `errno`, inte bara `StopIteration` och `OSError`.¶

Orsak: MicroPython är optimerat för att minska kodstorleken.

Lösning: Använd bara value på StopIteration-undantag och errno på OSError-undantag. Använd inte och förlita dig inte på dessa attribut på andra undantag.

Exempelkod:

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

Undantagskedja är inte implementerat¶

Exempelkod:

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:

Användardefinierade attribut för inbyggda undantag stöds inte¶

Orsak: MicroPython är högt optimerat för minnesanvändning.

Lösning: Använd användardefinierade underklasser till undantag.

Exempelkod:

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'

Undantag i while-loop-villkor kan ha oväntat radnummer¶

Orsak: Villkorskontroller är optimerade att ske i slutet av loop-kroppen, och det är det radnumret som rapporteras.

Exempelkod:

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

Metoden Exception.init finns inte.¶

Orsak: Att skapa underklasser av inbyggda klasser stöds inte fullt ut i MicroPython.

Lösning: Anropa med super() istället:

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

Exempelkod:

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.

Exempelkod:

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¶

Tilldelning av array-snitt med otillåten högeroperand¶

Exempelkod:

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-objekt stöder metoden .format()¶

Orsak: MicroPython strävar efter att vara en mer konsekvent implementation, så om både str och bytes stöder __mod__() (%-operatorn) är det logiskt att stödja format() för bägge. Stödet för __mod__ kan också kompileras bort, vilket lämnar bara format() för bytes-formatering.

Lösning: Om du vill ha CPython-kompatibilitet, använd inte .format() på bytes-objekt.

Exempelkod:

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() med nyckelord är inte implementerat¶

Lösning: Ange kodningen som en positionsparameter, t.ex. print(bytes('abc', 'utf-8'))

Exempelkod:

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-indexering med steg != 1 är inte implementerat¶

Orsak: MicroPython är högt optimerat för minnesanvändning.

Lösning: Använd en explicit loop för denna mycket sällsynta operation.

Exempelkod:

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¶

Orsak: MicroPython är högt optimerat för minnesanvändning.

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.

Exempelkod:

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

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

dict¶

Ordbokens nyckelvyn beter sig inte som en mängd.¶

Orsak: Inte implementerat.

Lösning: Konvertera nycklar explicit till en mängd innan du använder mängdoperationer.

Exempelkod:

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.¶

Lösning: Objekt bör omslutas i float(obj) för kompatibilitet med CPython.

Exempelkod:

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¶

Metoden `bit_length` finns inte.¶

Orsak: Metoden bit_length är inte implementerad.

Lösning: Undvik att använda denna metod i MicroPython.

Exempelkod:

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'

Ingen int-konvertering tillgänglig för int-härledda typer¶

Lösning: Undvik att skapa underklasser av inbyggda typer om det inte verkligen behövs. Föredra https://en.wikipedia.org/wiki/Composition_over_inheritance .

Exempelkod:

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'

Metoden `to_bytes` implementerar inte parametern signed.¶

Orsak: Nyckelordsparametern signed är inte implementerad för int.to_bytes().

När heltalet är negativt beter sig MicroPython likadant som CPython int.to_bytes(..., signed=True)

När heltalet är icke-negativt beter sig MicroPython likadant som CPython int.to_bytes(..., signed=False).

(Skillnaden är subtil, men i CPython kan ett positivt heltal konverterat med signed=True kräva en extra byte i utdatalängden för att rymma teckenbitens 0-värde.)

Lösning: Var försiktig när du anropar to_bytes() på ett heltalsvärde som kan vara negativt.

Exempelkod:

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¶

Listborttagning med steg != 1 är inte implementerat¶

Lösning: Använd en explicit loop för denna sällsynta operation.

Exempelkod:

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:

Listsnittslagring med icke-iterabel högeroperand är inte implementerat¶

Orsak: Högeroperanden måste vara en tupel eller lista

Lösning: Använd list(<iter>) på högeroperanden för att konvertera det iterabla objektet till en lista

Exempelkod:

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

Listlagring med steg != 1 är inte implementerat¶

Lösning: Använd en explicit loop för denna sällsynta operation.

Exempelkod:

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 kan bli ogiltig om målobjektet ändrar storlek¶

Orsak: CPython hindrar ett bytearray- eller io.bytesIO-objekt från att ändra storlek medan ett memoryview-objekt refererar till det. MicroPython kräver att programmeraren manuellt säkerställer att ett objekt inte ändrar storlek medan något memoryview refererar till det.

I värsta fall kan storleksändring av ett objekt som är målet för en memoryview leda till att memoryview(s) refererar till ogiltigt frigjort minne (ett use-after-free-fel) och korrumperar MicroPython-körtiden.

Lösning: Ändra inte storleken på något bytearray- eller io.bytesIO-objekt som har en memoryview tilldelad till sig.

Exempelkod:

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

Exempelkod:

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.

Exempelkod:

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.

Exempelkod:

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

Attribut/indexering är inte implementerat¶

Exempelkod:

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(…) med nyckelord är inte implementerat¶

Lösning: Ange kodningsformatet direkt, t.ex. print(bytes('abc', 'utf-8'))

Exempelkod:

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() och str.rjust() är inte implementerat¶

Orsak: MicroPython är högt optimerat för minnesanvändning. Enkla alternativ finns tillgängliga.

Lösning: Istället för s.ljust(10) använd "%-10s" % s, istället för s.rjust(10) använd "% 10s" % s. Alternativt "{:<10}".format(s) eller "{:>10}".format(s).

Exempelkod:

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 som första argument till rsplit, t.ex. str.rsplit(None, n), är inte implementerat¶

Exempelkod:

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)

Indexering med steg != 1 är ännu inte implementerat¶

Exempelkod:

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¶

Tupelladdning med steg != 1 är inte implementerat¶

Exempelkod:

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

Inbyggda typer¶

Undantag¶

Alla undantag har läsbara attributen value och errno, inte bara StopIteration och OSError.¶

Undantagskedja är inte implementerat¶

Användardefinierade attribut för inbyggda undantag stöds inte¶

Undantag i while-loop-villkor kan ha oväntat radnummer¶

Metoden Exception.__init__ finns inte.¶

OSError¶

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

bytearray¶

Tilldelning av array-snitt med otillåten högeroperand¶

bytes¶

bytes-objekt stöder metoden .format()¶

bytes() med nyckelord är inte implementerat¶

Bytes-indexering med steg != 1 är inte implementerat¶

complex¶

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

dict¶

Ordbokens nyckelvyn beter sig inte som en mängd.¶

float¶

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

int¶

Metoden bit_length finns inte.¶

Ingen int-konvertering tillgänglig för int-härledda typer¶

Metoden to_bytes implementerar inte parametern signed.¶

list¶

Listborttagning med steg != 1 är inte implementerat¶

Listsnittslagring med icke-iterabel högeroperand är inte implementerat¶

Listlagring med steg != 1 är inte implementerat¶

memoryview¶

memoryview kan bli ogiltig om målobjektet ändrar storlek¶

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¶

Attribut/indexering är inte implementerat¶

str(…) med nyckelord är inte implementerat¶

str.ljust() och str.rjust() är inte implementerat¶

None som första argument till rsplit, t.ex. str.rsplit(None, n), är inte implementerat¶

Indexering med steg != 1 är ännu inte implementerat¶

tuple¶

Tupelladdning med steg != 1 är inte implementerat¶

Alla undantag har läsbara attributen `value` och `errno`, inte bara `StopIteration` och `OSError`.¶

Metoden Exception.init finns inte.¶

Metoden `bit_length` finns inte.¶

Metoden `to_bytes` implementerar inte parametern signed.¶