Moduler¶

Generated Fri 19 Jun 2026 22:08:45 UTC

Enbart positionsparametrar¶

För att spara kodstorlek accepterar många funktioner som tar nyckelordsargument i CPython bara positionsargument i MicroPython.

MicroPython markerar enbart positionsparametrar på samma sätt som CPython, genom att infoga ett / för att markera slutet på positionsparametrarna. Alla funktioner vars signatur slutar med / tar bara positionsargument. För mer information, se PEP 570.

Exempel¶

Till exempel är detta signaturen för konstruktorn socket.socket i CPython 3.4:

socket.socket(family=AF_INET, type=SOCK_STREAM, proto=0, fileno=None)

Signaturen som dokumenterats i MicroPython är dock:

socket(af=AF_INET, type=SOCK_STREAM, proto=IPPROTO_TCP, /)

/ i slutet av parametrarna anger att de alla är enbart positionella i MicroPython. Följande kod fungerar i CPython men inte i de flesta MicroPython-portar:

import socket
s = socket.socket(type=socket.SOCK_DGRAM)

MicroPython kommer att generera ett undantag:

TypeError: function doesn't take keyword arguments

Följande kod fungerar i både CPython och MicroPython:

import socket
s = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)

array¶

Jämförelse mellan olika typkoder stöds inte¶

Orsak: Kodstorlek

Lösning: Jämför enskilda element

Exempelkod:

import array

array.array("b", [1, 2]) == array.array("i", [1, 2])

CPython output:	MicroPython output:
	Traceback (most recent call last): File "<stdin>", line 10, in <module> NotImplementedError:

Spill-kontroll är inte implementerat¶

Orsak: MicroPython implementerar implicit trunkering för att minska kodstorlek och exekveringstid

Lösning: Om CPython-kompatibilitet krävs, maskera värdet explicit

Exempelkod:

import array

a = array.array("b", [257])
print(a)

CPython output:	MicroPython output:
Traceback (most recent call last): File "<stdin>", line 10, in <module> OverflowError: signed char is greater than maximum	array('b', [1])

Sökning efter heltal är inte implementerat¶

Exempelkod:

import array

print(1 in array.array("B", b"12"))

CPython output:	MicroPython output:
False	Traceback (most recent call last): File "<stdin>", line 10, in <module> NotImplementedError:

Arrayborttagning är inte implementerat¶

Exempelkod:

import array

a = array.array("b", (1, 2, 3))
del a[1]
print(a)

CPython output:	MicroPython output:
array('b', [1, 3])	Traceback (most recent call last): File "<stdin>", line 11, in <module> TypeError: 'array' object doesn't support item deletion

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

Exempelkod:

import array

a = array.array("b", (1, 2, 3))
print(a[3:2:2])

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

errno¶

MicroPython does not include `ENOTSUP` as a name for errno 95.¶

Cause: MicroPython does not implement the ENOTSUP canonical alias for EOPNOTSUPP added in CPython 3.2.

Workaround: Use errno.EOPNOTSUPP in place of errno.ENOTSUP.

Exempelkod:

import errno

print(f"{errno.errorcode[errno.EOPNOTSUPP]=!s}")

CPython output:	MicroPython output:
errno.errorcode[errno.EOPNOTSUPP]=ENOTSUP	errno.errorcode[errno.EOPNOTSUPP]=EOPNOTSUPP

json¶

JSON-modulen kastar inte undantag när ett objekt inte kan serialiseras¶

Exempelkod:

import json

try:
    print(json.dumps(b"shouldn't be able to serialise bytes"))
except TypeError:
    print("TypeError")

CPython output:	MicroPython output:
TypeError	"shouldn't be able to serialise bytes"

os¶

Attributet `environ` är inte implementerat¶

Lösning: Använd getenv, putenv och unsetenv

Exempelkod:

import os

try:
    print(os.environ.get("NEW_VARIABLE"))
    os.environ["NEW_VARIABLE"] = "VALUE"
    print(os.environ["NEW_VARIABLE"])
except AttributeError:
    print("should not get here")
    print(os.getenv("NEW_VARIABLE"))
    os.putenv("NEW_VARIABLE", "VALUE")
    print(os.getenv("NEW_VARIABLE"))

CPython output:	MicroPython output:
None VALUE	should not get here None VALUE

`getenv` returnerar det faktiska värdet istället för ett cachat värde¶

Orsak: Attributet environ är inte implementerat

Exempelkod:

import os

print(os.getenv("NEW_VARIABLE"))
os.putenv("NEW_VARIABLE", "VALUE")
print(os.getenv("NEW_VARIABLE"))

CPython output:	MicroPython output:
None None	None VALUE

random¶

Metoden `getrandbits` kan bara returnera maximalt 32 bitar åt gången.¶

Orsak: PRNG:s interna tillstånd är bara 32 bitar så den kan bara returnera maximalt 32 bitar data åt gången.

Lösning: Om du behöver ett tal med fler än 32 bitar, använd random-modulen från micropython-lib.

Exempelkod:

import random


x = random.getrandbits(64)
print("{}".format(x))

CPython output:	MicroPython output:
10880755926996596610	Traceback (most recent call last): File "<stdin>", line 11, in <module> ValueError: bits must be 32 or less

Metoden `randint` kan bara returnera ett heltal som är högst det inbyggda ordstorleken.¶

Orsak: PRNG kan bara generera 32 bitar tillstånd åt gången. Resultatet konverteras sedan till ett heltal med inbyggd storlek istället för ett fullständigt int-objekt.

Lösning: Om du behöver heltal större än det inbyggda ordstorleken, använd random-modulen från micropython-lib.

Exempelkod:

import random


x = random.randint(2**128 - 1, 2**128)
print("x={}".format(x))

CPython output:	MicroPython output:
x=340282366920938463463374607431768211456	Traceback (most recent call last): File "<stdin>", line 11, in <module> OverflowError: overflow converting long int to machine word

struct¶

Struct pack with too few args, not checked by MicroPython¶

Exempelkod:

import struct

try:
    print(struct.pack("bb", 1))
    print("Should not get here")
except:
    print("struct.error")

CPython output:	MicroPython output:
struct.error	b'\x01\x00' Should not get here

Struct pack with too many args, not checked by MicroPython¶

Exempelkod:

import struct

try:
    print(struct.pack("bb", 1, 2, 3))
    print("Should not get here")
except:
    print("struct.error")

CPython output:	MicroPython output:
struct.error	b'\x01\x02' Should not get here

Struct pack with whitespace in format, whitespace ignored by CPython, error on MicroPython¶

Orsak: MicroPython är optimerat för kodstorlek.

Lösning: Använd inte mellanslag i formatsträngar.

Exempelkod:

import struct

try:
    print(struct.pack("b b", 1, 2))
    print("Should have worked")
except:
    print("struct.error")

CPython output:	MicroPython output:
b'\x01\x02' Should have worked	struct.error

sys¶

Det är inte möjligt att åsidosätta sys.stdin, sys.stdout och sys.stderr¶

Orsak: De lagras i skrivskyddat minne.

Exempelkod:

import sys

sys.stdin = None
print(sys.stdin)

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

Moduler¶

Enbart positionsparametrar¶

Exempel¶

array¶

Jämförelse mellan olika typkoder stöds inte¶

Spill-kontroll är inte implementerat¶

Sökning efter heltal är inte implementerat¶

Arrayborttagning är inte implementerat¶

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

errno¶

MicroPython does not include ENOTSUP as a name for errno 95.¶

json¶

JSON-modulen kastar inte undantag när ett objekt inte kan serialiseras¶

os¶

Attributet environ är inte implementerat¶

getenv returnerar det faktiska värdet istället för ett cachat värde¶

random¶

Metoden getrandbits kan bara returnera maximalt 32 bitar åt gången.¶

Metoden randint kan bara returnera ett heltal som är högst det inbyggda ordstorleken.¶

struct¶

Struct pack with too few args, not checked by MicroPython¶

Struct pack with too many args, not checked by MicroPython¶

Struct pack with whitespace in format, whitespace ignored by CPython, error on MicroPython¶

sys¶

Det är inte möjligt att åsidosätta sys.stdin, sys.stdout och sys.stderr¶

MicroPython does not include `ENOTSUP` as a name for errno 95.¶

Attributet `environ` är inte implementerat¶

`getenv` returnerar det faktiska värdet istället för ett cachat värde¶

Metoden `getrandbits` kan bara returnera maximalt 32 bitar åt gången.¶

Metoden `randint` kan bara returnera ett heltal som är högst det inbyggda ordstorleken.¶