Entiers
Un entier est un nombre de l'ensemble des entiers naturels Z : Z = {...., -2, -1, 0, 1, 2, ...}.
Voir aussi : Longueur arbitraire des entiers / GMP, les nombre à virgule flottante et les précisions arbitraires / BCMath.
Syntaxe
Les entiers peuvent être spécifiés en base décimale (dite aussi base 10), en hexadécimale (base 16) ou octale (base 8). Les entiers peuvent être optionnellement précédés par le signe plus ou moins (+ ou -).
Pour utiliser la notation octale, vous devez préfixer le nombre avec un zéro; pour utiliser la notation hexadécimale, vous devez préfixer le nombre avec 0x.
Example#1 Notations entières
<?php
$a = 1234; // nombre entier en base 10
$a = -123; // nombre entier négatif
$a = 0123; // nombre entier en base 8, octale (équivalent à 83 en base 10)
$a = 0x1A; // nombre entier en base 16, hexadécimale
// (équivalent à 26 en base 10)
?>
Example#2 Structure d'un entier
decimal : [1-9][0-9]*
| 0
hexadecimal : 0[xX][0-9a-fA-F]+
octal : 0[0-7]+
integer : [+-]?decimal
| [+-]?hexadecimal
| [+-]?octal
Si un caractère invalide est utilisé dans un entier octal (par exemple, 8 ou 9), le reste du nombre est ignoré.
Example#3 Interprétation des nombres octaux
<?php
var_dump(01090); // 010 octal = 8 decimal
?>
Dépassement de capacité des entiers
Si un nombre est hors de l'intervalle de validité des entiers, il sera interprété comme un float. De même, si vous effectuez une opération qui retourne un nombre hors de l'intervalle de validité des entiers, un float sera retourné.
Example#4 Dépassement de capacité des entiers
<?php
$large_number = 2147483647;
var_dump($large_number);
// affiche : int(2147483647)
$large_number = 2147483648;
var_dump($large_number);
// affiche : float(2147483648)
// c'est vrai aussi pour les entiers hexadécimaux entre 2^31 et 2^32-1:
var_dump( 0xffffffff );
// affiche : float(4294967295)
// cette méthode ne convient pas pour les entiers hexadécimaux supérieurs à 2^32-1 :
var_dump( 0x100000000 );
// affiche : int(2147483647)
$million = 1000000;
$large_number = 50000 * $million;
var_dump($large_number);
// affiche : float(50000000000)
?>
Malheureusement, il y a un bogue dans le moteur (corrigé en 4.1.0), qui fait que PHP ne fonctionne pas toujours bien lorsque des nombres négatifs sont utilisés. Lorsque les deux opérandes sont positifs, il n'y a pas de problèmes. Par exemple : -50000 * $million, conduit à -429496728. Cependant, lorsque les deux opérateurs sont positifs, il n'y a aucun problème.
Ceci a été résolu en PHP 4.1.0.
Il n'existe pas de division entière en PHP. 1/2 générera le float 0.5. Vous pouvez forcer la valeur au format entier pour faire l'arrondi ou bien utiliser la fonction round().
Example#5 Divisions entières
<?php
var_dump(25/7); // float(3.5714285714286)
var_dump((int) (25/7)); // int(3)
var_dump(round(25/7)); // float(4)
?>
Conversion en entiers
Pour explicitement convertir une valeur en entier, utilisez les opérateurs de transtypage (int) ou (integer). Cependant, dans la plupart des situations, vous n'en aurez pas besoin, car une valeur sera automatiquement convertie si un opérateur, une fonction ou tout autre élément du langage requiert un entier. Vous pouvez également convertir une valeur en entier avec la fonction intval().
Voir aussi la section sur les définitions de types.
Depuis un booléen
FALSE devient 0 (zéro), et TRUE devient 1 (un).
Depuis un nombre à virgule flottante
Lors de conversion entre un nombre décimal et un entier, le nombre sera arrondi à la valeur inférieure s'il est positif, et supérieure s'il est négatif (conversion dite 'vers zéro').
Si le nombre est hors de l'intervalle de validité des entiers, (généralement +/- 2.15e+9 = 2^31), le résultat est indéfini, car les nombres à virgule flottante n'ont pas assez de précision pour fournir une valeur exacte pour un entier. Aucune alerte, même pas le plus petit message ne sera affiché dans ce cas !
Ne transformez jamais une fraction inconnue en entier, car cela peut conduire à des résultats irrationnels.
Example#6 Attention aux erreurs de fractions
<?php
echo (int) ( (0.1+0.7) * 10 );
// affiche 7!
?>
À partir de chaînes de caractères
Reportez-vous à la section des conversions de chaînes.
Conversion d'autres types
La conversion d'autres types en entier est indéfinie. En fait, PHP convertit d'abord la valeur en booléen.
Le comportement de la conversion en un entier est indéfini pour les autres types. En fait, le comportement est le même que si la valeur a d'abord été convertie en booléen. Cependant, ne vous fiez pas à ce comportement car il peut changer à tout moment.