Tipos embutidos¶

Generated Fri 19 Jun 2026 22:08:45 UTC

Exceção¶

Todas as exceções possuem os atributos legíveis `value` e `errno`, não apenas `StopIteration` e `OSError`.¶

Causa: MicroPython é otimizado para reduzir o tamanho do código.

Solução alternativa: Use value apenas em exceções StopIteration e errno apenas em exceções OSError. Não use nem dependa desses atributos em outras exceções.

Código de exemplo:

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

Encadeamento de exceções não implementado¶

Código de exemplo:

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:

Atributos definidos pelo usuário para exceções embutidas não são suportados¶

Causa: MicroPython é altamente otimizado para uso de memória.

Solução alternativa: Use subclasses de exceção definidas pelo usuário.

Código de exemplo:

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'

Exceção na condição de loop while pode ter número de linha inesperado¶

Causa: As verificações de condição são otimizadas para ocorrer no final do corpo do loop, e esse número de linha é reportado.

Código de exemplo:

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

O método Exception.init não existe.¶

Causa: A herança de classes nativas não é totalmente suportada no MicroPython.

Solução alternativa: Use a chamada com super() em vez disso:

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

Código de exemplo:

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.

Código de exemplo:

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¶

Atribuição de fatia de array com RHS não suportado¶

Código de exemplo:

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¶

Objetos bytes suportam o método .format()¶

Causa: MicroPython busca ser uma implementação mais regular; portanto, se tanto str quanto bytes suportam __mod__() (o operador %), faz sentido suportar format() para ambos também. O suporte a __mod__ também pode ser removido na compilação, deixando apenas format() para formatação de bytes.

Solução alternativa: Se você deseja compatibilidade com CPython, não use .format() em objetos bytes.

Código de exemplo:

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() com argumentos nomeados não implementado¶

Solução alternativa: Passe a codificação como parâmetro posicional, por exemplo: print(bytes('abc', 'utf-8'))

Código de exemplo:

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

Indexação de bytes com passo != 1 não implementada¶

Causa: MicroPython é altamente otimizado para uso de memória.

Solução alternativa: Use um loop explícito para esta operação muito rara.

Código de exemplo:

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¶

Causa: MicroPython é altamente otimizado para uso de memória.

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.

Código de exemplo:

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

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

dict¶

A visão de chaves de dicionário não se comporta como um conjunto.¶

Causa: Não implementado.

Solução alternativa: Converta explicitamente as chaves para um conjunto antes de usar operações de conjunto.

Código de exemplo:

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

Solução alternativa: Os objetos devem ser encapsulados em float(obj) para compatibilidade com CPython.

Código de exemplo:

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¶

O método `bit_length` não existe.¶

Causa: O método bit_length não está implementado.

Solução alternativa: Evite usar este método no MicroPython.

Código de exemplo:

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'

Nenhuma conversão int disponível para tipos derivados de int¶

Solução alternativa: Evite criar subclasses de tipos embutidos, a menos que seja realmente necessário. Prefira https://en.wikipedia.org/wiki/Composition_over_inheritance .

Código de exemplo:

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'

O método `to_bytes` não implementa o parâmetro signed.¶

Causa: O parâmetro exclusivamente nomeado signed não está implementado para int.to_bytes().

Quando o inteiro é negativo, MicroPython se comporta da mesma forma que CPython int.to_bytes(..., signed=True)

Quando o inteiro é não negativo, MicroPython se comporta da mesma forma que CPython int.to_bytes(..., signed=False).

(A diferença é sutil, mas no CPython um inteiro positivo convertido com signed=True pode exigir um byte a mais no comprimento da saída, para acomodar o bit de sinal 0.)

Solução alternativa: Tenha cuidado ao chamar to_bytes() em um valor inteiro que pode ser negativo.

Código de exemplo:

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¶

Exclusão de lista com passo != 1 não implementada¶

Solução alternativa: Use um loop explícito para esta operação rara.

Código de exemplo:

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:

Armazenamento de fatia de lista com não iterável no RHS não está implementado¶

Causa: O RHS está restrito a ser uma tupla ou lista

Solução alternativa: Use list(<iter>) no RHS para converter o iterável em uma lista

Código de exemplo:

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

Armazenamento em lista com passo != 1 não implementado¶

Solução alternativa: Use um loop explícito para esta operação rara.

Código de exemplo:

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 pode se tornar inválida se seu alvo for redimensionado¶

Causa: CPython impede que um objeto bytearray ou io.bytesIO mude de tamanho enquanto houver um objeto memoryview que o referencie. MicroPython exige que o programador garanta manualmente que um objeto não seja redimensionado enquanto alguma memoryview o referenciar.

No pior caso, redimensionar um objeto que é alvo de uma memoryview pode fazer com que a(s) memoryview(s) referencie(m) memória liberada inválida (um bug de uso após liberação) e corrompa(m) o ambiente de execução do MicroPython.

Solução alternativa: Não altere o tamanho de nenhum objeto bytearray ou io.bytesIO que tenha uma memoryview atribuída a ele.

Código de exemplo:

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

Código de exemplo:

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.

Código de exemplo:

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.

Código de exemplo:

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

Atributos/subscrito não implementados¶

Código de exemplo:

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(…) com argumentos nomeados não implementado¶

Solução alternativa: Informe o formato de codificação diretamente. Ex.: print(bytes('abc', 'utf-8'))

Código de exemplo:

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() e str.rjust() não implementados¶

Causa: MicroPython é altamente otimizado para uso de memória. Soluções alternativas simples estão disponíveis.

Solução alternativa: Em vez de s.ljust(10) use "%-10s" % s; em vez de s.rjust(10) use "% 10s" % s. Como alternativa, use "{:<10}".format(s) ou "{:>10}".format(s).

Código de exemplo:

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 como primeiro argumento de rsplit, como str.rsplit(None, n), não implementado¶

Código de exemplo:

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)

Subscrito com passo != 1 ainda não implementado¶

Código de exemplo:

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¶

Acesso a tupla com passo != 1 não implementado¶

Código de exemplo:

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

Tipos embutidos¶

Exceção¶

Todas as exceções possuem os atributos legíveis value e errno, não apenas StopIteration e OSError.¶

Encadeamento de exceções não implementado¶

Atributos definidos pelo usuário para exceções embutidas não são suportados¶

Exceção na condição de loop while pode ter número de linha inesperado¶

O método Exception.__init__ não existe.¶

OSError¶

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

bytearray¶

Atribuição de fatia de array com RHS não suportado¶

bytes¶

Objetos bytes suportam o método .format()¶

bytes() com argumentos nomeados não implementado¶

Indexação de bytes com passo != 1 não implementada¶

complex¶

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

dict¶

A visão de chaves de dicionário não se comporta como um conjunto.¶

float¶

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

int¶

O método bit_length não existe.¶

Nenhuma conversão int disponível para tipos derivados de int¶

O método to_bytes não implementa o parâmetro signed.¶

list¶

Exclusão de lista com passo != 1 não implementada¶

Armazenamento de fatia de lista com não iterável no RHS não está implementado¶

Armazenamento em lista com passo != 1 não implementado¶

memoryview¶

memoryview pode se tornar inválida se seu alvo for redimensionado¶

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¶

Atributos/subscrito não implementados¶

str(…) com argumentos nomeados não implementado¶

str.ljust() e str.rjust() não implementados¶

None como primeiro argumento de rsplit, como str.rsplit(None, n), não implementado¶

Subscrito com passo != 1 ainda não implementado¶

tuple¶

Acesso a tupla com passo != 1 não implementado¶

Todas as exceções possuem os atributos legíveis `value` e `errno`, não apenas `StopIteration` e `OSError`.¶

O método Exception.init não existe.¶

O método `bit_length` não existe.¶

O método `to_bytes` não implementa o parâmetro signed.¶