Les entiers

Un entier est un nombre appartenant à l'ensemble ℤ = {..., -2, -1, 0, 1, 2, ...}.

Voir aussi :

Syntaxe

Les entiers peuvent être spécifiés en notation décimale (base 10), hexadécimale (base 16), octale (base 8), ou binaire (base 2). L'opérateur de négation peut être utilisé pour désigner un entier négatif.

Les entier littéraux binaires sont disponibles à partir de PHP 5.4.0.

Pour utiliser la notation octale, précédez le nombre d'un 0 (zéro). Pour utiliser la notation hexadécimale, précédez le nombre de 0x. Pour utiliser la notation binaire, précédez le nombre de 0b.

À partir de PHP 7.4.0, les entiers litérals peuvent contenir des underscores (_) entre les chiffres, pour une meilleure lisibilité des litérals. Ces underscores sont supprimés par le scanner de PHP.

Exemple #1 Les entiers littéraux

<?php
$a 
1234// un nombre décimal
$a 0123// un nombre octal (équivalent à 83 en décimal)
$a 0x1A// un nombre héxadecimal (équivalent à 26 en décimal)
$a 0b11111111// un nombre binaire (équivalent à 255 en decimal)
$a 1_234_567// un nombre décimal (à partir de PHP 7.4.0)
?>

Formellement, la structure d'un entier littéral est à partir de PHP 7.4.0 (auparavant, les underscores n'étaient pas autorisé) :

decimal     : [1-9][0-9]*(_[0-9]+)*
            | 0

hexadecimal : 0[xX][0-9a-fA-F]+(_[0-9a-fA-F]+)*

octal       : 0[0-7]+(_[0-7]+)*

binary      : 0[bB][01]+(_[01]+)*

integer     : decimal
            | hexadecimal
            | octal
            | binary

La taille d'un entier est dépendant de la plate-forme, cependant, une valeur maximale d'environ 2 milliards est habituelle (cela correspond à 32 bits signés). Les plateformes 64-bit ont habituellement une valeur maximale d'environ 9E18, sauf pour Windows antérieur à PHP 7, qui est toujours en 32 bit. PHP ne supporte pas les entiers non-signés. La taille d'un entier peut être déterminée en utilisant la constante PHP_INT_SIZE, la valeur maximale, en utilisant la constante PHP_INT_MAX à partir de PHP 5.0.5, et la valeur minimale en utilisant la constante PHP_INT_MIN à partir de PHP 7.0.0.

Avertissement

Antérieur à PHP 7, si un nombre invalide était fourni dans un entier octal (i.e. 8 ou 9), le reste du nombre était ignoré. À partir de PHP 7, une erreur d'analyse est émise.

Débordement d'entier

Si PHP rencontre un nombre supérieur au maximal d'un entier, il sera interprété comme un nombre décimal. De la même façon, une opération qui résulte en un nombre en dehors de l'intervalles du type entier retournera un nombre décimal.

Exemple #2 Dépassement d'entier sur un système 32-bit

<?php
$large_number 
2147483647;
var_dump($large_number);                     // int(2147483647)

$large_number 2147483648;
var_dump($large_number);                     // float(2147483648)

$million 1000000;
$large_number =  50000 $million;
var_dump($large_number);                     // float(50000000000)
?>

Exemple #3 Dépassement d'entier sur un système 64-bit

<?php
$large_number 
9223372036854775807;
var_dump($large_number);                     // int(9223372036854775807)

$large_number 9223372036854775808;
var_dump($large_number);                     // float(9.2233720368548E+18)

$million 1000000;
$large_number =  50000000000000 $million;
var_dump($large_number);                     // float(5.0E+19)
?>

Il n'y a pas d'opérateur de division d'entier en PHP. 1/2 donne le nombre décimal (0.5). La valeur peut être transtypé en un entier pour l'arrondir vers zéro, ou en utilisant la fonction round() pour avoir un contrôle plus fin sur la façon dont l'arrondi est exécuté.

Note: À partir de PHP 7.0.0, la fonction intdiv() est disponible pour la division d'entier.

<?php
var_dump
(25/7);         // float(3.5714285714286) 
var_dump((int) (25/7)); // int(3)
var_dump(round(25/7));  // float(4) 
?>

Conversion en entier

Pour convertir explicitement une valeur en un entier, utiliser soit le mot-clé (int), soit (integer). Cependant, dans la plupart des cas, ce mot-clé n'est pas nécessaire vu qu'une valeur sera automatiquement convertie si un opérateur, une fonction ou une structure de contrôle demande un entier en guise d'argument. Une valeur peut également être convertie en un entier en utilisant la fonction intval().

Si une ressource est convertie vers un entier, alors le résultat sera l'identifiant unique de la ressource assigné par PHP à l'exécution.

Voir aussi le transtypage.

Depuis un booléen

FALSE correspond à 0 (zéro), et TRUE correspond à 1 (un).

Depuis un nombre à virgule flottante

Lorsque l'on convertit un nombre décimal en un entier, le nombre sera arrondi vers zéro.

Si le nombre à virgule flottante est au delà des limites des entiers (habituellement, +/- 2.15e+9 = 2^31 sur les plate-formes 32-bit et +/- 9.22e+18 = 2^63 sur les plate-formes 64-bit autre que Windows), le résultat sera indéfini, sachant que le nombre à virgule flottante n'a pas une précision suffisante pour donner un résultat entier exact. Aucune alerte n'est émise lorsque ce comportement survient !

Note:

À partir de PHP 7.0.0, au lieu d'être indéfini et dépendant de la plateforme, NaN et Infinity seront toujours égal à zéro lors d'une conversion en entier.

Avertissement

Ne convertissez jamais une fraction inconnue en un entier, ceci peut engendrer des résultats inattendus.

<?php
echo (int) ( (0.1+0.7) * 10 ); // Affiche 7 !
?>

Voir aussi la section sur les alertes concernant la précision des nombres à virgule flottante.

Depuis des chaînes de caractères

Voir la section sur la conversion des chaînes en nombres

Depuis NULL

NULL est toujours converti en zéro (0).

Depuis d'autres types

Attention

Le comportement de la conversion en entier est indéfini depuis les autres types. Ne rapporter aucun comportement observé, sachant qu'ils peuvent changer sans avertissement.

add a note add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top