class int([n])
class int(n, base=10)
La función int devuelve un número entero a partir de un número o de un string, o devuelve el valor 0 si no se incluye ningún argumento.
Si el argumento no es un número o si se añade una base como segundo argumento, el primer argumento deberá ser de tipo texto, bytes o bytearray, representando un entero en la base indicada. Opcionalmente, el literal podría ir precedido por los signos + o - (sin espacios entre el signo y el literal). El literal sí puede incluir espacios en blanco al comienzo o al final.
La base por defecto es 10. Los valores permitidos pueden ser 0, y entre 2 y 36, ambos incluidos.
Los literales con base 2, 8 y 16 pueden ir opcionalmente precedidos por los caracteres 0b/0B, 0o/0O y 0x/0X respectivamente. Si la base es cero, el literal se interpretará literalmente.
- n: (Opcional si no se incluye la base) número o cadena de texto a convertir a número entero.
- base: Base a considerar durante la interpretación del literal.
Si el argumento es un número real, la función extrae la parte entera (truncando el número):
El intento de conversión de un número complejo devuelve un error de tipo TypeError:
De igual forma, el intento de conversión de un número (aunque sea entero) especificando la base, también devuelve un error del mismo tipo:
Si el número se añade como primer argumento en formato de texto, sí es posible especificar la base a utilizar:
Si el literal incluye caracteres no permitidos en la base indicada, también de devuelve un error, de tipo ValueError:
En estos ejemplos se convierte un literal conteniendo la representación de un número en base 2 a entero:
Si el literal se precede, como en este caso, con los caracteres "0b", la base puede tomar el valor 0:
Si se indica base cero, pero no se añaden dichos caracteres al comienzo del literal, se interpreta la cadena de texto literalmente, aplicándose por defecto la base 10:
Si no se incluyen argumentos, la función devuelve el número 0: