builtins — funções e exceções embutidas

Todas as funções e exceções embutidas estão descritas aqui. Elas também estão disponíveis através do módulo builtins.

Funções e tipos

abs(x: Any) → Any

Retorna o valor absoluto de um número. O argumento pode ser um inteiro, um float ou qualquer objeto que implemente __abs__().

all(iterable: Iterable[Any]) → bool

Retorna True se todos os elementos de iterable forem verdadeiros (ou se o iterável estiver vazio).

any(iterable: Iterable[Any]) → bool

Retorna True se algum elemento de iterable for verdadeiro. Retorna False se o iterável estiver vazio.

bin(x: int) → str

Converte um inteiro em uma string binária prefixada com "0b". O argumento deve ser um inteiro Python ou implementar __index__().

class bool(x: Any = False)

Retorna um valor booleano, ou seja, True ou False. x é convertido usando o procedimento padrão de teste de verdade.

class bytearray(source: int | str | Iterable[int] | bytes = b'', encoding: str = 'utf-8', errors: str = 'strict')

Sequência mutável de inteiros no intervalo 0-255. A construção segue as mesmas regras de bytes: a partir de um inteiro (criando um buffer preenchido com zeros desse tamanho), de um iterável de inteiros, de uma string com encoding ou de qualquer objeto que suporte o protocolo de buffer. Suporta as operações de sequência padrão, além de modificação no local.

classmethod fromhex(string: str) → bytearray

Constrói um bytearray a partir de uma string de pares de dígitos hexadecimais. Espaços em branco entre pares de dígitos são ignorados; um caractere não hexadecimal levanta ValueError.

append(val: int) → None

Anexa um único valor (um inteiro no intervalo 0-255) ao final do bytearray, aumentando-o em um byte.

center(width: int, fillbyte: bytes) → bytes

Retorna uma cópia do conteúdo centralizada em uma sequência de comprimento width, preenchida com fillbyte. Diferentemente do CPython, fillbyte é obrigatório. Os dados são retornados sem alteração quando width não é maior que o comprimento atual.

count(sub: bytes, start: int = 0, end: int = -1) → int

Retorna o número de ocorrências não sobrepostas de sub na fatia [start:end].

endswith(suffix: bytes, start: int = 0, end: int = -1) → bool

Retorna True se o conteúdo termina com suffix. Diferentemente do CPython, suffix não pode ser uma tupla de valores.

extend(iterable: Iterable[int]) → None

Anexa todos os itens de iterable ao final do bytearray. Como uma extensão ao CPython, qualquer objeto que suporte o protocolo de buffer pode ser usado.

find(sub: bytes, start: int = 0, end: int = -1) → int

Retorna o menor índice onde sub é encontrado dentro da fatia [start:end], ou -1 se não for encontrado.

format(*args: Any, **kwargs: Any) → str

Realiza uma operação de formatação de string usando o conteúdo como a string de formato, retornando o resultado formatado.

hex(sep: str = '') → str

Retorna uma string de dois dígitos hexadecimais para cada byte. Se o sep opcional (uma string de comprimento 1) for fornecido, ele é inserido entre valores de bytes consecutivos.

index(sub: bytes, start: int = 0, end: int = -1) → int

Como find(), mas levanta ValueError quando sub não é encontrado.

isalpha() → bool

Retorna True se todos os bytes forem caracteres ASCII alfabéticos e houver ao menos um byte, caso contrário False.

isdigit() → bool

Retorna True se todos os bytes forem dígitos decimais ASCII e houver ao menos um byte, caso contrário False.

islower() → bool

Retorna True se todos os bytes com distinção de maiúsculas/minúsculas forem minúsculos e houver ao menos um byte com tal distinção, caso contrário False.

isspace() → bool

Retorna True se todos os bytes forem espaços em branco ASCII e houver ao menos um byte, caso contrário False.

isupper() → bool

Retorna True se todos os bytes com distinção de maiúsculas/minúsculas forem maiúsculos e houver ao menos um byte com tal distinção, caso contrário False.

join(iterable: Iterable[bytes]) → bytes

Retorna um objeto bytes que é a concatenação dos itens de iterable, usando o conteúdo do bytearray como separador.

lower() → bytes

Retorna uma cópia do conteúdo com todos os caracteres ASCII maiúsculos convertidos para minúsculos.

lstrip(chars: bytes | None = None) → bytes

Retorna uma cópia com os bytes iniciais removidos. chars especifica o conjunto de bytes a remover; se omitido ou None, espaços em branco ASCII são removidos.

partition(sep: bytes) → tuple

Divide na primeira ocorrência de sep, retornando (head, sep, tail). Se sep não for encontrado, retorna o conteúdo seguido de dois objetos vazios.

replace(old: bytes, new: bytes, count: int = -1) → bytes

Retorna uma cópia com todas as ocorrências de old substituídas por new. Se count for fornecido, apenas as primeiras count ocorrências são substituídas.

rfind(sub: bytes, start: int = 0, end: int = -1) → int

Retorna o maior índice onde sub é encontrado dentro da fatia [start:end], ou -1 se não for encontrado.

rindex(sub: bytes, start: int = 0, end: int = -1) → int

Como rfind(), mas levanta ValueError quando sub não é encontrado.

rpartition(sep: bytes) → tuple

Divide na última ocorrência de sep, retornando (head, sep, tail). Se sep não for encontrado, retorna dois objetos vazios seguidos do conteúdo.

rsplit(sep: bytes | None = None, maxsplit: int = -1) → list

Divide nas ocorrências de sep em uma lista de pedaços, realizando no máximo maxsplit divisões contadas a partir da direita. Se sep for None ou omitido, divide em sequências de espaços em branco ASCII.

rstrip(chars: bytes | None = None) → bytes

Retorna uma cópia com os bytes finais removidos. chars especifica o conjunto de bytes a remover; se omitido ou None, espaços em branco ASCII são removidos.

split(sep: bytes | None = None, maxsplit: int = -1) → list

Divide nas ocorrências de sep em uma lista de pedaços. Se sep for None ou omitido, divide em sequências de espaços em branco ASCII e espaços em branco iniciais/finais são ignorados.

splitlines(keepends: bool = False) → list

Retorna uma lista das linhas, quebrando em \n, \r e \r\n. As quebras de linha são excluídas a menos que keepends seja verdadeiro.

startswith(prefix: bytes, start: int = 0, end: int = -1) → bool

Retorna True se o conteúdo começa com prefix. Diferentemente do CPython, prefix não pode ser uma tupla, e end é aceito mas ignorado.

strip(chars: bytes | None = None) → bytes

Retorna uma cópia com os bytes iniciais e finais removidos. chars especifica o conjunto de bytes a remover; se omitido ou None, espaços em branco ASCII são removidos.

upper() → bytes

Retorna uma cópia do conteúdo com todos os caracteres ASCII minúsculos convertidos para maiúsculos.

class bytes(source: int | str | Iterable[int] = b'', encoding: str = 'utf-8', errors: str = 'strict')

Sequência imutável de inteiros no intervalo 0-255. Criada a partir de um inteiro (buffer preenchido com zeros), de um iterável de inteiros, de uma string com encoding ou de qualquer objeto que suporte o protocolo de buffer. Literais de bytes usam a sintaxe b'...'.

classmethod fromhex(string: str) → bytes

Constrói um objeto bytes a partir de uma string de pares de dígitos hexadecimais. Espaços em branco entre pares de dígitos são ignorados; um caractere não hexadecimal levanta ValueError.

center(width: int, fillbyte: bytes) → bytes

Retorna uma cópia centralizada em uma sequência de comprimento width, preenchida com fillbyte (um bytes de comprimento 1 que fornece o byte de preenchimento). Diferentemente do CPython, fillbyte é obrigatório. O objeto original é retornado sem alteração quando width não é maior que seu comprimento.

count(sub: bytes, start: int = 0, end: int = -1) → int

Retorna o número de ocorrências não sobrepostas de sub na fatia [start:end].

decode(encoding: str = 'utf-8') → str

Retorna um str decodificado dos bytes. No MicroPython, o argumento encoding é aceito mas efetivamente ignorado (os bytes são reinterpretados como UTF-8).

endswith(suffix: bytes, start: int = 0, end: int = -1) → bool

Retorna True se os bytes terminam com suffix. Diferentemente do CPython, suffix não pode ser uma tupla de valores a testar.

find(sub: bytes, start: int = 0, end: int = -1) → int

Retorna o menor índice onde a subsequência sub é encontrada dentro da fatia [start:end], ou -1 se não for encontrada.

format(*args: Any, **kwargs: Any) → str

Realiza uma operação de formatação de string usando os bytes como a string de formato, retornando o resultado formatado.

hex(sep: str = '') → str

Retorna uma string de dois dígitos hexadecimais para cada byte. Se o sep opcional (uma string de comprimento 1) for fornecido, ele é inserido entre valores de bytes consecutivos.

index(sub: bytes, start: int = 0, end: int = -1) → int

Como find(), mas levanta ValueError quando sub não é encontrado.

isalpha() → bool

Retorna True se todos os bytes forem caracteres ASCII alfabéticos e houver ao menos um byte, caso contrário False.

isdigit() → bool

Retorna True se todos os bytes forem dígitos decimais ASCII e houver ao menos um byte, caso contrário False.

islower() → bool

Retorna True se todos os bytes com distinção de maiúsculas/minúsculas forem minúsculos e houver ao menos um byte com tal distinção, caso contrário False.

isspace() → bool

Retorna True se todos os bytes forem espaços em branco ASCII e houver ao menos um byte, caso contrário False.

isupper() → bool

Retorna True se todos os bytes com distinção de maiúsculas/minúsculas forem maiúsculos e houver ao menos um byte com tal distinção, caso contrário False.

join(iterable: Iterable[bytes]) → bytes

Retorna um objeto bytes que é a concatenação dos itens de iterable, usando o próprio objeto bytes como separador.

lower() → bytes

Retorna uma cópia com todos os caracteres ASCII maiúsculos convertidos para minúsculos.

lstrip(chars: bytes | None = None) → bytes

Retorna uma cópia com os bytes iniciais removidos. chars especifica o conjunto de bytes a remover; se omitido ou None, espaços em branco ASCII são removidos.

partition(sep: bytes) → tuple

Divide na primeira ocorrência de sep, retornando (head, sep, tail). Se sep não for encontrado, retorna os bytes seguidos de dois objetos bytes vazios.

replace(old: bytes, new: bytes, count: int = -1) → bytes

Retorna uma cópia com todas as ocorrências de old substituídas por new. Se count for fornecido, apenas as primeiras count ocorrências são substituídas.

rfind(sub: bytes, start: int = 0, end: int = -1) → int

Retorna o maior índice onde sub é encontrado dentro da fatia [start:end], ou -1 se não for encontrado.

rindex(sub: bytes, start: int = 0, end: int = -1) → int

Como rfind(), mas levanta ValueError quando sub não é encontrado.

rpartition(sep: bytes) → tuple

Divide na última ocorrência de sep, retornando (head, sep, tail). Se sep não for encontrado, retorna dois objetos bytes vazios seguidos dos bytes.

rsplit(sep: bytes | None = None, maxsplit: int = -1) → list

Divide nas ocorrências de sep em uma lista de pedaços, realizando no máximo maxsplit divisões contadas a partir da direita. Se sep for None ou omitido, divide em sequências de espaços em branco ASCII.

rstrip(chars: bytes | None = None) → bytes

Retorna uma cópia com os bytes finais removidos. chars especifica o conjunto de bytes a remover; se omitido ou None, espaços em branco ASCII são removidos.

split(sep: bytes | None = None, maxsplit: int = -1) → list

Divide nas ocorrências de sep em uma lista de pedaços. Se sep for None ou omitido, divide em sequências de espaços em branco ASCII e espaços em branco iniciais/finais são ignorados.

splitlines(keepends: bool = False) → list

Retorna uma lista das linhas, quebrando em \n, \r e \r\n. As quebras de linha são excluídas a menos que keepends seja verdadeiro.

startswith(prefix: bytes, start: int = 0, end: int = -1) → bool

Retorna True se os bytes começam com prefix. Diferentemente do CPython, prefix não pode ser uma tupla, e end é aceito mas ignorado.

strip(chars: bytes | None = None) → bytes

Retorna uma cópia com os bytes iniciais e finais removidos. chars especifica o conjunto de bytes a remover; se omitido ou None, espaços em branco ASCII são removidos.

upper() → bytes

Retorna uma cópia com todos os caracteres ASCII minúsculos convertidos para maiúsculos.

callable(obj: Any) → bool

Retorna True se obj parecer ser chamável, False caso contrário.

chr(i: int) → str

Retorna uma string de um caractere cujo ponto de código Unicode é o inteiro i.

classmethod(func: Callable[..., Any]) → classmethod

Transforma um método em um método de classe. Tipicamente usado como decorador.

compile(source: str | bytes, filename: str, mode: str) → Any

Compila source em um objeto de código que pode ser executado por exec() ou eval(). mode é um dentre "exec", "eval" ou "single".

class complex(real: float | str = 0, imag: float = 0)

Cria um número complexo a partir de uma parte real e uma imaginária, ou a partir de uma string.

delattr(obj, name: str) → None

O argumento name deve ser uma string, e esta função exclui o atributo nomeado do objeto fornecido por obj.

class dict(*args, **kwargs)

Cria um novo dicionário. Equivalente ao dict do CPython.

classmethod fromkeys(iterable: Iterable[Any], value: Any = None) → dict

Cria um novo dicionário com chaves obtidas de iterable, cada uma mapeada para value (cujo padrão é None). Chamado sobre o tipo, por exemplo dict.fromkeys(...).

clear() → None

Remove todos os itens do dicionário, deixando-o vazio. Levanta TypeError se o dicionário for fixo (somente leitura).

copy() → dict

Retorna uma cópia rasa do dicionário. O objeto retornado tem o mesmo tipo que o original (dict ou OrderedDict), mas não é fixo.

get(key: Any, default: Any = None) → Any

Retorna o valor de key se ela estiver no dicionário, caso contrário retorna default (cujo próprio padrão é None, de modo que isso nunca levanta KeyError). O dicionário não é modificado.

items() → Any

Retorna um objeto de visão dinâmica sobre os pares (key, value) que reflete alterações subsequentes no dicionário e suporta iteração, len(), o operador in e os operadores de comparação de conjuntos.

keys() → Any

Retorna um objeto de visão dinâmica sobre as chaves que reflete alterações subsequentes no dicionário e suporta iteração, len(), o operador in e os operadores de comparação de conjuntos.

pop(key: Any, default: Any = None) → Any

Remove key do dicionário e retorna seu valor. Se key não estiver presente, retorna default se ele tiver sido fornecido; caso contrário, levanta KeyError. Levanta TypeError se o dicionário for fixo.

popitem() → tuple

Remove e retorna um par (key, value) arbitrário como uma tupla de 2 elementos. Para um dict comum, o par escolhido não é especificado; para um OrderedDict, o último par inserido é removido (LIFO). Levanta KeyError se o dicionário estiver vazio, ou TypeError se ele for fixo.

setdefault(key: Any, default: Any = None) → Any

Se key estiver no dicionário, retorna seu valor. Caso contrário, insere key com um valor de default (cujo padrão é None) e retorna esse valor. Levanta TypeError se o dicionário for fixo.

update(*args: Any, **kwargs: Any) → None

Atualiza o dicionário no local. No máximo um argumento posicional é aceito: ou outro dicionário, ou um iterável de pares (key, value) de dois elementos (cada um deve produzir exatamente dois itens, caso contrário ValueError é levantado). Argumentos nomeados são então adicionados como entradas com chaves de string. Chaves existentes são sobrescritas. Levanta TypeError se o dicionário for fixo.

values() → Any

Retorna um objeto de visão dinâmica sobre os valores que reflete alterações subsequentes no dicionário e suporta iteração e len().

__getitem__(key: Any) → Any

Retorna self[key]. Implementa o operador de indexação d[key]; levanta KeyError se key não estiver presente.

__setitem__(key: Any, value: Any) → None

Define self[key] como value. Implementa d[key] = value.

__delitem__(key: Any) → None

Exclui self[key]. Implementa del d[key]; levanta KeyError se key não estiver presente.

dir(obj: Any = None) → list

Sem argumentos, retorna a lista de nomes no escopo local atual. Com um argumento, retorna uma lista de atributos válidos para aquele objeto.

divmod(a: Any, b: Any) → tuple

Retorna o par (a // b, a % b) como uma tupla, para dois números (não complexos).

enumerate(iterable: Iterable[Any], start: int = 0) → Iterator[tuple]

Retorna um objeto enumerate que produz pares (index, value) a partir de iterable, com o índice começando em start.

eval(expression: str | bytes, globals: dict | None = None, locals: dict | None = None) → Any

Avalia uma expressão Python fornecida como uma string (ou objeto de código compilado) e retorna o resultado.

exec(object: str | bytes, globals: dict | None = None, locals: dict | None = None) → None

Executa dinamicamente código Python fornecido como uma string ou objeto de código compilado.

filter(function: Callable[[Any], Any] | None, iterable: Iterable[Any]) → Iterator[Any]

Constrói um iterador a partir dos elementos de iterable para os quais function retorna verdadeiro. Se function for None, assume-se a função identidade.

class float(x: str | bytes | int | float = 0.0)

Retorna um número de ponto flutuante construído a partir de um número ou string x.

class frozenset(iterable: Iterable[Any] = ())

Retorna um novo objeto frozenset, opcionalmente com elementos obtidos de iterable. frozenset é uma variante imutável e hasheável de set.

copy() → frozenset

Retorna uma cópia rasa do frozenset.

difference(*others: Iterable[Any]) → frozenset

Retorna um novo frozenset com elementos do frozenset que não estão em nenhum de others. Cada argumento pode ser qualquer iterável.

intersection(other: Iterable[Any]) → frozenset

Retorna um novo frozenset com elementos comuns ao frozenset e a other. No MicroPython, apenas um único argumento other é aceito (o CPython aceita vários).

isdisjoint(other: Iterable[Any]) → bool

Retorna True se o frozenset não tiver elementos em comum com other.

issubset(other: Iterable[Any]) → bool

Retorna True se todo elemento do frozenset estiver em other.

issuperset(other: Iterable[Any]) → bool

Retorna True se todo elemento de other estiver no frozenset.

symmetric_difference(other: Iterable[Any]) → frozenset

Retorna um novo frozenset com elementos que estão no frozenset ou em other, mas não em ambos. No MicroPython, apenas um único argumento other é aceito.

union(other: Iterable[Any]) → frozenset

Retorna um novo frozenset com elementos do frozenset e de other. No MicroPython, apenas um único argumento other é aceito (o CPython aceita vários).

getattr(obj: Any, name: str, default: Any = None) → Any

Retorna o valor do atributo nomeado de obj. Se o atributo não existir, default é retornado se fornecido, caso contrário AttributeError é levantado.

globals() → dict

Retorna um dicionário que representa a tabela de símbolos globais do módulo atual.

hasattr(obj: Any, name: str) → bool

Retorna True se obj tiver um atributo com o name fornecido, False caso contrário.

hash(obj: Any) → int

Retorna o valor de hash de obj (se ele tiver um). Valores de hash são inteiros usados para comparar rapidamente chaves de dicionário durante uma busca em dicionário.

hex(x: int) → str

Converte um inteiro em uma string hexadecimal minúscula prefixada com "0x".

id(obj: Any) → int

Retorna a identidade de um objeto. Trata-se de um inteiro garantidamente único e constante para este objeto durante seu tempo de vida.

input(prompt: str = '') → str

Lê uma linha da entrada padrão e a retorna como uma string (sem a nova linha final). Se prompt for fornecido, ele é escrito na saída padrão sem uma nova linha final primeiro.

class int(x: str | bytes | int | float = 0, base: int = 10)

classmethod from_bytes(bytes: bytes, byteorder: str) → int

No MicroPython, o parâmetro byteorder deve ser posicional (isso é compatível com o CPython).

to_bytes(size: int, byteorder: str) → bytes

No MicroPython, o parâmetro byteorder deve ser posicional (isso é compatível com o CPython).

Nota

O argumento nomeado opcional signed do CPython não é suportado. O MicroPython atualmente converte inteiros negativos como sinalizados e positivos como não sinalizados. (Detalhes.)

isinstance(obj: Any, classinfo: type | tuple) → bool

Retorna True se obj for uma instância de classinfo ou de qualquer uma de suas subclasses. classinfo pode ser uma classe ou uma tupla de classes.

issubclass(cls: type, classinfo: type | tuple) → bool

Retorna True se cls for uma subclasse (direta, indireta ou virtual) de classinfo.

iter(obj: Any, sentinel: Any = None) → Iterator[Any]

Retorna um objeto iterador. Com um argumento, obj deve suportar o protocolo de iteração. Com dois argumentos, obj deve ser chamável e a iteração para quando ele retorna sentinel.

len(obj: Any) → int

Retorna o número de itens em um contêiner.

class list(iterable: Iterable[Any] = ())

Constrói uma nova lista, opcionalmente preenchida a partir dos itens de iterable.

append(object: Any) → None

Anexa object ao final da lista.

clear() → None

Remove todos os itens da lista, deixando-a vazia.

copy() → list

Retorna uma cópia rasa da lista.

count(value: Any) → int

Retorna o número de elementos na lista que são iguais a value.

extend(iterable: Iterable[Any]) → None

Anexa todos os itens de iterable ao final da lista. Se iterable for ele próprio uma lista, seus itens são copiados diretamente; caso contrário, ele é iterado.

index(value: Any, start: int = 0, stop: int = -1) → int

Retorna o índice do primeiro elemento igual a value, pesquisando na fatia [start:stop]. Levanta ValueError se value não estiver presente.

insert(index: int, object: Any) → None

Insere object antes da posição index. Um index negativo é interpretado em relação ao final da lista, e o índice é limitado ao intervalo válido (de modo que valores além de qualquer uma das extremidades inserem no início ou no fim).

pop(index: int = -1) → Any

Remove e retorna o item em index (o último item por padrão). Levanta IndexError se a lista estiver vazia ou index estiver fora do intervalo.

remove(value: Any) → None

Remove o primeiro elemento igual a value. Levanta ValueError se value não estiver presente.

reverse() → None

Inverte os itens da lista no local.

sort(*, key: Callable[[Any], Any] | None = None, reverse: bool = False) → None

Ordena os itens da lista no local. key e reverse são somente nomeados. key, se fornecido, é uma função aplicada a cada elemento para produzir o valor de comparação; reverse ordena em ordem decrescente.

Nota

Diferentemente do CPython, a ordenação de lista do MicroPython não é estável.

locals() → dict

Retorna um dicionário que representa a tabela de símbolos locais atual.

map(function: Callable[..., Any], *iterables: Iterable[Any]) → Iterator[Any]

Retorna um iterador que aplica function a cada item de iterables, produzindo os resultados.

max(*args: Any, key: Callable[[Any], Any] | None = None, default: Any = None) → Any

Com um único argumento iterável, retorna seu maior item. Com dois ou mais argumentos, retorna o maior argumento.

class memoryview(obj: Any)

Cria um memoryview que referencia obj, que deve suportar o protocolo de buffer (por exemplo, bytes, bytearray, array.array). Permite acesso e fatiamento sem cópia da memória subjacente; fatiar um memoryview retorna outro memoryview em vez de uma cópia.

min(*args: Any, key: Callable[[Any], Any] | None = None, default: Any = None) → Any

Com um único argumento iterável, retorna seu menor item. Com dois ou mais argumentos, retorna o menor argumento.

next(iterator: Iterator[Any], default: Any = None) → Any

Recupera o próximo item de iterator. Se default for fornecido e o iterador estiver esgotado, default é retornado em vez de levantar StopIteration.

class object

Retorna um novo objeto sem características. object é a classe base de todas as classes.

oct(x: int) → str

Converte um inteiro em uma string octal prefixada com "0o".

open(file: str, mode: str = 'r', **kwargs) → Any

Abre file e retorna um objeto de arquivo correspondente. mode tem como padrão "r" para leitura de texto.

ord(c: str) → int

Retorna o ponto de código Unicode de uma string de um único caractere c como um inteiro.

pow(base: Any, exp: Any, mod: Any | None = None) → Any

Retorna base elevado à potência exp. Se mod for fornecido, retorna base ** exp % mod (calculado de forma mais eficiente que a forma explícita).

print(*objects: Any, sep: str = ' ', end: str = '\n', file: Any = None) → None

Imprime objects no fluxo de texto file, separados por sep e seguidos por end.

property(fget: Callable[[Any], Any] | None = None, fset: Callable[[Any, Any], None] | None = None, fdel: Callable[[Any], None] | None = None, doc: str | None = None) → property

Retorna um atributo de propriedade. Tipicamente usado como decorador para definir atributos gerenciados em uma classe.

range(*args: int) → range

Retorna uma sequência imutável de inteiros. Chamado como range(stop), range(start, stop) ou range(start, stop, step).

repr(obj: Any) → str

Retorna uma string contendo uma representação imprimível de obj.

reversed(seq: Any) → Iterator[Any]

Retorna um iterador reverso sobre os valores da sequência fornecida.

round(number: Any, ndigits: int | None = None) → Any

Retorna number arredondado para ndigits casas decimais. Se ndigits for omitido, retorna o inteiro mais próximo.

class set(iterable: Iterable[Any] = ())

Retorna um novo objeto set, opcionalmente com elementos obtidos de iterable.

add(elem: Any) → None

Adiciona o elemento elem ao conjunto.

clear() → None

Remove todos os elementos do conjunto.

copy() → set

Retorna uma cópia rasa do conjunto.

difference(*others: Iterable[Any]) → set

Retorna um novo conjunto com elementos do conjunto que não estão em nenhum de others. Cada argumento pode ser qualquer iterável.

difference_update(*others: Iterable[Any]) → None

Remove do conjunto todos os elementos encontrados em qualquer um de others (no local).

discard(elem: Any) → None

Remove o elemento elem do conjunto se ele estiver presente. Diferentemente de remove(), isto não levanta um erro se elem estiver ausente.

intersection(other: Iterable[Any]) → set

Retorna um novo conjunto com elementos comuns ao conjunto e a other. No MicroPython, apenas um único argumento other é aceito (o CPython aceita vários).

intersection_update(other: Iterable[Any]) → None

Atualiza o conjunto, mantendo apenas os elementos também encontrados em other (no local). No MicroPython, apenas um único argumento other é aceito.

isdisjoint(other: Iterable[Any]) → bool

Retorna True se o conjunto não tiver elementos em comum com other.

issubset(other: Iterable[Any]) → bool

Retorna True se todo elemento do conjunto estiver em other.

issuperset(other: Iterable[Any]) → bool

Retorna True se todo elemento de other estiver no conjunto.

pop() → Any

Remove e retorna um elemento arbitrário do conjunto. Levanta KeyError se o conjunto estiver vazio.

remove(elem: Any) → None

Remove o elemento elem do conjunto. Levanta KeyError se elem não estiver contido no conjunto.

symmetric_difference(other: Iterable[Any]) → set

Retorna um novo conjunto com elementos que estão no conjunto ou em other, mas não em ambos. No MicroPython, apenas um único argumento other é aceito.

symmetric_difference_update(other: Iterable[Any]) → None

Atualiza o conjunto, mantendo apenas os elementos encontrados no conjunto ou em other, mas não em ambos (no local). No MicroPython, apenas um único argumento other é aceito.

union(other: Iterable[Any]) → set

Retorna um novo conjunto com elementos do conjunto e de other. No MicroPython, apenas um único argumento other é aceito (o CPython aceita vários).

update(*others: Iterable[Any]) → None

Atualiza o conjunto, adicionando elementos de todos os others (no local).

setattr(obj: Any, name: str, value: Any) → None

Define o atributo nomeado em obj como value. A contraparte de getattr().

class slice

O builtin slice é o tipo que os objetos slice têm.

sorted(iterable: Iterable[Any], key: Callable[[Any], Any] | None = None, reverse: bool = False) → list

Retorna uma nova lista ordenada a partir dos itens de iterable.

staticmethod(func: Callable[..., Any]) → staticmethod

Transforma um método em um método estático. Tipicamente usado como decorador.

class str(object: Any = '', encoding: str = 'utf-8', errors: str = 'strict')

Retorna uma versão em string de object. Se object for um objeto semelhante a bytes, os argumentos encoding e errors controlam a decodificação.

center(width: int) → str

Retorna uma cópia da string centralizada em um campo de comprimento width, preenchida com espaços. No MicroPython, apenas um espaço é usado como caractere de preenchimento (não há argumento de caractere de preenchimento), e a string original é retornada sem alteração quando width não é maior que seu comprimento.

count(sub: str, start: int = 0, end: int = -1) → int

Retorna o número de ocorrências não sobrepostas de sub na fatia [start:end]. Um sub vazio conta cada lacuna entre os caracteres.

encode(encoding: str = 'utf-8', errors: str = 'strict') → bytes

Retorna um objeto bytes que codifica a string. O MicroPython efetivamente ignora os argumentos e usa UTF-8; errors é aceito mas não é levado em conta. Equivalente a bytes(s, "utf-8").

endswith(suffix: str | tuple, start: int = 0, end: int = -1) → bool

Retorna True se a string termina com o suffix fornecido, que pode ser uma única string ou uma tupla de strings a testar. start e end opcionais restringem a comparação à fatia [start:end].

find(sub: str, start: int = 0, end: int = -1) → int

Retorna o menor índice na string onde a substring sub é encontrada dentro da fatia [start:end], ou -1 se não for encontrada.

format(*args: Any, **kwargs: Any) → str

Realiza uma operação de formatação de string, substituindo campos de substituição delimitados por chaves {} por valores de args e kwargs. Suporta a minilinguagem padrão de especificação de formato.

index(sub: str, start: int = 0, end: int = -1) → int

Como find(), mas levanta ValueError quando a substring sub não é encontrada na fatia [start:end].

isalpha() → bool

Retorna True se todos os caracteres na string forem alfabéticos e a string for não vazia, caso contrário False.

isdigit() → bool

Retorna True se todos os caracteres na string forem dígitos e a string for não vazia, caso contrário False.

islower() → bool

Retorna True se a string contiver ao menos um caractere alfabético e todos esses caracteres forem minúsculos, caso contrário False.

isspace() → bool

Retorna True se todos os caracteres na string forem espaços em branco e a string for não vazia, caso contrário False.

isupper() → bool

Retorna True se a string contiver ao menos um caractere alfabético e todos esses caracteres forem maiúsculos, caso contrário False.

join(iterable: Iterable[str]) → str

Concatena as strings em iterable, inserindo esta string como separador entre os elementos. Os itens devem ser strings, caso contrário TypeError é levantado.

lower() → str

Retorna uma cópia da string com todos os caracteres convertidos para minúsculos.

lstrip(chars: str | None = None) → str

Retorna uma cópia da string com os caracteres iniciais removidos. Se chars for omitido ou None, espaços em branco são removidos; caso contrário, chars é tratado como um conjunto de caracteres a remover.

partition(sep: str) → tuple

Divide a string na primeira ocorrência de sep e retorna uma tupla de 3 elementos (head, sep, tail). Se sep não for encontrado, retorna (self, "", ""). Um sep vazio levanta ValueError.

replace(old: str, new: str, count: int = -1) → str

Retorna uma cópia da string com todas as ocorrências da substring old substituídas por new. Se count for fornecido e não negativo, apenas as primeiras count ocorrências são substituídas.

rfind(sub: str, start: int = 0, end: int = -1) → int

Retorna o maior índice na string onde a substring sub é encontrada dentro da fatia [start:end], ou -1 se não for encontrada.

rindex(sub: str, start: int = 0, end: int = -1) → int

Como rfind(), mas levanta ValueError quando a substring sub não é encontrada na fatia [start:end].

rpartition(sep: str) → tuple

Divide a string na última ocorrência de sep e retorna uma tupla de 3 elementos (head, sep, tail). Se sep não for encontrado, retorna ("", "", self). Um sep vazio levanta ValueError.

rsplit(sep: str | None = None, maxsplit: int = -1) → list

Divide a string a partir da direita em uma lista de substrings usando sep como delimitador, realizando no máximo maxsplit divisões. Sem maxsplit (ou com um negativo), comporta-se de forma idêntica a split(); no MicroPython, rsplit(None, n) com um n não negativo levanta NotImplementedError.

rstrip(chars: str | None = None) → str

Retorna uma cópia da string com os caracteres finais removidos. Se chars for omitido ou None, espaços em branco são removidos; caso contrário, chars é tratado como um conjunto de caracteres a remover.

split(sep: str | None = None, maxsplit: int = -1) → list

Divide a string em uma lista de substrings usando sep como delimitador, realizando no máximo maxsplit divisões. Se sep for omitido ou None, divide em sequências de espaços em branco com espaços em branco iniciais ignorados; caso contrário, um sep vazio levanta ValueError.

splitlines(keepends: bool = False) → list

Retorna uma lista das linhas na string, quebrando em \n, \r e \r\n. As quebras de linha não são incluídas a menos que keepends seja verdadeiro.

startswith(prefix: str | tuple, start: int = 0, end: int = -1) → bool

Retorna True se a string começa com o prefix fornecido, que pode ser uma única string ou uma tupla de strings a testar. start e end opcionais restringem a comparação à fatia [start:end].

strip(chars: str | None = None) → str

Retorna uma cópia da string com os caracteres iniciais e finais removidos. Se chars for omitido ou None, espaços em branco são removidos; caso contrário, chars é tratado como um conjunto de caracteres a remover.

upper() → str

Retorna uma cópia da string com todos os caracteres convertidos para maiúsculos.

sum(iterable: Iterable[Any], start: Any = 0) → Any

Soma start e os itens de iterable da esquerda para a direita, e retorna o total.

super(type: type | None = None, obj_or_type: Any | None = None) → Any

Retorna um objeto proxy que delega chamadas de método para uma classe pai ou irmã de type. Útil para acessar métodos herdados que foram sobrescritos em uma classe.

class tuple(iterable: Iterable[Any] = ())

Constrói uma nova tupla, opcionalmente preenchida a partir dos itens de iterable. Tuplas são sequências imutáveis.

count(value: Any) → int

Retorna o número de elementos na tupla que são iguais a value.

index(value: Any, start: int = 0, stop: int = -1) → int

Retorna o índice do primeiro elemento igual a value, pesquisando na fatia [start:stop]. Levanta ValueError se value não estiver presente.

type(obj: Any) → type

Com um argumento, retorna o tipo de obj. O valor retornado é um objeto de tipo.

zip(*iterables: Iterable[Any]) → Iterator[tuple]

Retorna um iterador de tuplas, em que a i-ésima tupla contém o i-ésimo elemento de cada um dos iteráveis dos argumentos. A iteração para quando o menor iterável de entrada é esgotado.

Exceções

exception AssertionError

Levantada quando uma instrução assert falha.

exception AttributeError

Levantada quando uma referência ou atribuição de atributo falha.

exception Exception

Classe base comum a todas as exceções que não causam saída do sistema.

exception ImportError

Levantada quando uma instrução import falha em encontrar a definição do módulo.

exception IndexError

Levantada quando um índice de sequência está fora do intervalo.

exception KeyboardInterrupt

Levantada quando o usuário interrompe a execução do programa, geralmente pressionando Ctrl+C no REPL.

Veja também no contexto de Soft Bricking (falha ao inicializar).

exception KeyError

Levantada quando uma chave de mapeamento (dicionário) não é encontrada no conjunto de chaves existentes.

exception MemoryError

Levantada quando uma operação fica sem memória.

exception NameError

Levantada quando um nome local ou global não é encontrado.

exception NotImplementedError

Levantada quando um método abstrato ou recurso não implementado é invocado.

exception OSError

Levantada quando uma função do sistema retorna um erro relacionado ao sistema.

exception RuntimeError

Levantada quando é detectado um erro que não se enquadra em nenhuma das outras categorias.

exception StopIteration

Levantada por next() e pelo método __next__() de um iterador para sinalizar que não há mais itens.

exception SyntaxError

Levantada quando o analisador encontra um erro de sintaxe.

exception SystemExit

Levantada por sys.exit() para solicitar o encerramento do interpretador. Diferentemente da maioria das exceções, ela não produz um traceback quando não é capturada.

Na OpenMV Cam, um SystemExit não tratado atualmente causa um Soft Reset do MicroPython.

exception TypeError

Levantada quando uma operação ou função é aplicada a um objeto de tipo inapropriado.

exception ValueError

Levantada quando uma operação ou função embutida recebe um argumento do tipo correto, mas com um valor inapropriado.

exception ZeroDivisionError

Levantada quando o segundo argumento de uma operação de divisão ou módulo é zero.