Module¶
Generated Fri 19 Jun 2026 22:08:45 UTC
Parametri exclusiv pozițional¶
Pentru a economisi spațiu de cod, multe funcții care acceptă argumente cheie în CPython acceptă doar argumente poziționale în MicroPython.
MicroPython marchează parametrii exclusiv pozițional în același mod ca CPython, inserând un / pentru a marca sfârșitul parametrilor pozițional. Orice funcție a cărei semnătură se termină cu / acceptă numai argumente poziționale. Pentru mai multe detalii, consultați PEP 570.
Exemplu¶
De exemplu, în CPython 3.4 aceasta este semnătura constructorului socket.socket:
socket.socket(family=AF_INET, type=SOCK_STREAM, proto=0, fileno=None)
Cu toate acestea, semnătura documentată în MicroPython este:
socket(af=AF_INET, type=SOCK_STREAM, proto=IPPROTO_TCP, /)
/ la sfârșitul parametrilor indică faptul că toți sunt exclusiv pozițional în MicroPython. Următorul cod funcționează în CPython, dar nu în majoritatea porturilor MicroPython:
import socket
s = socket.socket(type=socket.SOCK_DGRAM)
MicroPython va ridica o excepție:
TypeError: function doesn't take keyword arguments
Următorul cod va funcționa atât în CPython, cât și în MicroPython:
import socket
s = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
array¶
Compararea între coduri de tip diferite nu este suportată¶
Cauză: Dimensiunea codului
Soluție alternativă: Comparați elementele individuale
Cod exemplu:
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:
|
Verificarea depășirii nu este implementată¶
Cauză: MicroPython implementează trunchierea implicită pentru a reduce dimensiunea codului și timpul de execuție
Soluție alternativă: Dacă este necesară compatibilitatea cu CPython, mascați explicit valoarea
Cod exemplu:
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])
|
Căutarea unui număr întreg nu este implementată¶
Cod exemplu:
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:
|
Ștergerea din array nu este implementată¶
Cod exemplu:
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
|
Subscrierea cu pas != 1 nu este încă implementată¶
Cod exemplu:
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.
Cod exemplu:
import errno
print(f"{errno.errorcode[errno.EOPNOTSUPP]=!s}")
CPython output: | MicroPython output: |
errno.errorcode[errno.EOPNOTSUPP]=ENOTSUP
| errno.errorcode[errno.EOPNOTSUPP]=EOPNOTSUPP
|
json¶
Modulul JSON nu aruncă o excepție când obiectul nu este serializabil¶
Cod exemplu:
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¶
Atributul environ nu este implementat¶
Soluție alternativă: Folosiți getenv, putenv și unsetenv
Cod exemplu:
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 returnează valoarea actuală în loc de valoarea din cache¶
Cauză: Atributul environ nu este implementat
Cod exemplu:
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¶
Metoda getrandbits poate returna cel mult 32 de biți odată.¶
Cauză: Starea internă a PRNG-ului este de doar 32 de biți, deci poate returna cel mult 32 de biți de date odată.
Soluție alternativă: Dacă aveți nevoie de un număr cu mai mult de 32 de biți, utilizați modulul random din micropython-lib.
Cod exemplu:
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
|
Metoda randint poate returna doar un număr întreg de cel mult dimensiunea cuvântului nativ.¶
Cauză: PRNG-ul poate genera doar 32 de biți de stare odată. Rezultatul este apoi convertit într-un int de dimensiunea nativă, nu într-un obiect int complet.
Soluție alternativă: Dacă aveți nevoie de numere întregi mai mari decât dimensiunea cuvântului nativ, utilizați modulul random din micropython-lib.
Cod exemplu:
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¶
Cod exemplu:
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¶
Cod exemplu:
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¶
Cauză: MicroPython este optimizat pentru dimensiunea codului.
Soluție alternativă: Nu folosiți spații în șirurile de format.
Cod exemplu:
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¶
Suprascrierea sys.stdin, sys.stdout și sys.stderr nu este posibilă¶
Cauză: Acestea sunt stocate în memorie de tip read-only.
Cod exemplu:
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'
|