Sisäänrakennetut tyypit¶

Generated Fri 19 Jun 2026 22:08:45 UTC

Poikkeus¶

Kaikilla poikkeuksilla on luettavat `value`- ja `errno`-attribuutit, ei pelkästään `StopIteration`- ja `OSError`-poikkeuksilla.¶

Syy: MicroPython on optimoitu pienentämään koodin kokoa.

Kiertotapa: Käytä value-attribuuttia vain StopIteration-poikkeuksissa ja errno-attribuuttia vain OSError-poikkeuksissa. Älä käytä tai luota näihin attribuutteihin muissa poikkeuksissa.

Esimerkkikoodi:

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

Poikkeusten ketjutusta ei ole toteutettu¶

Esimerkkikoodi:

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:

Käyttäjän määrittelemiä attribuutteja sisäänrakennetuille poikkeuksille ei tueta¶

Syy: MicroPython on voimakkaasti optimoitu muistinkäytön suhteen.

Kiertotapa: Käytä käyttäjän määrittelemiä poikkealuokkia.

Esimerkkikoodi:

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-silmukan ehdossa tapahtuva poikkeus voi ilmoittaa odottamattoman rivinumeron¶

Syy: Ehdon tarkistus on optimoitu tapahtumaan silmukan rungon lopussa, ja kyseinen rivinumero raportoidaan.

Esimerkkikoodi:

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-metodia ei ole olemassa.¶

Syy: Natiivien luokkien aliluokittamista ei tueta täysimääräisesti MicroPythonissa.

Kiertotapa: Kutsu sen sijaan super()-funktiolla:

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

Esimerkkikoodi:

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.

Esimerkkikoodi:

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¶

Taulukon viipaleomistuksen oikea puoli ei ole tuettu¶

Esimerkkikoodi:

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-oliot tukevat .format()-metodia¶

Syy: MicroPython pyrkii olemaan yhtenäisempi toteutus, joten koska sekä str että bytes tukevat __mod__()-operaattoria (%-operaattori), on johdonmukaista tukea format()-metodia molemmille. __mod__-tuki voidaan myös poistaa käännösaikana, jolloin jäljelle jää vain format() bytes-muotoilua varten.

Kiertotapa: Jos CPython-yhteensopivuus on tärkeää, älä käytä .format()-metodia bytes-olioille.

Esimerkkikoodi:

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()-funktio avainsana-argumenteilla ei ole toteutettu¶

Kiertotapa: Anna koodaus paikka-argumenttina, esim. print(bytes('abc', 'utf-8'))

Esimerkkikoodi:

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-indeksointi askeleella != 1 ei ole toteutettu¶

Syy: MicroPython on voimakkaasti optimoitu muistinkäytön suhteen.

Kiertotapa: Käytä eksplisiittistä silmukkaa tähän hyvin harvinaiseen operaatioon.

Esimerkkikoodi:

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¶

Syy: MicroPython on voimakkaasti optimoitu muistinkäytön suhteen.

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.

Esimerkkikoodi:

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

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

dict¶

Sanakirjan avainten näkymä ei käyttäydy kuten joukko.¶

Syy: Ei ole toteutettu.

Kiertotapa: Muunna avaimet eksplisiittisesti joukoksi ennen joukko-operaatioiden käyttöä.

Esimerkkikoodi:

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

Kiertotapa: Oliot tulee kääriä float(obj)-kutsulla CPython-yhteensopivuuden varmistamiseksi.

Esimerkkikoodi:

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`-metodia ei ole olemassa.¶

Syy: bit_length-metodia ei ole toteutettu.

Kiertotapa: Vältä tämän metodin käyttöä MicroPythonissa.

Esimerkkikoodi:

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-muunnos int-johdetuille tyypeille ei ole saatavilla¶

Kiertotapa: Vältä sisäänrakennettujen tyyppien aliluokittamista, ellei se ole välttämätöntä. Suosi https://en.wikipedia.org/wiki/Composition_over_inheritance .

Esimerkkikoodi:

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`-metodi ei toteuta signed-parametria.¶

Syy: signed-avainsanaparametria ei ole toteutettu int.to_bytes()-metodille.

Kun kokonaisluku on negatiivinen, MicroPython käyttäytyy samoin kuin CPython int.to_bytes(..., signed=True)

Kun kokonaisluku ei ole negatiivinen, MicroPython käyttäytyy samoin kuin CPython int.to_bytes(..., signed=False).

(Ero on hienovarainen, mutta CPythonissa positiivinen kokonaisluku muunnettuna signed=True-arvolla saattaa vaatia yhden tavun enemmän tulospituuteen merkkibitin 0 mahduttamiseksi.)

Kiertotapa: Ole varovainen kutsuttaessa to_bytes()-metodia kokonaislukuarvolle, joka voi olla negatiivinen.

Esimerkkikoodi:

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¶

Listan poisto askeleella != 1 ei ole toteutettu¶

Kiertotapa: Käytä eksplisiittistä silmukkaa tähän harvinaiseen operaatioon.

Esimerkkikoodi:

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:

Listan viipaletallennus ei-iteroitavalla oikealla puolella ei ole toteutettu¶

Syy: Oikea puoli on rajoitettu olemaan tuple tai list

Kiertotapa: Käytä list(<iter>)-kutsua oikealla puolella muuntaaksesi iteroitavan listaksi

Esimerkkikoodi:

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

Listan tallennus askeleella != 1 ei ole toteutettu¶

Kiertotapa: Käytä eksplisiittistä silmukkaa tähän harvinaiseen operaatioon.

Esimerkkikoodi:

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 voi muuttua epäkelpoiseksi, jos sen kohde koon muutetaan¶

Syy: CPython estää bytearray- tai io.bytesIO-olion koon muuttamisen, kun siihen viittaa memoryview-olio. MicroPython edellyttää, että ohjelmoija varmistaa manuaalisesti, ettei olion kokoa muuteta minkään memoryview-viittauksen ollessa voimassa.

Pahimmassa tapauksessa memoryview-kohteen koon muuttaminen voi aiheuttaa sen, että memoryview-oliot viittaavat vapautettuun virheelliseen muistiin (use-after-free-virhe) ja vioittavat MicroPython-suoritusympäristön.

Kiertotapa: Älä muuta sellaisen bytearray- tai io.bytesIO-olion kokoa, johon on liitetty memoryview.

Esimerkkikoodi:

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

Esimerkkikoodi:

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.

Esimerkkikoodi:

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.

Esimerkkikoodi:

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

Attribuutteja/indeksointia ei ole toteutettu¶

Esimerkkikoodi:

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(…) avainsana-argumenteilla ei ole toteutettu¶

Kiertotapa: Anna koodausmuoto suoraan, esim. print(bytes('abc', 'utf-8'))

Esimerkkikoodi:

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() ja str.rjust() eivät ole toteutettuja¶

Syy: MicroPython on voimakkaasti optimoitu muistinkäytön suhteen. Helppoja kiertotapoja on saatavilla.

Kiertotapa: s.ljust(10)-kutsun sijaan käytä "%-10s" % s, s.rjust(10)-kutsun sijaan käytä "% 10s" % s. Vaihtoehtoisesti "{:<10}".format(s) tai "{:>10}".format(s).

Esimerkkikoodi:

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 ensimmäisenä argumenttina rsplit-kutsulle kuten str.rsplit(None, n) ei ole toteutettu¶

Esimerkkikoodi:

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)

Indeksointi askeleella != 1 ei ole vielä toteutettu¶

Esimerkkikoodi:

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¶

Tuplen lukeminen askeleella != 1 ei ole toteutettu¶

Esimerkkikoodi:

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

Sisäänrakennetut tyypit¶

Poikkeus¶

Kaikilla poikkeuksilla on luettavat value- ja errno-attribuutit, ei pelkästään StopIteration- ja OSError-poikkeuksilla.¶

Poikkeusten ketjutusta ei ole toteutettu¶

Käyttäjän määrittelemiä attribuutteja sisäänrakennetuille poikkeuksille ei tueta¶

While-silmukan ehdossa tapahtuva poikkeus voi ilmoittaa odottamattoman rivinumeron¶

Exception.__init__-metodia ei ole olemassa.¶

OSError¶

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

bytearray¶

Taulukon viipaleomistuksen oikea puoli ei ole tuettu¶

bytes¶

bytes-oliot tukevat .format()-metodia¶

bytes()-funktio avainsana-argumenteilla ei ole toteutettu¶

Bytes-indeksointi askeleella != 1 ei ole toteutettu¶

complex¶

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

dict¶

Sanakirjan avainten näkymä ei käyttäydy kuten joukko.¶

float¶

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

int¶

bit_length-metodia ei ole olemassa.¶

Int-muunnos int-johdetuille tyypeille ei ole saatavilla¶

to_bytes-metodi ei toteuta signed-parametria.¶

list¶

Listan poisto askeleella != 1 ei ole toteutettu¶

Listan viipaletallennus ei-iteroitavalla oikealla puolella ei ole toteutettu¶

Listan tallennus askeleella != 1 ei ole toteutettu¶

memoryview¶

memoryview voi muuttua epäkelpoiseksi, jos sen kohde koon muutetaan¶

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¶

Attribuutteja/indeksointia ei ole toteutettu¶

str(…) avainsana-argumenteilla ei ole toteutettu¶

str.ljust() ja str.rjust() eivät ole toteutettuja¶

None ensimmäisenä argumenttina rsplit-kutsulle kuten str.rsplit(None, n) ei ole toteutettu¶

Indeksointi askeleella != 1 ei ole vielä toteutettu¶

tuple¶

Tuplen lukeminen askeleella != 1 ei ole toteutettu¶

Kaikilla poikkeuksilla on luettavat `value`- ja `errno`-attribuutit, ei pelkästään `StopIteration`- ja `OSError`-poikkeuksilla.¶

Exception.init-metodia ei ole olemassa.¶

`bit_length`-metodia ei ole olemassa.¶

`to_bytes`-metodi ei toteuta signed-parametria.¶