CKTIS / Java
NumberFormatException — échec de la conversion d’un texte en nombre
NumberFormatException signale qu’un texte ne peut pas être converti vers le type numérique demandé. Avec Integer.parseInt, la cause peut être une écriture invalide ou une valeur hors de la plage de int.
Version : Java SE 21; repository runtime, production runtime not attested
Syntaxe
try {
int value = Integer.parseInt(text);
} catch (NumberFormatException e) {
// Handle invalid numeric input.
}NumberFormatException, dans java.lang, indique l’échec de la conversion d’un texte vers un type numérique. Elle hérite de IllegalArgumentException et est non contrôlée : le compilateur n’exige ni qu’elle soit interceptée ni qu’elle soit déclarée dans throws.
Pour Integer.parseInt(text), la base par défaut est 10. Un signe initial + ou - est autorisé, mais les espaces, un texte vide et les caractères autres que des chiffres valides provoquent un échec. Même une notation numérique valide, telle que "2147483648", provoque NumberFormatException, car la valeur dépasse la plage de int. Pour cette méthode, null provoque également cette exception ; ne généralisez pas ce comportement à toutes les méthodes de conversion.
Interceptez NumberFormatException près du point de traitement des entrées et gérez explicitement le rejet. Ne remplacez pas silencieusement la valeur par zéro. Supprimez les espaces autour du texte uniquement si les règles d’entrée le permettent ; cela ne corrigera pas une valeur hors plage.
L’exemple distingue une conversion réussie de deux échecs : un caractère invalide et une valeur hors plage. Il affiche son propre message au lieu de s’appuyer sur le texte du message d’exception.
Exemples
public class Main {
public static void main(String[] args) {
String[] inputs = {"42", "12x", "2147483648"};
for (String text : inputs) {
try {
int value = Integer.parseInt(text);
System.out.println(text + " -> " + value);
} catch (NumberFormatException e) {
System.out.println(text + " -> invalid int");
}
}
}
}Résultat
42 -> 42 12x -> invalid int 2147483648 -> invalid int
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.