HOWTO · Python

Vérifier si une chaîne est un nombre en Python

Ce tutoriel montre comment vérifier si une chaîne est un nombre en python.

Sur cette page

Pour vérifier si une chaîne peut être convertie en nombre à virgule flottante en Python, appelez float() et gérez ValueError. Cela vérifie la syntaxe acceptée par Python pour les nombres à virgule flottante ; une application peut aussi devoir appliquer des règles supplémentaires, comme le rejet de l’infini ou de NaN.

Utiliser la fonction float() pour vérifier si une chaîne représente un nombre en Python

Exécutez cet exemple :

print(float("22.23"))
22.23

float() accepte plus que les chaînes contenant un nombre décimal. La fonction peut convertir la notation entière, les valeurs signées, la notation exponentielle et les espaces en début ou en fin de chaîne, par exemple "22", "-3.5", "1e3" et " 4.2 ". Un texte qui ne respecte pas la syntaxe des nombres à virgule flottante, comme "developer" ou "2.3.4", déclenche ValueError.

Pour traiter des données provenant d’un fichier ou d’une autre source externe, placez la conversion dans une petite fonction utilitaire. Renvoyez la valeur convertie si vous devez l’utiliser, et None si la conversion échoue. Vous éviterez ainsi de tenter de valider chaque valeur au moyen d’un test de caractères distinct.

def parse_float(value):
    try:
        return float(value)
    except ValueError:
        return None


for value in ("22.23", "developer"):
    result = parse_float(value)
    print(result)
22.23
None

La fonction utilitaire renvoie le nombre converti si l’analyse réussit, et None dans le cas contraire. Si un booléen vous est plus utile, reprenez le même modèle try/except ValueError : renvoyez True après la conversion, ou False dans le bloc de gestion de l’exception. Pour un texte impossible à analyser, interceptez ValueError ; ne présentez pas ce cas comme une OverflowError.

Une conversion réussie ne garantit pas que la valeur soit finie. En Python, float() peut produire l’infini ou NaN à partir des graphies correspondantes prises en charge. Si votre application n’accepte que des valeurs finies, vérifiez séparément le résultat converti avec math.isfinite().

Utiliser les fonctions isdigit() et partition() pour vérifier si une chaîne représente un nombre en Python

isdigit() répond à une question plus limitée : chaque caractère de la chaîne est-il un chiffre ? La méthode renvoie False pour la notation décimale courante, les signes et la notation exponentielle ; elle ne permet donc pas de valider tous les nombres à virgule flottante. Par exemple, "4546".isdigit() renvoie True, tandis que "4546.4646".isdigit() et "-12".isdigit() renvoient False, bien que float() puisse convertir ces deux dernières chaînes.

Utilisez partition() uniquement si vous prenez délibérément en charge un format limité que vous avez défini, par exemple des chiffres, un seul séparateur décimal, puis d’autres chiffres. La méthode renvoie le texte situé avant le premier séparateur, le séparateur lui-même et le texte qui le suit. Vous pouvez ainsi vérifier explicitement chaque partie, tout en gardant une règle restreinte et facile à examiner.

value = "4546.4646"
whole, point, fraction = value.partition(".")
is_simple_decimal = (
    value.count(".") == 1
    and point == "."
    and whole.isdigit()
    and fraction.isdigit()
)
print(is_simple_decimal)

Cette vérification accepte la forme illustrée, avec des chiffres de part et d’autre du séparateur. Elle rejette les nombres entiers seuls, les séparateurs décimaux en début ou en fin de chaîne, les signes, les espaces en début ou en fin de chaîne et la notation exponentielle. float() accepte plusieurs de ces formes, notamment les nombres entiers, les valeurs signées, les espaces et les exposants ; cette vérification n’est donc pas équivalente à l’analyse effectuée par float(). De plus, isdigit() reconnaît certains chiffres Unicode ; si votre format d’entrée exige uniquement des chiffres ASCII, définissez une règle qui les vérifie explicitement. En Python, le point est le séparateur décimal de la syntaxe des nombres à virgule flottante : une chaîne comme "4,2" n’est pas convertie en 4.2. Si les données utilisent un séparateur propre à une locale, analysez-les selon leur format au lieu de remplacer silencieusement la ponctuation.

Une vérification écrite à la main doit définir comment traiter chacun de ces cas et peut facilement s’écarter de la syntaxe acceptée par Python. Si vous souhaitez accepter les valeurs que Python peut convertir, utilisez float() et gérez ValueError.

value = "4546.4646"
print(value.isdigit())
print(float(value))
False
4546.4646