int()

Convertit une valeur en entier.

Renvoie
Un entier.
Sur cette page

Exemple

#
Python
print(int("42"))
print(int(3.9))
print(int(-3.9))
print(int("ff", 16))
print(int(" 1_000 "))
Résultatrésultat enregistré, vous pouvez le vérifier
42
3
-3
255
1000

Définition et utilisation

#

La fonction int() crée un entier à partir d’une chaîne, d’un nombre à virgule flottante ou d’une valeur booléenne. Pour un nombre à virgule flottante, elle tronque la partie décimale sans arrondir, donc int(3.9) vaut 3.

La chaîne doit contenir l’écriture valide d’un entier ; les espaces au début et à la fin, ainsi que les underscores entre les chiffres, sont autorisés. Un texte comme "3.5" ou "12 €" lève une ValueError.

Le second argument est la base du système numérique : int("ff", 16) donne 255, et int("1010", 2) donne 10. Les entiers en Python n’ont pas de limite de taille.

Syntaxe

#
Syntaxe
int(x)
int(string, base)

Paramètres

#
  • x

    chaîne, float ou bool

    La valeur à convertir.
  • base

    int 2-36, optionnel

    La base du système numérique pour les chaînes.

Plus d’exemples

#
Une chaîne invalide
Python
try:
    int("3.5")
except ValueError as error:
    print(error)
Résultatrésultat enregistré, vous pouvez le vérifier
invalid literal for int() with base 10: '3.5'

Bonnes pratiques

#
  • Pour arrondir au plus proche entier, utilisez round(), pas int(), qui ne fait que tronquer la partie décimale.
  • Entourez toujours la conversion d’un texte venant de l’utilisateur d’un bloc try avec except ValueError.

Entrées associées

#

Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.