doc-fr/reference/var/functions/intval.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 0c9c2dd669fe9395eaa73d487fbd160f9057429a Maintainer: yannick Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.intval" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>intval</refname>
  <refpurpose>
   Retourne la valeur numérique entière équivalente d'une variable
  </refpurpose>
 </refnamediv>

 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type>int</type><methodname>intval</methodname>
   <methodparam><type>mixed</type><parameter>value</parameter></methodparam>
   <methodparam choice="opt"><type>int</type><parameter>base</parameter><initializer>10</initializer></methodparam>
  </methodsynopsis>
  <para>
   Retourne la valeur &integer; de <parameter>value</parameter> en utilisant
   la <parameter>base</parameter> fourni pour la conversion (par défaut en
   base 10). <function>intval</function> ne devrait pas être utilisée
   sur des objets, dans ces cas, une erreur de niveau <constant>E_NOTICE</constant>
   sera émise et la fonction retournera 1.
  </para>
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>value</parameter></term>
     <listitem>
      <para>
       La valeur scalaire à être convertie en entier
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>base</parameter></term>
     <listitem>
      <para>
       La base pour la conversion
      </para>
      <note>
       <para>
        Si <parameter>base</parameter> vaut 0, la base utilisée
        est déterminée par le format du paramètre <parameter>value</parameter> :
        <itemizedlist>
         <listitem>
          <simpara>
           si la chaîne inclue un préfixe "0x" (ou "0X"), la base prise
           sera 16 (hex) ; sinon,
          </simpara>
         </listitem>
         <listitem>
          <simpara>
           si la chaîne commence par "0", la base prise sera 8 (octal);
           sinon,
          </simpara>
         </listitem>
         <listitem>
          <simpara>
           la base prise sera 10 (décimal).
          </simpara>
         </listitem>
        </itemizedlist>
       </para>
      </note>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>

 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   Une valeur de type &integer; de <parameter>value</parameter> en cas de
   succès ou 0 en cas d'échec. Les tableaux vides retournent 0,
   les tableaux non vides retournent 1.
  </para>
  <para>
   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, <literal>intval('1000000000000')</literal> retournera
   2147483647. La valeur entière signée maximale pour un système à 64 bits est 
   9223372036854775807.
  </para>
  <para>
   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 
   <link linkend="language.types.integer.casting">transtypage d'entier</link> 
   s'applique.
  </para>
 </refsect1>

 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title>Exemples avec <function>intval</function></title>
    <para>
     Les exemples suivants sont basés sur un système à 32 bits.
    </para>
    <programlisting role="php">
<![CDATA[
<?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
echo intval(false);                   // 0
echo intval(true);                    // 1
?>
]]>
    </programlisting>
   </example>
  </para>
 </refsect1>

 <refsect1 role="notes">
  &reftitle.notes;
  <note>
   <para>
    Le paramètre <parameter>base</parameter> n'a aucun effet à moins que le
    paramètre <parameter>value</parameter> soit une &string;.
   </para>
  </note>
 </refsect1>

 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>boolval</function></member>
    <member><function>floatval</function></member>
    <member><function>strval</function></member>
    <member><function>settype</function></member>
    <member><function>is_numeric</function></member>
    <member><link linkend="language.types.type-juggling">Définition du type</link></member>
    <member><link linkend="ref.bc">Nombres de grande taille BCMath</link></member>
   </simplelist>
  </para>
 </refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->