<?xml version="1.0" encoding="utf-8"?>

<sect1 xml:id="language.types.integer">

<title>Les entiers</title>

<simpara>

Un &integer; est un nombre appartenant à l'ensemble

&#8484; = {..., -2, -1, 0, 1, 2, ...}.

</simpara>

<sect2 role="seealso">

&reftitle.seealso;

<para>

<simplelist>

<member><link linkend="language.types.float">Les nombres à virgule flottante</link></member>

<member><link linkend="book.bc">Les précisions arbitraires / BCMath</link></member>

<member><link linkend="book.gmp">Les entiers de longueur arbitraire / GMP</link></member>

</simplelist>

</para>

</sect2>

<sect2 xml:id="language.types.integer.syntax">

<title>Syntaxe</title>

<simpara>

Les &integer;s peuvent être spécifiés en notation décimale (base 10), hexadécimale

(base 16), octale (base 8), ou binaire (base 2).

L'<link linkend="language.operators.arithmetic">opérateur de négation</link>

peut être utilisé pour désigner un &integer; négatif.

</simpara>

<para>

Pour utiliser la notation octale, précédez le nombre d'un <literal>0</literal> (zéro).

À partir de PHP 8.1.0, la notation octale peut être précédée de <literal>0o</literal> ou <literal>0O</literal>.

Pour utiliser la notation hexadécimale, précédez le nombre de <literal>0x</literal>.

Pour utiliser la notation binaire, précédez le nombre de <literal>0b</literal>.

</para>

<para>

À partir de PHP 7.4.0, les entiers littéraux peuvent contenir des underscores

(<literal>_</literal>) entre les chiffres, pour une meilleure lisibilité

des littéraux. Ces underscores sont supprimés par le scanner de PHP.

</para>

<example>

<title>Les entiers littéraux</title>

<programlisting role="php" annotations="non-interactive">

</programlisting>

</example>

<para>

Formellement, la structure d'un <type>entier</type> littéral est à partir de PHP 8.1.0

(auparavant, les préfixes octaux <literal>0o</literal> ou <literal>0O</literal>

n'étaient pas autorisés, et avant PHP 7.4.0, les underscores n'étaient pas autorisés) :

</para>

<informalexample>

<programlisting>

</programlisting>

</informalexample>

<para>

La taille d'un &integer; est dépendante 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.

PHP ne supporte pas les &integer;s non-signés.

La taille d'un &integer; peut être déterminée en utilisant la constante

<constant>PHP_INT_SIZE</constant>, la valeur maximale, en utilisant

la constante <constant>PHP_INT_MAX</constant>,

et la valeur minimale en utilisant la constante

<constant>PHP_INT_MIN</constant>.

</para>

</sect2>

<sect2 xml:id="language.types.integer.overflow">

<title>Débordement d'entier</title>

<para>

Si PHP rencontre un nombre supérieur au maximal d'un &integer;, il sera

interprété comme un &float;. De la même façon, une opération qui résulte en

un nombre en dehors de l'intervalle du type &integer; retournera un &float;.

</para>

<example>

<title>Dépassement d'entier</title>

<programlisting role="php">

</programlisting>

</example>

</sect2>

<sect2 xml:id="language.types.integer.division">

<title>Division d'entier</title>

<para>

Il n'y a pas d'opérateur de division d'&integer; en PHP, pour accomplir ceci

utiliser la fonction <function>intdiv</function>.

<literal>1/2</literal> produit le &float; (<literal>0.5</literal>).

La valeur peut être transtypée en un &integer; pour l'arrondir vers zéro, ou

en utilisant la fonction <function>round</function> pour avoir un contrôle

plus fin sur la façon dont l'arrondi est exécuté.

</para>

<example>

<title>Division</title>

<programlisting role="php">

</programlisting>

</example>

</sect2>

<sect2 xml:id="language.types.integer.casting">

<title>Conversion en entier</title>

<simpara>

Pour convertir explicitement une valeur en un &integer;, utiliser

le mot-clé <literal>(int)</literal>.

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 &integer; en guise

d'argument. Une valeur peut également être convertie en un &integer;

en utilisant la fonction <function>intval</function>.

</simpara>

<simpara>

Si une &resource; est convertie vers un &integer;, alors

le résultat sera l'identifiant unique de la &resource; assigné

par PHP à l'exécution.

</simpara>

<simpara>

Voir aussi <link linkend="language.types.type-juggling">le transtypage</link>.

</simpara>

<sect3 xml:id="language.types.integer.casting.from-boolean">

<title>Depuis un <link linkend="language.types.boolean">booléen</link></title>

<simpara>

&false; correspond à <literal>0</literal> (zéro), et &true; correspond à

<literal>1</literal> (un).

</simpara>

</sect3>

<sect3 xml:id="language.types.integer.casting.from-float">

<title>

Depuis <link linkend="language.types.float">un nombre à virgule flottante</link>

</title>

<simpara>

Lors de la conversion d'un &float; en &integer;, le nombre est arrondi

<emphasis>vers zéro</emphasis>.

À partir de PHP 8.1.0, une notification de dépréciation est émise lors de la

conversion implicite d'un &float; non-intégral en &integer; perdant en précision.

</simpara>

<example>

<title>Conversion depuis des nombres flottants</title>

<programlisting role="php">

</programlisting>

</example>

<para>

Si le nombre à virgule flottante est au-delà des limites des &integer;s (habituellement,

<literal>+/- 2.15e+9 = 2^31</literal> sur les plate-formes 32-bit et

<literal>+/- 9.22e+18 = 2^63</literal> sur les plate-formes 64-bit),

le résultat sera indéfini, sachant que le &float; n'a pas une précision

suffisante pour donner un résultat &integer; exact.

Aucune alerte n'est émise lorsque ce comportement survient !

</para>

<note>

<para>

<literal>NaN</literal>, <literal>Inf</literal> et <literal>-Inf</literal> sont toujours égaux à zéro lors d'une conversion en

<type>int</type>.

</para>

</note>

<warning>

<para>

Ne convertissez jamais une fraction inconnue en un &integer;, ceci peut

engendrer des résultats inattendus.

</para>

<informalexample>

<programlisting role="php">

</programlisting>

</informalexample>

<para>

Voir aussi la section sur <link linkend="warn.float-precision">les alertes

concernant la précision des nombres à virgule flottante</link>.

</para>

</warning>

</sect3>

<sect3 xml:id="language.types.integer.casting.from-string">

<title>Depuis des chaînes de caractères</title>

<simpara>

Si une chaîne est

<link linkend="language.types.numeric-strings">numérique</link>

ou numérique de tête alors elle sera transformée en sa valeur entière

correspondante, sinon elle sera convertie en zéro (<literal>0</literal>).

</simpara>

</sect3>

<sect3 xml:id="language.types.integer.casting-from-null">

<title>Depuis <type>NULL</type></title>

<simpara>

&null; est toujours converti en zéro (<literal>0</literal>).

</simpara>

</sect3>

<sect3 xml:id="language.types.integer.casting.from-other">

<title>Depuis d'autres types</title>

<caution>

<simpara>

Le comportement de la conversion en &integer; est indéfini depuis les autres types.

Ne rapporter <emphasis>aucun</emphasis> comportement observé, sachant qu'ils peuvent

changer sans avertissement.

</simpara>

</caution>

</sect3>

</sect2>

</sect1>