intval
(PHP 4, PHP 5)
intval — Retourne la valeur numérique entière équivalente d'une variable
Description
intval() retourne la valeur numérique
entière (entier) de la variable var, en
convertissant la valeur dans la base spécifiée (par
défaut en base 10). intval() ne doit pas être utilisée
sur des objets ; si c'est le cas, une erreur de niveau E_NOTICE
sera émise et la fonction retournera 1.
Liste de paramètres
-
var -
La valeur scalaire à être convertie en entier
-
base -
La base pour la conversion
Note:
Si la paramètre
basevaut 0, la base utilisée est déterminée par le format du paramètrevar:- si la chaîne inclue un préfixe "0x" (ou "0X"), la base prise sera 16 (hex) ; sinon,
- si la chaîne commence par "0", la base prise sera 8 (octal); sinon,
- la base prise sera 10 (décimal).
Valeurs de retour
Une valeur de type entier de var en cas de
succès ou 0 en cas d'échec. Les tableaux vides retournent 0,
les tableaux non vides retournent 1.
La valeur maximale dépend du système. Les systèmes à 32 bits ont une valeur entière signée maximale de -2147483648 à 2147483647. Alors, par exemple, sur un système semblable, intval('1000000000000') retournera 2147483647. La valeur entière signée maximale pour un système à 64 bits est 9223372036854775807.
Les chaînes de caractères retournent la plupart du temps 0, cela dépend des caractères à l'extrême gauche de la chaîne. La règle courante du transtypage d'entier s'applique.
Exemples
Exemple #1 Exemples avec intval()
<?php echo intval(42); // 42 echo intval(4.2); // 4 echo intval('42'); // 42 echo intval('+42'); // 42 echo intval('-42'); // -42 echo intval(042); // 34 echo intval('042'); // 42 echo intval(1e10); // 1410065408 echo intval('1e10'); // 1 echo intval(0x1A); // 26 echo intval(42000000); // 42000000 echo intval(420000000000000000000); // 0 echo intval('420000000000000000000'); // 2147483647 echo intval(42, 8); // 42 echo intval('42', 8); // 34 echo intval(array()); // 0 echo intval(array('foo', 'bar')); // 1 ?>
Notes
Note:
Le paramètre
basen'a aucun effet à moins que le paramètrevarsoit une chaîne de caractères.
Historique
| Version | Description |
|---|---|
| 5.1.0 |
Lance une alerte de type E_NOTICE et
retourne 1 lorsqu'un objet est passé au paramètre
var.
|
Voir aussi
- boolval() - Récupère la valeur booléenne d'une variable
- floatval() - Convertit une chaîne en nombre à virgule flottante
- strval() - Récupère la valeur d'une variable, au format chaîne
- settype() - Affecte un type à une variable
- is_numeric() - Détermine si une variable est un type numérique
- Définition du type
- Nombres de grande taille BCMath
