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

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

Funções e tipos

abs(x: Any) → Any

Devolve o valor absoluto de um número. O argumento pode ser um inteiro, um número de vírgula flutuante, ou qualquer objeto que implemente __abs__().

all(iterable: Iterable[Any]) → bool

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

any(iterable: Iterable[Any]) → bool

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

bin(x: int) → str

Converte um inteiro numa cadeia de caracteres binária com o prefixo "0b". O argumento tem de ser um inteiro Python ou implementar __index__().

class bool(x: Any = False)

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

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 que bytes: a partir de um inteiro (criando um buffer preenchido com zeros desse tamanho), de um iterável de inteiros, de uma cadeia de caracteres com encoding, ou de qualquer objeto que suporte o protocolo de buffer. Suporta as operações padrão de sequência, além de modificação no local.

classmethod fromhex(string: str) → bytearray

Constrói um bytearray a partir de uma cadeia de pares de dígitos hexadecimais. Os espaços em branco entre pares de dígitos são ignorados; um carácter não hexadecimal levanta ValueError.

append(val: int) → None

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

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

Devolve uma cópia do conteúdo centrada numa sequência de comprimento width, preenchida com fillbyte. Ao contrário do CPython, fillbyte é obrigatório. Os dados são devolvidos inalterados quando width não for maior do que o comprimento atual.

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

Devolve 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

Devolve True se o conteúdo terminar com suffix. Ao contrário do CPython, suffix não pode ser um tuplo de valores.

extend(iterable: Iterable[int]) → None

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

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

Devolve o índice mais baixo onde sub é encontrado na fatia [start:end], ou -1 se não for encontrado.

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

Realiza uma operação de formatação de cadeia de caracteres usando o conteúdo como cadeia de formato, devolvendo o resultado formatado.

hex(sep: str = '') → str

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

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

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

isalpha() → bool

Devolve True se todos os bytes forem carateres ASCII alfabéticos e existir pelo menos um byte, caso contrário False.

isdigit() → bool

Devolve True se todos os bytes forem dígitos decimais ASCII e existir pelo menos um byte, caso contrário False.

islower() → bool

Devolve True se todos os bytes com capitalização forem minúsculos e existir pelo menos um byte com capitalização, caso contrário False.

isspace() → bool

Devolve True se todos os bytes forem espaços em branco ASCII e existir pelo menos um byte, caso contrário False.

isupper() → bool

Devolve True se todos os bytes com capitalização forem maiúsculos e existir pelo menos um byte com capitalização, caso contrário False.

join(iterable: Iterable[bytes]) → bytes

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

lower() → bytes

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

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

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

partition(sep: bytes) → tuple

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

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

Devolve 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

Devolve o índice mais alto onde sub é encontrado na fatia [start:end], ou -1 se não for encontrado.

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

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

rpartition(sep: bytes) → tuple

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

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

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

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

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

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

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

splitlines(keepends: bool = False) → list

Devolve uma lista das linhas, dividindo em \n, \r e \r\n. As quebras de linha são excluídas, exceto se keepends for verdadeiro.

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

Devolve True se o conteúdo começar com prefix. Ao contrário do CPython, prefix não pode ser um tuplo, e end é aceite mas ignorado.

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

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

upper() → bytes

Devolve uma cópia do conteúdo com todos os carateres 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 cadeia de caracteres com encoding, ou de qualquer objeto que suporte o protocolo de buffer. Os literais bytes usam a sintaxe b'...'.

classmethod fromhex(string: str) → bytes

Constrói um objeto bytes a partir de uma cadeia de pares de dígitos hexadecimais. Os espaços em branco entre pares de dígitos são ignorados; um carácter não hexadecimal levanta ValueError.

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

Devolve uma cópia centrada numa sequência de comprimento width, preenchida com fillbyte (um bytes de comprimento 1 que indica o byte de preenchimento). Ao contrário do CPython, fillbyte é obrigatório. O objeto original é devolvido inalterado quando width não for maior do que o seu comprimento.

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

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

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

Devolve um str descodificado a partir dos bytes. No MicroPython, o argumento encoding é aceite mas efetivamente ignorado (os bytes são reinterpretados como UTF-8).

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

Devolve True se os bytes terminarem com suffix. Ao contrário do CPython, suffix não pode ser um tuplo de valores a experimentar.

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

Devolve o índice mais baixo onde a subsequência sub é encontrada na fatia [start:end], ou -1 se não for encontrada.

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

Realiza uma operação de formatação usando os bytes como cadeia de formato, devolvendo o resultado formatado.

hex(sep: str = '') → str

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

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

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

isalpha() → bool

Devolve True se todos os bytes forem carateres ASCII alfabéticos e existir pelo menos um byte, caso contrário False.

isdigit() → bool

Devolve True se todos os bytes forem dígitos decimais ASCII e existir pelo menos um byte, caso contrário False.

islower() → bool

Devolve True se todos os bytes com capitalização forem minúsculos e existir pelo menos um byte com capitalização, caso contrário False.

isspace() → bool

Devolve True se todos os bytes forem espaços em branco ASCII e existir pelo menos um byte, caso contrário False.

isupper() → bool

Devolve True se todos os bytes com capitalização forem maiúsculos e existir pelo menos um byte com capitalização, caso contrário False.

join(iterable: Iterable[bytes]) → bytes

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

lower() → bytes

Devolve uma cópia com todos os carateres ASCII maiúsculos convertidos para minúsculos.

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

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

partition(sep: bytes) → tuple

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

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

Devolve 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

Devolve o índice mais alto onde sub é encontrado na fatia [start:end], ou -1 se não for encontrado.

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

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

rpartition(sep: bytes) → tuple

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

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

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

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

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

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

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

splitlines(keepends: bool = False) → list

Devolve uma lista das linhas, dividindo em \n, \r e \r\n. As quebras de linha são excluídas, exceto se keepends for verdadeiro.

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

Devolve True se os bytes começarem com prefix. Ao contrário do CPython, prefix não pode ser um tuplo, e end é aceite mas ignorado.

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

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

upper() → bytes

Devolve uma cópia com todos os carateres ASCII minúsculos convertidos para maiúsculos.

callable(obj: Any) → bool

Devolve True se obj parecer invocável, False caso contrário.

chr(i: int) → str

Devolve uma cadeia de um carácter cujo ponto de código Unicode é o inteiro i.

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

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

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

Compila source num objeto de código que pode ser executado por exec() ou eval(). mode é um de "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 imaginária, ou a partir de uma cadeia de caracteres.

delattr(obj, name: str) → None

O argumento name deve ser uma cadeia de caracteres, e esta função elimina o atributo com esse nome do objeto indicado 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 retiradas de iterable, cada uma mapeada para value (por omissão None). Chamado no 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 (só de leitura).

copy() → dict

Devolve uma cópia superficial do dicionário. O objeto devolvido tem o mesmo tipo que o original (dict ou OrderedDict) mas não é fixo.

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

Devolve o valor de key se estiver no dicionário, caso contrário devolve default (que por omissão é None, pelo que nunca levanta KeyError). O dicionário não é modificado.

items() → Any

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

keys() → Any

Devolve um objeto de vista dinâmico sobre as chaves que reflete alterações subsequentes ao dicionário e suporta iteração, len(), o operador in e operadores de comparação de conjuntos.

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

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

popitem() → tuple

Remove e devolve um par (key, value) arbitrário como um tuplo de 2 elementos. Para um dict simples, 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 for fixo.

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

Se key estiver no dicionário, devolve o seu valor. Caso contrário, insere key com o valor default (por omissão None) e devolve esse valor. Levanta TypeError se o dicionário for fixo.

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

Atualiza o dicionário no local. É aceite no máximo um argumento posicional: outro dicionário, ou um iterável de pares (key, value) de dois elementos (cada um tem de produzir exatamente dois itens, ou é levantado ValueError). Os argumentos por palavra-chave são então adicionados como entradas com chave de cadeia de caracteres. As chaves existentes são substituídas. Levanta TypeError se o dicionário for fixo.

values() → Any

Devolve um objeto de vista dinâmico sobre os valores que reflete alterações subsequentes ao dicionário e suporta iteração e len().

__getitem__(key: Any) → Any

Devolve 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] para value. Implementa d[key] = value.

__delitem__(key: Any) → None

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

dir(obj: Any = None) → list

Sem argumentos, devolve a lista de nomes no âmbito local atual. Com um argumento, devolve uma lista de atributos válidos para esse objeto.

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

Devolve o par (a // b, a % b) como um tuplo, para dois números (não complexos).

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

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

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

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

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

Executa dinamicamente código Python fornecido como cadeia de caracteres 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 devolve verdadeiro. Se function for None, é assumida a função identidade.

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

Devolve um número de vírgula flutuante construído a partir de um número ou cadeia de caracteres x.

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

Devolve um novo objeto frozenset, opcionalmente com elementos retirados de iterable. frozenset é uma variante imutável e hashável de set.

copy() → frozenset

Devolve uma cópia superficial do frozenset.

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

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

intersection(other: Iterable[Any]) → frozenset

Devolve um novo frozenset com elementos comuns ao frozenset e a other. No MicroPython, apenas um único argumento other é aceite (o CPython aceita múltiplos).

isdisjoint(other: Iterable[Any]) → bool

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

issubset(other: Iterable[Any]) → bool

Devolve True se todos os elementos do frozenset estiverem em other.

issuperset(other: Iterable[Any]) → bool

Devolve True se todos os elementos de other estiverem no frozenset.

symmetric_difference(other: Iterable[Any]) → frozenset

Devolve um novo frozenset com elementos no frozenset ou em other mas não em ambos. No MicroPython, apenas um único argumento other é aceite.

union(other: Iterable[Any]) → frozenset

Devolve um novo frozenset com elementos do frozenset e de other. No MicroPython, apenas um único argumento other é aceite (o CPython aceita múltiplos).

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

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

globals() → dict

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

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

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

hash(obj: Any) → int

Devolve o valor de hash de obj (se tiver um). Os valores de hash são inteiros usados para comparar rapidamente as chaves de dicionário durante uma pesquisa.

hex(x: int) → str

Converte um inteiro numa cadeia hexadecimal em minúsculas com o prefixo "0x".

id(obj: Any) → int

Devolve a identidade de um objeto. É um inteiro garantidamente único e constante para este objeto durante o seu tempo de vida.

input(prompt: str = '') → str

Lê uma linha da entrada padrão e devolve-a como uma cadeia de caracteres (sem uma nova linha final). Se prompt for fornecido, é 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 tem de ser posicional (isto é compatível com o CPython).

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

No MicroPython, o parâmetro byteorder tem de ser posicional (isto é compatível com o CPython).

Nota

O kwarg opcional signed do CPython não é suportado. O MicroPython converte atualmente inteiros negativos como com sinal, e positivos como sem sinal. (Detalhes.)

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

Devolve True se obj for uma instância de classinfo ou de qualquer das suas subclasses. classinfo pode ser uma classe ou um tuplo de classes.

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

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

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

Devolve um objeto iterador. Com um argumento, obj tem de suportar o protocolo de iteração. Com dois argumentos, obj tem de ser invocável e a iteração para quando devolve sentinel.

len(obj: Any) → int

Devolve o número de itens num contentor.

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

Constrói uma nova lista, opcionalmente preenchida com itens de iterable.

append(object: Any) → None

Acrescenta object ao fim da lista.

clear() → None

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

copy() → list

Devolve uma cópia superficial da lista.

count(value: Any) → int

Devolve o número de elementos da lista iguais a value.

extend(iterable: Iterable[Any]) → None

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

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

Devolve 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 relativamente ao fim da lista, e o índice é limitado ao intervalo válido (por isso valores além de qualquer extremidade inserem no início ou no fim).

pop(index: int = -1) → Any

Remove e devolve o item na posição index (o último item por omissã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 apenas por palavra-chave. key, se fornecido, é uma função aplicada a cada elemento para produzir o valor de comparação; reverse ordena por ordem decrescente.

Nota

Ao contrário do CPython, a ordenação de listas do MicroPython não é estável.

locals() → dict

Devolve um dicionário que representa a tabela de símbolos local atual.

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

Devolve 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, devolve o seu maior item. Com dois ou mais argumentos, devolve o maior argumento.

class memoryview(obj: Any)

Cria uma memoryview que referencia obj, que tem de suportar o protocolo de buffer (por exemplo bytes, bytearray, array.array). Permite acesso sem cópia e fatiamento da memória subjacente; o fatiamento de uma memoryview devolve outra 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, devolve o seu menor item. Com dois ou mais argumentos, devolve o menor argumento.

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

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

class object

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

oct(x: int) → str

Converte um inteiro numa cadeia octal com o prefixo "0o".

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

Abre file e devolve o objeto ficheiro correspondente. mode tem por omissão "r" para leitura de texto.

ord(c: str) → int

Devolve o ponto de código Unicode de uma cadeia de caracteres de um único carácter c como um inteiro.

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

Devolve base elevado à potência exp. Se mod for fornecido, devolve base ** exp % mod (calculado mais eficientemente do 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 de 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

Devolve um atributo de propriedade. Tipicamente usado como decorador para definir atributos geridos numa classe.

range(*args: int) → range

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

repr(obj: Any) → str

Devolve uma cadeia de caracteres com uma representação imprimível de obj.

reversed(seq: Any) → Iterator[Any]

Devolve um iterador inverso sobre os valores da sequência fornecida.

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

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

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

Devolve um novo objeto set, opcionalmente com elementos retirados de iterable.

add(elem: Any) → None

Adiciona o elemento elem ao conjunto.

clear() → None

Remove todos os elementos do conjunto.

copy() → set

Devolve uma cópia superficial do conjunto.

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

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

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

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

discard(elem: Any) → None

Remove o elemento elem do conjunto se estiver presente. Ao contrário de remove(), isto não levanta um erro se elem estiver ausente.

intersection(other: Iterable[Any]) → set

Devolve um novo conjunto com elementos comuns ao conjunto e a other. No MicroPython, apenas um único argumento other é aceite (o CPython aceita múltiplos).

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 é aceite.

isdisjoint(other: Iterable[Any]) → bool

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

issubset(other: Iterable[Any]) → bool

Devolve True se todos os elementos do conjunto estiverem em other.

issuperset(other: Iterable[Any]) → bool

Devolve True se todos os elementos de other estiverem no conjunto.

pop() → Any

Remove e devolve 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

Devolve um novo conjunto com elementos no conjunto ou em other mas não em ambos. No MicroPython, apenas um único argumento other é aceite.

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 é aceite.

union(other: Iterable[Any]) → set

Devolve um novo conjunto com elementos do conjunto e de other. No MicroPython, apenas um único argumento other é aceite (o CPython aceita múltiplos).

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 para value. A contrapartida de getattr().

class slice

O builtin slice é o tipo que os objetos fatia possuem.

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

Devolve uma nova lista ordenada a partir dos itens em iterable.

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

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

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

Devolve uma versão em cadeia de caracteres de object. Se object for um objeto semelhante a bytes, os argumentos encoding e errors controlam a descodificação.

center(width: int) → str

Devolve uma cópia da cadeia de caracteres centrada num campo de comprimento width, preenchida com espaços. No MicroPython, apenas um espaço é usado como carácter de preenchimento (não existe argumento de carácter de preenchimento), e a cadeia original é devolvida inalterada quando width não for maior do que o seu comprimento.

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

Devolve o número de ocorrências não sobrepostas de sub na fatia [start:end]. Um sub vazio conta cada intervalo entre carateres.

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

Devolve um objeto bytes que codifica a cadeia de caracteres. O MicroPython ignora efetivamente os argumentos e usa UTF-8; errors é aceite mas não é aplicado. Equivalente a bytes(s, "utf-8").

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

Devolve True se a cadeia de caracteres terminar com o suffix fornecido, que pode ser uma única cadeia ou um tuplo de cadeias a experimentar. Os parâmetros opcionais start e end restringem a comparação à fatia [start:end].

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

Devolve o índice mais baixo na cadeia de caracteres onde a subcadeia sub é encontrada na fatia [start:end], ou -1 se não for encontrada.

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

Realiza uma operação de formatação de cadeia de caracteres, substituindo campos de substituição delimitados por chavetas {} por valores de args e kwargs. Suporta a mini-linguagem de especificação de formato padrão.

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

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

isalpha() → bool

Devolve True se todos os carateres da cadeia forem alfabéticos e a cadeia não estiver vazia, caso contrário False.

isdigit() → bool

Devolve True se todos os carateres da cadeia forem dígitos e a cadeia não estiver vazia, caso contrário False.

islower() → bool

Devolve True se a cadeia contiver pelo menos um carácter alfabético e todos esses carateres forem minúsculos, caso contrário False.

isspace() → bool

Devolve True se todos os carateres da cadeia forem espaços em branco e a cadeia não estiver vazia, caso contrário False.

isupper() → bool

Devolve True se a cadeia contiver pelo menos um carácter alfabético e todos esses carateres forem maiúsculos, caso contrário False.

join(iterable: Iterable[str]) → str

Concatena as cadeias de caracteres em iterable, inserindo esta cadeia como separador entre os elementos. Os itens têm de ser cadeias de caracteres, caso contrário é levantado TypeError.

lower() → str

Devolve uma cópia da cadeia de caracteres com todos os carateres convertidos para minúsculos.

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

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

partition(sep: str) → tuple

Divide a cadeia de caracteres na primeira ocorrência de sep e devolve um tuplo de 3 elementos (head, sep, tail). Se sep não for encontrado, devolve (self, "", ""). Um sep vazio levanta ValueError.

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

Devolve uma cópia da cadeia de caracteres com todas as ocorrências da subcadeia 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

Devolve o índice mais alto na cadeia de caracteres onde a subcadeia sub é encontrada na fatia [start:end], ou -1 se não for encontrada.

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

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

rpartition(sep: str) → tuple

Divide a cadeia de caracteres na última ocorrência de sep e devolve um tuplo de 3 elementos (head, sep, tail). Se sep não for encontrado, devolve ("", "", self). Um sep vazio levanta ValueError.

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

Divide a cadeia de caracteres a partir da direita numa lista de subcadeias usando sep como delimitador, realizando no máximo maxsplit divisões. Sem maxsplit (ou 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

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

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

Divide a cadeia de caracteres numa lista de subcadeias 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 os espaços em branco iniciais ignorados; caso contrário, um sep vazio levanta ValueError.

splitlines(keepends: bool = False) → list

Devolve uma lista das linhas na cadeia de caracteres, dividindo em \n, \r e \r\n. As quebras de linha não são incluídas, exceto se keepends for verdadeiro.

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

Devolve True se a cadeia de caracteres começar com o prefix fornecido, que pode ser uma única cadeia ou um tuplo de cadeias a experimentar. Os parâmetros opcionais start e end restringem a comparação à fatia [start:end].

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

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

upper() → str

Devolve uma cópia da cadeia de caracteres com todos os carateres 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 devolve o total.

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

Devolve um objeto proxy que delega chamadas de métodos para uma classe pai ou irmã de type. Útil para aceder a métodos herdados que foram substituídos numa classe.

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

Constrói um novo tuplo, opcionalmente preenchido com itens de iterable. Os tuplos são sequências imutáveis.

count(value: Any) → int

Devolve o número de elementos do tuplo iguais a value.

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

Devolve 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, devolve o tipo de obj. O valor devolvido é um objeto de tipo.

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

Devolve um iterador de tuplos, onde o i-ésimo tuplo contém o i-ésimo elemento de cada um dos iteráveis argumento. A iteração para quando o iterável de entrada mais curto se esgota.

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 para todas as exceções que não fazem sair o sistema.

exception ImportError

Levantada quando uma instrução import não encontra a definição do módulo.

exception IndexError

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

exception KeyboardInterrupt

Levantada quando o utilizador interrompe a execução do programa, habitualmente pressionando Ctrl+C no REPL.

Ver também no contexto de Bloqueio Suave (falha no arranque).

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 uma funcionalidade não implementada é invocada.

exception OSError

Levantada quando uma função do sistema devolve um erro relacionado com o sistema.

exception RuntimeError

Levantada quando é detetado 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 existem mais itens.

exception SyntaxError

Levantada quando o analisador encontra um erro de sintaxe.

exception SystemExit

Levantada por sys.exit() para solicitar a terminação do interpretador. Ao contrário da maioria das exceções, não produz um traceback quando não é tratada.

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

exception TypeError

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

exception ValueError

Levantada quando uma operação ou função incorporada recebe um argumento do tipo correto mas com um valor inadequado.

exception ZeroDivisionError

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