Référence de JavaScript 1.5 Core:Fonctions globales:parseInt

Un article de MDC.

Sommaire 1 Résumé 2 Syntaxe 3 Paramètres 4 Description 5 Exemples 5.1 Exemple : utilisation de parseInt 6 Voir aussi

[modifier] Résumé

Fonction Core

Analyse une chaîne passée en paramètre et renvoie un entier dans la base spécifiée.

[modifier] Syntaxe

parseInt(chaîne[, base])

[modifier] Paramètres

chaîne 

Une chaîne de caractères représentant la valeur à analyser.

base 

Un entier représentant la base dans laquelle la chaîne doit être traitée.

[modifier] Description

parseInt est une fonction globale et n'est associée à aucun objet.

La fonction parseInt analyse la chaîne passée en premier paramètre et essaie de renvoyer un entier dans la base spécifiée. Par exemple, une base de 10 indique une conversion en un nombre décimal, 8 octal, 16 hexadécimal, et ainsi de suite. Pour les bases supérieures à 10, les lettres de l'alphabet indiquent les chiffres plus grand que 9. Par exemple, pour les nombres hexadécimaux (base 16), les lettres A à F seront utilisées.

Si parseInt rencontre un caractère qui n'est pas un chiffre dans la base spécifiée, elle l'ignore ainsi que tous les caractères qui suivent et renvoie la valeur entière analysée jusque là. parseInt tronque les nombres à leur valeur entière. Les espaces initiaux et finals sont permis.

Si la base n'est pas précisée, ou est spécifiée à 0, JavaScript utilise les règles suivantes :

• Si le premier paramètre chaîne commence par « 0x », la base sera 16 (hexadécimal).

• Si le premier paramètre chaîne commence par « 0 », la base sera huit (octal). Il est déconseillé d'utiliser cette fonctionnalité.

• Si le premier paramètre chaîne commence par n'importe quelle autre valeur, la base sera 10 (decimal).

Si le premier caractère ne peut pas être converti en un nombre, parseInt renverra NaN.

Dans les opérations arithmétiques, la valeur NaN n'est jamais un nombre quelle que soit la base. La fonction isNaN peut être utilisée pour déterminer si le résultat de parseInt est NaN. Si NaN est passé à une opération arithmétique, son résultat sera également NaN.

[modifier] Exemples

[modifier] Exemple : utilisation de parseInt

Les exemples suivants renvoient tous 15 :

• parseInt("F", 16);
• parseInt("17", 8);
• parseInt("15", 10);
• parseInt(15.99, 10);
• parseInt("FXX123", 16);
• parseInt("1111", 2);
• parseInt("15*3", 10);
• parseInt("12", 13);

Les exemples suivants renvoient tous NaN :

• parseInt("Hello", 8); // Pas un nombre du tout
• parseInt("0x7", 10); // Pas un nombre en base 10
• parseInt("546", 2); // Les chiffres ne sont pas valides en représentation binaire (base 2)

Même si la base est indiquée différemment, les exemples suivants renvoient tous 17 car le paramètre chaîne commence par « 0x ».

• parseInt("0x11", 16);
• parseInt("0x11", 0);
• parseInt("0x11");

[modifier] Voir aussi

isNaN, parseFloat, Object.valueOf