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.
Exemple 11-5. 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) ?>
Techniquement, la structure d'un entier suit les règles suivantes :
Exemple 11-6. 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
La taille des entiers dépend de la plate-forme de support, mais la valeur maximale est généralement de 2 milliards et des poussières (c'est un entier signé de 32 bits). PHP ne supporte pas les entiers non signés.

Avertissement

Si un caractère invalide est utilisé dans un entier octal (par exemple, 8 ou 9), le reste du nombre est ignoré.
Exemple 11-7. 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é.
Exemple 11-8. 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) ?>

Avertissement

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().
Exemple 11-9. 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 !

Avertissement

Ne transformez jamais une fraction inconnue en entier, car cela peut conduire à des résultats irrationnels.
Exemple 11-10. Attention aux erreurs de fractions
<?php echo (int) ( (0.1+0.7) * 10 ); // affiche 7! ?>
Pour plus d'informations, reportez-vous aux alertes liées aux nombres décimaux.

À 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.

Attention

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.

language types integer