builtins — funciones y excepciones integradas

Aquí se describen todas las funciones y excepciones integradas. También están disponibles a través del módulo builtins.

Funciones y tipos

abs(x: Any) → Any

Devuelve el valor absoluto de un número. El argumento puede ser un entero, un número de punto flotante o cualquier objeto que implemente __abs__().

all(iterable: Iterable[Any]) → bool

Devuelve True si todos los elementos de iterable son verdaderos (o si el iterable está vacío).

any(iterable: Iterable[Any]) → bool

Devuelve True si algún elemento de iterable es verdadero. Devuelve False si el iterable está vacío.

bin(x: int) → str

Convierte un entero en una cadena binaria con el prefijo "0b". El argumento debe ser un entero de Python o implementar __index__().

class bool(x: Any = False)

Devuelve un valor booleano, es decir, True o False. x se convierte usando el procedimiento estándar de comprobación de verdad.

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

Secuencia mutable de enteros en el rango 0-255. La construcción sigue las mismas reglas que bytes: a partir de un entero (creando un búfer de ese tamaño relleno de ceros), un iterable de enteros, una cadena con encoding, o cualquier objeto que admita el protocolo de búfer. Admite las operaciones estándar de secuencia más la modificación in situ.

classmethod fromhex(string: str) → bytearray

Construye un bytearray a partir de una cadena de pares de dígitos hexadecimales. Los espacios en blanco entre pares de dígitos se omiten; un carácter no hexadecimal genera ValueError.

append(val: int) → None

Añade un único valor (un entero en el rango 0-255) al final del bytearray, ampliándolo en un byte.

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

Devuelve una copia del contenido centrado en una secuencia de longitud width, rellenada con fillbyte. A diferencia de CPython, fillbyte es obligatorio. Los datos se devuelven sin cambios cuando width no es mayor que la longitud actual.

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

Devuelve el número de apariciones no superpuestas de sub en el segmento [start:end].

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

Devuelve True si el contenido termina con suffix. A diferencia de CPython, suffix no puede ser una tupla de valores.

extend(iterable: Iterable[int]) → None

Añade todos los elementos de iterable al final del bytearray. Como extensión de CPython, puede usarse cualquier objeto que admita el protocolo de búfer.

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

Devuelve el índice más bajo donde se encuentra sub dentro del segmento [start:end], o -1 si no se encuentra.

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

Realiza una operación de formato de cadena usando el contenido como cadena de formato, devolviendo el resultado formateado.

hex(sep: str = '') → str

Devuelve una cadena de dos dígitos hexadecimales por cada byte. Si se proporciona el argumento opcional sep (una cadena de longitud 1), se inserta entre valores de byte consecutivos.

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

Como find(), pero genera ValueError cuando no se encuentra sub.

isalpha() → bool

Devuelve True si todos los bytes son caracteres ASCII alfabéticos y hay al menos un byte; de lo contrario, False.

isdigit() → bool

Devuelve True si todos los bytes son dígitos decimales ASCII y hay al menos un byte; de lo contrario, False.

islower() → bool

Devuelve True si todos los bytes con distinción de mayúsculas y minúsculas están en minúscula y hay al menos uno de ellos; de lo contrario, False.

isspace() → bool

Devuelve True si todos los bytes son espacios en blanco ASCII y hay al menos un byte; de lo contrario, False.

isupper() → bool

Devuelve True si todos los bytes con distinción de mayúsculas y minúsculas están en mayúscula y hay al menos uno de ellos; de lo contrario, False.

join(iterable: Iterable[bytes]) → bytes

Devuelve un objeto bytes que es la concatenación de los elementos de iterable, usando el contenido del bytearray como separador.

lower() → bytes

Devuelve una copia del contenido con todos los caracteres ASCII en mayúscula convertidos a minúscula.

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

Devuelve una copia con los bytes iniciales eliminados. chars especifica el conjunto de bytes a eliminar; si se omite o es None, se eliminan los espacios en blanco ASCII.

partition(sep: bytes) → tuple

Divide en la primera aparición de sep, devolviendo (head, sep, tail). Si no se encuentra sep, devuelve el contenido seguido de dos objetos vacíos.

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

Devuelve una copia con todas las apariciones de old reemplazadas por new. Si se proporciona count, solo se reemplazan las primeras count apariciones.

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

Devuelve el índice más alto donde se encuentra sub dentro del segmento [start:end], o -1 si no se encuentra.

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

Como rfind(), pero genera ValueError cuando no se encuentra sub.

rpartition(sep: bytes) → tuple

Divide en la última aparición de sep, devolviendo (head, sep, tail). Si no se encuentra sep, devuelve dos objetos vacíos seguidos del contenido.

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

Divide en las apariciones de sep en una lista de fragmentos, realizando como máximo maxsplit divisiones contando desde la derecha. Si sep es None o se omite, divide en secuencias de espacios en blanco ASCII.

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

Devuelve una copia con los bytes finales eliminados. chars especifica el conjunto de bytes a eliminar; si se omite o es None, se eliminan los espacios en blanco ASCII.

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

Divide en las apariciones de sep en una lista de fragmentos. Si sep es None o se omite, divide en secuencias de espacios en blanco ASCII y se ignoran los espacios en blanco iniciales y finales.

splitlines(keepends: bool = False) → list

Devuelve una lista de las líneas, separando en \n, \r y \r\n. Los saltos de línea se excluyen a menos que keepends sea verdadero.

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

Devuelve True si el contenido comienza con prefix. A diferencia de CPython, prefix no puede ser una tupla, y end se acepta pero se ignora.

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

Devuelve una copia con los bytes iniciales y finales eliminados. chars especifica el conjunto de bytes a eliminar; si se omite o es None, se eliminan los espacios en blanco ASCII.

upper() → bytes

Devuelve una copia del contenido con todos los caracteres ASCII en minúscula convertidos a mayúscula.

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

Secuencia inmutable de enteros en el rango 0-255. Se crea a partir de un entero (búfer relleno de ceros), un iterable de enteros, una cadena con encoding, o cualquier objeto que admita el protocolo de búfer. Los literales de bytes usan la sintaxis b'...'.

classmethod fromhex(string: str) → bytes

Construye un objeto bytes a partir de una cadena de pares de dígitos hexadecimales. Los espacios en blanco entre pares de dígitos se omiten; un carácter no hexadecimal genera ValueError.

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

Devuelve una copia centrada en una secuencia de longitud width, rellenada con fillbyte (un bytes de longitud 1 que indica el byte de relleno). A diferencia de CPython, fillbyte es obligatorio. El objeto original se devuelve sin cambios cuando width no es mayor que su longitud.

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

Devuelve el número de apariciones no superpuestas de sub en el segmento [start:end].

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

Devuelve un str decodificado a partir de los bytes. En MicroPython el argumento encoding se acepta pero se ignora en la práctica (los bytes se reinterpretan como UTF-8).

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

Devuelve True si los bytes terminan con suffix. A diferencia de CPython, suffix no puede ser una tupla de valores a probar.

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

Devuelve el índice más bajo donde se encuentra la subsecuencia sub dentro del segmento [start:end], o -1 si no se encuentra.

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

Realiza una operación de formato de cadena usando los bytes como cadena de formato, devolviendo el resultado formateado.

hex(sep: str = '') → str

Devuelve una cadena de dos dígitos hexadecimales por cada byte. Si se proporciona el argumento opcional sep (una cadena de longitud 1), se inserta entre valores de byte consecutivos.

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

Como find(), pero genera ValueError cuando no se encuentra sub.

isalpha() → bool

Devuelve True si todos los bytes son caracteres ASCII alfabéticos y hay al menos un byte; de lo contrario, False.

isdigit() → bool

Devuelve True si todos los bytes son dígitos decimales ASCII y hay al menos un byte; de lo contrario, False.

islower() → bool

Devuelve True si todos los bytes con distinción de mayúsculas y minúsculas están en minúscula y hay al menos uno de ellos; de lo contrario, False.

isspace() → bool

Devuelve True si todos los bytes son espacios en blanco ASCII y hay al menos un byte; de lo contrario, False.

isupper() → bool

Devuelve True si todos los bytes con distinción de mayúsculas y minúsculas están en mayúscula y hay al menos uno de ellos; de lo contrario, False.

join(iterable: Iterable[bytes]) → bytes

Devuelve un objeto bytes que es la concatenación de los elementos de iterable, usando el propio objeto bytes como separador.

lower() → bytes

Devuelve una copia con todos los caracteres ASCII en mayúscula convertidos a minúscula.

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

Devuelve una copia con los bytes iniciales eliminados. chars especifica el conjunto de bytes a eliminar; si se omite o es None, se eliminan los espacios en blanco ASCII.

partition(sep: bytes) → tuple

Divide en la primera aparición de sep, devolviendo (head, sep, tail). Si no se encuentra sep, devuelve los bytes seguidos de dos objetos bytes vacíos.

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

Devuelve una copia con todas las apariciones de old reemplazadas por new. Si se proporciona count, solo se reemplazan las primeras count apariciones.

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

Devuelve el índice más alto donde se encuentra sub dentro del segmento [start:end], o -1 si no se encuentra.

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

Como rfind(), pero genera ValueError cuando no se encuentra sub.

rpartition(sep: bytes) → tuple

Divide en la última aparición de sep, devolviendo (head, sep, tail). Si no se encuentra sep, devuelve dos objetos bytes vacíos seguidos de los bytes.

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

Divide en las apariciones de sep en una lista de fragmentos, realizando como máximo maxsplit divisiones contando desde la derecha. Si sep es None o se omite, divide en secuencias de espacios en blanco ASCII.

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

Devuelve una copia con los bytes finales eliminados. chars especifica el conjunto de bytes a eliminar; si se omite o es None, se eliminan los espacios en blanco ASCII.

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

Divide en las apariciones de sep en una lista de fragmentos. Si sep es None o se omite, divide en secuencias de espacios en blanco ASCII y se ignoran los espacios en blanco iniciales y finales.

splitlines(keepends: bool = False) → list

Devuelve una lista de las líneas, separando en \n, \r y \r\n. Los saltos de línea se excluyen a menos que keepends sea verdadero.

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

Devuelve True si los bytes comienzan con prefix. A diferencia de CPython, prefix no puede ser una tupla, y end se acepta pero se ignora.

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

Devuelve una copia con los bytes iniciales y finales eliminados. chars especifica el conjunto de bytes a eliminar; si se omite o es None, se eliminan los espacios en blanco ASCII.

upper() → bytes

Devuelve una copia con todos los caracteres ASCII en minúscula convertidos a mayúscula.

callable(obj: Any) → bool

Devuelve True si obj parece invocable, False en caso contrario.

chr(i: int) → str

Devuelve una cadena de un carácter cuyo punto de código Unicode es el entero i.

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

Transforma un método en un método de clase. Normalmente se usa como decorador.

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

Compila source en un objeto de código que puede ser ejecutado por exec() o eval(). mode es uno de "exec", "eval" o "single".

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

Crea un número complejo a partir de una parte real y otra imaginaria, o a partir de una cadena.

delattr(obj, name: str) → None

El argumento name debe ser una cadena, y esta función elimina el atributo nombrado del objeto dado por obj.

class dict(*args, **kwargs)

Crea un nuevo diccionario. Equivalente a dict de CPython.

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

Crea un nuevo diccionario con claves tomadas de iterable, cada una asignada a value (cuyo valor predeterminado es None). Se llama sobre el tipo, p. ej. dict.fromkeys(...).

clear() → None

Elimina todos los elementos del diccionario, dejándolo vacío. Genera TypeError si el diccionario es fijo (de solo lectura).

copy() → dict

Devuelve una copia superficial del diccionario. El objeto devuelto tiene el mismo tipo que el original (dict u OrderedDict) pero no es fijo.

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

Devuelve el valor de key si está en el diccionario; de lo contrario, devuelve default (que a su vez tiene como valor predeterminado None, por lo que esto nunca genera KeyError). El diccionario no se modifica.

items() → Any

Devuelve un objeto de vista dinámica sobre los pares (key, value) que refleja los cambios posteriores en el diccionario y admite la iteración, len(), el operador in y los operadores de comparación de conjuntos.

keys() → Any

Devuelve un objeto de vista dinámica sobre las claves que refleja los cambios posteriores en el diccionario y admite la iteración, len(), el operador in y los operadores de comparación de conjuntos.

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

Elimina key del diccionario y devuelve su valor. Si key no está presente, devuelve default si se proporcionó; de lo contrario, genera KeyError. Genera TypeError si el diccionario es fijo.

popitem() → tuple

Elimina y devuelve un par (key, value) arbitrario como una tupla de 2 elementos. Para un dict normal el par elegido no está especificado; para un OrderedDict se elimina el último par insertado (LIFO). Genera KeyError si el diccionario está vacío, o TypeError si es fijo.

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

Si key está en el diccionario, devuelve su valor. De lo contrario, inserta key con un valor de default (cuyo valor predeterminado es None) y devuelve ese valor. Genera TypeError si el diccionario es fijo.

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

Actualiza el diccionario in situ. Se acepta como máximo un argumento posicional: otro diccionario, o un iterable de pares (key, value) de dos elementos (cada uno debe producir exactamente dos elementos o se genera ValueError). Los argumentos de palabra clave se añaden entonces como entradas con clave de cadena. Las claves existentes se sobrescriben. Genera TypeError si el diccionario es fijo.

values() → Any

Devuelve un objeto de vista dinámica sobre los valores que refleja los cambios posteriores en el diccionario y admite la iteración y len().

__getitem__(key: Any) → Any

Devuelve self[key]. Implementa el operador de indexación d[key]; genera KeyError si key no está presente.

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

Establece self[key] en value. Implementa d[key] = value.

__delitem__(key: Any) → None

Elimina self[key]. Implementa del d[key]; genera KeyError si key no está presente.

dir(obj: Any = None) → list

Sin argumentos, devuelve la lista de nombres del ámbito local actual. Con un argumento, devuelve una lista de atributos válidos para ese objeto.

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

Devuelve el par (a // b, a % b) como una tupla, para dos números (no complejos).

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

Devuelve un objeto enumerate que produce pares (index, value) a partir de iterable, con el índice comenzando en start.

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

Evalúa una expresión de Python dada como una cadena (o un objeto de código compilado) y devuelve el resultado.

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

Ejecuta dinámicamente código de Python proporcionado como una cadena o un objeto de código compilado.

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

Construye un iterador a partir de aquellos elementos de iterable para los que function devuelve verdadero. Si function es None, se asume la función identidad.

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

Devuelve un número de punto flotante construido a partir de un número o una cadena x.

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

Devuelve un nuevo objeto frozenset, opcionalmente con elementos tomados de iterable. frozenset es una variante inmutable y hashable de set.

copy() → frozenset

Devuelve una copia superficial del frozenset.

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

Devuelve un nuevo frozenset con los elementos del frozenset que no están en ninguno de los others. Cada argumento puede ser cualquier iterable.

intersection(other: Iterable[Any]) → frozenset

Devuelve un nuevo frozenset con los elementos comunes al frozenset y a other. En MicroPython solo se acepta un único argumento other (CPython acepta varios).

isdisjoint(other: Iterable[Any]) → bool

Devuelve True si el frozenset no tiene elementos en común con other.

issubset(other: Iterable[Any]) → bool

Devuelve True si todos los elementos del frozenset están en other.

issuperset(other: Iterable[Any]) → bool

Devuelve True si todos los elementos de other están en el frozenset.

symmetric_difference(other: Iterable[Any]) → frozenset

Devuelve un nuevo frozenset con los elementos que están en el frozenset o en other pero no en ambos. En MicroPython solo se acepta un único argumento other.

union(other: Iterable[Any]) → frozenset

Devuelve un nuevo frozenset con los elementos del frozenset y de other. En MicroPython solo se acepta un único argumento other (CPython acepta varios).

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

Devuelve el valor del atributo nombrado de obj. Si el atributo no existe, se devuelve default si se proporciona; de lo contrario, se genera AttributeError.

globals() → dict

Devuelve un diccionario que representa la tabla de símbolos globales del módulo actual.

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

Devuelve True si obj tiene un atributo con el nombre name dado, False en caso contrario.

hash(obj: Any) → int

Devuelve el valor hash de obj (si tiene uno). Los valores hash son enteros utilizados para comparar rápidamente las claves de un diccionario durante una búsqueda en el mismo.

hex(x: int) → str

Convierte un entero en una cadena hexadecimal en minúsculas con el prefijo "0x".

id(obj: Any) → int

Devuelve la identidad de un objeto. Se trata de un entero que se garantiza único y constante para este objeto durante su tiempo de vida.

input(prompt: str = '') → str

Lee una línea de la entrada estándar y la devuelve como una cadena (sin el salto de línea final). Si se proporciona prompt, se escribe en la salida estándar sin un salto de línea final antes.

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

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

En MicroPython, el parámetro byteorder debe ser posicional (esto es compatible con CPython).

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

En MicroPython, el parámetro byteorder debe ser posicional (esto es compatible con CPython).

Nota

El argumento de palabra clave opcional signed de CPython no es compatible. MicroPython actualmente convierte los enteros negativos como con signo, y los positivos como sin signo. (Detalles.)

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

Devuelve True si obj es una instancia de classinfo o de alguna de sus subclases. classinfo puede ser una clase o una tupla de clases.

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

Devuelve True si cls es una subclase (directa, indirecta o virtual) de classinfo.

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

Devuelve un objeto iterador. Con un argumento, obj debe admitir el protocolo de iteración. Con dos argumentos, obj debe ser invocable y la iteración se detiene cuando devuelve sentinel.

len(obj: Any) → int

Devuelve el número de elementos de un contenedor.

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

Construye una nueva lista, opcionalmente poblada con los elementos de iterable.

append(object: Any) → None

Añade object al final de la lista.

clear() → None

Elimina todos los elementos de la lista, dejándola vacía.

copy() → list

Devuelve una copia superficial de la lista.

count(value: Any) → int

Devuelve el número de elementos de la lista que son iguales a value.

extend(iterable: Iterable[Any]) → None

Añade todos los elementos de iterable al final de la lista. Si iterable es a su vez una lista, sus elementos se copian directamente; de lo contrario, se itera sobre él.

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

Devuelve el índice del primer elemento igual a value, buscando en el segmento [start:stop]. Genera ValueError si value no está presente.

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

Inserta object antes de la posición index. Un index negativo se interpreta en relación con el final de la lista, y el índice se limita al rango válido (de modo que los valores que sobrepasan cualquiera de los extremos insertan al principio o al final).

pop(index: int = -1) → Any

Elimina y devuelve el elemento en index (el último elemento de forma predeterminada). Genera IndexError si la lista está vacía o index está fuera de rango.

remove(value: Any) → None

Elimina el primer elemento igual a value. Genera ValueError si value no está presente.

reverse() → None

Invierte los elementos de la lista in situ.

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

Ordena los elementos de la lista in situ. key y reverse son argumentos exclusivos de palabra clave. key, si se proporciona, es una función que se aplica a cada elemento para producir el valor de comparación; reverse ordena en orden descendente.

Nota

A diferencia de CPython, la ordenación de listas de MicroPython no es estable.

locals() → dict

Devuelve un diccionario que representa la tabla de símbolos locales actual.

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

Devuelve un iterador que aplica function a cada elemento de iterables, produciendo los resultados.

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

Con un único argumento iterable, devuelve su elemento más grande. Con dos o más argumentos, devuelve el argumento más grande.

class memoryview(obj: Any)

Crea un memoryview que hace referencia a obj, que debe admitir el protocolo de búfer (p. ej. bytes, bytearray, array.array). Permite el acceso y el segmentado de la memoria subyacente sin copia; segmentar un memoryview devuelve otro memoryview en lugar de una copia.

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

Con un único argumento iterable, devuelve su elemento más pequeño. Con dos o más argumentos, devuelve el argumento más pequeño.

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

Recupera el siguiente elemento de iterator. Si se proporciona default y el iterador está agotado, se devuelve default en lugar de generar StopIteration.

class object

Devuelve un nuevo objeto sin características. object es la clase base de todas las clases.

oct(x: int) → str

Convierte un entero en una cadena octal con el prefijo "0o".

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

Abre file y devuelve un objeto de archivo correspondiente. mode tiene como valor predeterminado "r" para lectura de texto.

ord(c: str) → int

Devuelve el punto de código Unicode de una cadena de un solo carácter c como un entero.

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

Devuelve base elevado a la potencia exp. Si se proporciona mod, devuelve base ** exp % mod (calculado de forma más eficiente que la forma explícita).

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

Imprime objects en el flujo de texto file, separados por sep y 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

Devuelve un atributo de propiedad. Normalmente se usa como decorador para definir atributos gestionados en una clase.

range(*args: int) → range

Devuelve una secuencia inmutable de enteros. Se llama como range(stop), range(start, stop) o range(start, stop, step).

repr(obj: Any) → str

Devuelve una cadena que contiene una representación imprimible de obj.

reversed(seq: Any) → Iterator[Any]

Devuelve un iterador inverso sobre los valores de la secuencia dada.

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

Devuelve number redondeado a ndigits posiciones decimales. Si se omite ndigits, devuelve el entero más cercano.

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

Devuelve un nuevo objeto set, opcionalmente con elementos tomados de iterable.

add(elem: Any) → None

Añade el elemento elem al conjunto.

clear() → None

Elimina todos los elementos del conjunto.

copy() → set

Devuelve una copia superficial del conjunto.

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

Devuelve un nuevo conjunto con los elementos del conjunto que no están en ninguno de los others. Cada argumento puede ser cualquier iterable.

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

Elimina del conjunto todos los elementos encontrados en cualquiera de los others (in situ).

discard(elem: Any) → None

Elimina el elemento elem del conjunto si está presente. A diferencia de remove(), esto no genera un error si elem está ausente.

intersection(other: Iterable[Any]) → set

Devuelve un nuevo conjunto con los elementos comunes al conjunto y a other. En MicroPython solo se acepta un único argumento other (CPython acepta varios).

intersection_update(other: Iterable[Any]) → None

Actualiza el conjunto, conservando solo los elementos que también se encuentran en other (in situ). En MicroPython solo se acepta un único argumento other.

isdisjoint(other: Iterable[Any]) → bool

Devuelve True si el conjunto no tiene elementos en común con other.

issubset(other: Iterable[Any]) → bool

Devuelve True si todos los elementos del conjunto están en other.

issuperset(other: Iterable[Any]) → bool

Devuelve True si todos los elementos de other están en el conjunto.

pop() → Any

Elimina y devuelve un elemento arbitrario del conjunto. Genera KeyError si el conjunto está vacío.

remove(elem: Any) → None

Elimina el elemento elem del conjunto. Genera KeyError si elem no está contenido en el conjunto.

symmetric_difference(other: Iterable[Any]) → set

Devuelve un nuevo conjunto con los elementos que están en el conjunto o en other pero no en ambos. En MicroPython solo se acepta un único argumento other.

symmetric_difference_update(other: Iterable[Any]) → None

Actualiza el conjunto, conservando solo los elementos que están en el conjunto o en other pero no en ambos (in situ). En MicroPython solo se acepta un único argumento other.

union(other: Iterable[Any]) → set

Devuelve un nuevo conjunto con los elementos del conjunto y de other. En MicroPython solo se acepta un único argumento other (CPython acepta varios).

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

Actualiza el conjunto, añadiendo los elementos de todos los others (in situ).

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

Establece el atributo nombrado de obj en value. La contraparte de getattr().

class slice

El elemento integrado slice es el tipo que tienen los objetos slice.

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

Devuelve una nueva lista ordenada a partir de los elementos de iterable.

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

Transforma un método en un método estático. Normalmente se usa como decorador.

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

Devuelve una versión en cadena de object. Si object es un objeto similar a bytes, los argumentos encoding y errors controlan la decodificación.

center(width: int) → str

Devuelve una copia de la cadena centrada en un campo de longitud width, rellenado con espacios. En MicroPython solo se usa un espacio como carácter de relleno (no hay argumento de carácter de relleno), y la cadena original se devuelve sin cambios cuando width no es mayor que su longitud.

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

Devuelve el número de apariciones no superpuestas de sub en el segmento [start:end]. Un sub vacío cuenta cada espacio entre caracteres.

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

Devuelve un objeto bytes que codifica la cadena. MicroPython ignora en la práctica los argumentos y usa UTF-8; errors se acepta pero no se tiene en cuenta. Equivalente a bytes(s, "utf-8").

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

Devuelve True si la cadena termina con el suffix dado, que puede ser una única cadena o una tupla de cadenas a probar. Los argumentos opcionales start y end restringen la comparación al segmento [start:end].

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

Devuelve el índice más bajo de la cadena donde se encuentra la subcadena sub dentro del segmento [start:end], o -1 si no se encuentra.

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

Realiza una operación de formato de cadena, sustituyendo los campos de reemplazo delimitados por llaves {} con valores de args y kwargs. Admite el minilenguaje estándar de especificación de formato.

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

Como find(), pero genera ValueError cuando la subcadena sub no se encuentra en el segmento [start:end].

isalpha() → bool

Devuelve True si todos los caracteres de la cadena son alfabéticos y la cadena no está vacía; de lo contrario, False.

isdigit() → bool

Devuelve True si todos los caracteres de la cadena son dígitos y la cadena no está vacía; de lo contrario, False.

islower() → bool

Devuelve True si la cadena contiene al menos un carácter alfabético y todos esos caracteres están en minúscula; de lo contrario, False.

isspace() → bool

Devuelve True si todos los caracteres de la cadena son espacios en blanco y la cadena no está vacía; de lo contrario, False.

isupper() → bool

Devuelve True si la cadena contiene al menos un carácter alfabético y todos esos caracteres están en mayúscula; de lo contrario, False.

join(iterable: Iterable[str]) → str

Concatena las cadenas de iterable, insertando esta cadena como separador entre los elementos. Los elementos deben ser cadenas; de lo contrario, se genera TypeError.

lower() → str

Devuelve una copia de la cadena con todos los caracteres convertidos a minúscula.

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

Devuelve una copia de la cadena con los caracteres iniciales eliminados. Si chars se omite o es None, se eliminan los espacios en blanco; de lo contrario, chars se trata como un conjunto de caracteres a eliminar.

partition(sep: str) → tuple

Divide la cadena en la primera aparición de sep y devuelve una tupla de 3 elementos (head, sep, tail). Si no se encuentra sep, devuelve (self, "", ""). Un sep vacío genera ValueError.

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

Devuelve una copia de la cadena con todas las apariciones de la subcadena old reemplazadas por new. Si se proporciona count y es no negativo, solo se reemplazan las primeras count apariciones.

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

Devuelve el índice más alto de la cadena donde se encuentra la subcadena sub dentro del segmento [start:end], o -1 si no se encuentra.

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

Como rfind(), pero genera ValueError cuando la subcadena sub no se encuentra en el segmento [start:end].

rpartition(sep: str) → tuple

Divide la cadena en la última aparición de sep y devuelve una tupla de 3 elementos (head, sep, tail). Si no se encuentra sep, devuelve ("", "", self). Un sep vacío genera ValueError.

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

Divide la cadena desde la derecha en una lista de subcadenas usando sep como delimitador, realizando como máximo maxsplit divisiones. Sin maxsplit (o con uno negativo) se comporta igual que split(); en MicroPython rsplit(None, n) con un n no negativo genera NotImplementedError.

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

Devuelve una copia de la cadena con los caracteres finales eliminados. Si chars se omite o es None, se eliminan los espacios en blanco; de lo contrario, chars se trata como un conjunto de caracteres a eliminar.

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

Divide la cadena en una lista de subcadenas usando sep como delimitador, realizando como máximo maxsplit divisiones. Si sep se omite o es None, divide en secuencias de espacios en blanco ignorando los espacios en blanco iniciales; de lo contrario, un sep vacío genera ValueError.

splitlines(keepends: bool = False) → list

Devuelve una lista de las líneas de la cadena, separando en \n, \r y \r\n. Los saltos de línea no se incluyen a menos que keepends sea verdadero.

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

Devuelve True si la cadena comienza con el prefix dado, que puede ser una única cadena o una tupla de cadenas a probar. Los argumentos opcionales start y end restringen la comparación al segmento [start:end].

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

Devuelve una copia de la cadena con los caracteres iniciales y finales eliminados. Si chars se omite o es None, se eliminan los espacios en blanco; de lo contrario, chars se trata como un conjunto de caracteres a eliminar.

upper() → str

Devuelve una copia de la cadena con todos los caracteres convertidos a mayúscula.

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

Suma start y los elementos de iterable de izquierda a derecha, y devuelve el total.

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

Devuelve un objeto proxy que delega las llamadas a métodos en una clase padre o hermana de type. Útil para acceder a métodos heredados que han sido sobrescritos en una clase.

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

Construye una nueva tupla, opcionalmente poblada con los elementos de iterable. Las tuplas son secuencias inmutables.

count(value: Any) → int

Devuelve el número de elementos de la tupla que son iguales a value.

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

Devuelve el índice del primer elemento igual a value, buscando en el segmento [start:stop]. Genera ValueError si value no está presente.

type(obj: Any) → type

Con un argumento, devuelve el tipo de obj. El valor devuelto es un objeto de tipo.

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

Devuelve un iterador de tuplas, donde la i-ésima tupla contiene el i-ésimo elemento de cada uno de los iterables proporcionados como argumentos. La iteración se detiene cuando se agota el iterable de entrada más corto.

Excepciones

exception AssertionError

Se genera cuando falla una instrucción assert.

exception AttributeError

Se genera cuando falla una referencia o asignación de atributo.

exception Exception

Clase base común para todas las excepciones que no provocan la salida del sistema.

exception ImportError

Se genera cuando una instrucción import no logra encontrar la definición del módulo.

exception IndexError

Se genera cuando un subíndice de secuencia está fuera de rango.

exception KeyboardInterrupt

Se genera cuando el usuario interrumpe la ejecución del programa, normalmente pulsando Ctrl+C en el REPL.

Véase también en el contexto de Bloqueo blando (fallo al arrancar).

exception KeyError

Se genera cuando no se encuentra una clave de un mapeo (diccionario) en el conjunto de claves existentes.

exception MemoryError

Se genera cuando una operación se queda sin memoria.

exception NameError

Se genera cuando no se encuentra un nombre local o global.

exception NotImplementedError

Se genera cuando se invoca un método abstracto o una característica no implementada.

exception OSError

Se genera cuando una función del sistema devuelve un error relacionado con el sistema.

exception RuntimeError

Se genera cuando se detecta un error que no encaja en ninguna de las otras categorías.

exception StopIteration

Se genera mediante next() y el método __next__() de un iterador para indicar que no hay más elementos.

exception SyntaxError

Se genera cuando el analizador encuentra un error de sintaxis.

exception SystemExit

Se genera mediante sys.exit() para solicitar la terminación del intérprete. A diferencia de la mayoría de las excepciones, no produce un rastreo (traceback) cuando no se captura.

En la OpenMV Cam, un SystemExit no controlado provoca actualmente un Reinicio en caliente de MicroPython.

exception TypeError

Se genera cuando se aplica una operación o función a un objeto de tipo inapropiado.

exception ValueError

Se genera cuando una operación o función integrada recibe un argumento del tipo correcto pero con un valor inapropiado.

exception ZeroDivisionError

Se genera cuando el segundo argumento de una operación de división o módulo es cero.