cvs: phpdoc /fr/functions math.xml
| From: | Damien Seguy | Date: | Tue, 24 Jul 2001 13:08:31 +0000 |
| Subject: | cvs: phpdoc /fr/functions math.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969336475@lists.php.net to get a copy of this message | ||
dams Tue Jul 24 09:08:31 2001 EDT
Modified files:
/phpdoc/fr/functions math.xml
Log:
Adding reference to Neper (for log)
Index: phpdoc/fr/functions/math.xml diff -u phpdoc/fr/functions/math.xml:1.10 phpdoc/fr/functions/math.xml:1.11 --- phpdoc/fr/functions/math.xml:1.10 Sat Jun 23 16:35:10 2001 +++ phpdoc/fr/functions/math.xml Tue Jul 24 09:08:31 2001 @@ -1,1117 +1,1243 @@ - <reference id="ref.math"> - <title>Mathématiques</title> - <titleabbrev>Maths</titleabbrev> - <partintro> - <sect1 id="math.intro"> - <title>Introduction</title> - <para> - Ces fonctions ne sont capables de manipuler que des entiers double, ou - des long. Si vous avez besoin de manipuler des nombres plus grands, - reportez vous aux fonctions mathématiques sur des - <link linkend="ref.bc">nombres de grande taille</link>. - </para> - <sect2 id="math.constants"> - <title>Constantes mathématiques</title> - <para> - Les valeurs suivantes sont définies comme des constantes dans PHP: - <table> - <title>Constantes mathématiques</title> - <tgroup cols="3"> - <thead> - <row> - <entry>Constante</entry> - <entry>Valeur</entry> - <entry>Description</entry> - </row> - </thead> - <tbody> - <row> - <entry>M_PI</entry> - <entry>3.14159265358979323846</entry> - <entry>Pi</entry> - </row> - <row> - <entry>M_E</entry> - <entry>2.7182818284590452354</entry> - <entry>e</entry> - </row> - <row> - <entry>M_LOG2E</entry> - <entry>1.4426950408889634074</entry> - <entry>log_2 e</entry> - </row> - <row> - <entry>M_LOG10E</entry> - <entry>0.43429448190325182765</entry> - <entry>log_10 e</entry> - </row> - <row> - <entry>M_LN2</entry> - <entry>0.69314718055994530942</entry> - <entry>log_e 2</entry> - </row> - <row> - <entry>M_LN10</entry> - <entry>2.30258509299404568402</entry> - <entry>log_e 10</entry> - </row> - <row> - <entry>M_PI_2</entry> - <entry>1.57079632679489661923</entry> - <entry>pi/2</entry> - </row> - <row> - <entry>M_PI_4</entry> - <entry>0.78539816339744830962</entry> - <entry>pi/4</entry> - </row> - <row> - <entry>M_1_PI</entry> - <entry>0.31830988618379067154</entry> - <entry>1/pi</entry> - </row> - <row> - <entry>M_2_PI</entry> - <entry>0.63661977236758134308</entry> - <entry>2/pi</entry> - </row> - <row> - <entry>M_SQRTPI</entry> - <entry>1.77245385090551602729</entry> - <entry>sqrt(pi) [4.0.2]</entry> - </row> - <row> - <entry>M_2_SQRTPI</entry> - <entry>1.12837916709551257390</entry> - <entry>2/sqrt(pi)</entry> - </row> - <row> - <entry>M_SQRT2</entry> - <entry>1.41421356237309504880</entry> - <entry>sqrt(2)</entry> - </row> - <row> - <entry>M_SQRT3</entry> - <entry>1.73205080756887729352</entry> - <entry>sqrt(3) [4.0.2]</entry> - </row> - <row> - <entry>M_SQRT1_2</entry> - <entry>0.70710678118654752440</entry> - <entry>1/sqrt(2)</entry> - </row> - <row> - <entry>M_LNPI</entry> - <entry>1.14472988584940017414</entry> - <entry>log_e(pi) [4.0.2]</entry> - </row> - <row> - <entry>M_EULER</entry> - <entry>0.57721566490153286061</entry> - <entry>Euler constant [4.0.2]</entry> - </row> - </tbody> - </tgroup> - </table> - </para> - </sect2> - </sect1> - </partintro> - <refentry id="function.abs"> - <refnamediv> - <refname>abs</refname> - <refpurpose>Valeur absolue</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>mixed <function>abs</function></funcdef> - <paramdef>mixed <parameter>number</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>abs</function> retourne la valeur absolue du nombre - <parameter>number</parameter>. Si le nombre est de type float, - le type retourné est float, sinon, c'est integer (entier). - </para> - </refsect1> - </refentry> - <refentry id="function.acos"> - <refnamediv> - <refname>acos</refname> - <refpurpose>arc cosinus</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>float <function>acos</function></funcdef> - <paramdef>float <parameter>arg</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>acos</function> retourne l'arc cosinus de - <parameter>arg</parameter> (<parameter>arg</parameter> en radians). - </para> - <para> - Voir aussi <function>asin</function> et <function>atan</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.asin"> - <refnamediv> - <refname>asin</refname> - <refpurpose>arc sinus</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>float <function>asin</function></funcdef> - <paramdef>float <parameter>arg</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>asin</function> retourne l'arc sinus de - <parameter>arg</parameter> (<parameter>arg</parameter> en radians). - </para> - <para> - Voir aussi <function>acos</function> et <function>atan</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.atan"> - <refnamediv> - <refname>atan</refname> - <refpurpose>arc tangent</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> +<reference id="ref.math"> + <title>Mathématiques</title> + <titleabbrev>Maths</titleabbrev> + <partintro> + <sect1 id="math.intro"> + <title>Introduction</title> + <para> + Ces fonctions ne sont capables de manipuler que des entiers "double", ou + des "long". Si vous avez besoin de manipuler des nombres plus grands, + reportez-vous aux fonctions mathématiques sur des + <link linkend="ref.bc">nombres de grande taille</link>. + </para> + <sect2 id="math.constants"> + <title>Constantes mathématiques</title> + <para> + Les valeurs suivantes sont définies comme des constantes en PHP : + <table> + <title>Constantes mathématiques</title> + <tgroup cols="3"> + <thead> + <row> + <entry>Constante</entry> + <entry>Valeur</entry> + <entry>Description</entry> + </row> + </thead> + <tbody> + <row> + <entry>M_PI</entry> + <entry>3.14159265358979323846</entry> + <entry>Pi</entry> + </row> + <row> + <entry>M_E</entry> + <entry>2.7182818284590452354</entry> + <entry>e</entry> + </row> + <row> + <entry>M_LOG2E</entry> + <entry>1.4426950408889634074</entry> + <entry>log_2 e</entry> + </row> + <row> + <entry>M_LOG10E</entry> + <entry>0.43429448190325182765</entry> + <entry>log_10 e</entry> + </row> + <row> + <entry>M_LN2</entry> + <entry>0.69314718055994530942</entry> + <entry>log_e 2</entry> + </row> + <row> + <entry>M_LN10</entry> + <entry>2.30258509299404568402</entry> + <entry>log_e 10</entry> + </row> + <row> + <entry>M_PI_2</entry> + <entry>1.57079632679489661923</entry> + <entry>pi/2</entry> + </row> + <row> + <entry>M_PI_4</entry> + <entry>0.78539816339744830962</entry> + <entry>pi/4</entry> + </row> + <row> + <entry>M_1_PI</entry> + <entry>0.31830988618379067154</entry> + <entry>1/pi</entry> + </row> + <row> + <entry>M_2_PI</entry> + <entry>0.63661977236758134308</entry> + <entry>2/pi</entry> + </row> + <row> + <entry>M_SQRTPI</entry> + <entry>1.77245385090551602729</entry> + <entry>sqrt(pi) [4.0.2]</entry> + </row> + <row> + <entry>M_2_SQRTPI</entry> + <entry>1.12837916709551257390</entry> + <entry>2/sqrt(pi)</entry> + </row> + <row> + <entry>M_SQRT2</entry> + <entry>1.41421356237309504880</entry> + <entry>sqrt(2)</entry> + </row> + <row> + <entry>M_SQRT3</entry> + <entry>1.73205080756887729352</entry> + <entry>sqrt(3) [4.0.2]</entry> + </row> + <row> + <entry>M_SQRT1_2</entry> + <entry>0.70710678118654752440</entry> + <entry>1/sqrt(2)</entry> + </row> + <row> + <entry>M_LNPI</entry> + <entry>1.14472988584940017414</entry> + <entry>log_e(pi) [4.0.2]</entry> + </row> + <row> + <entry>M_EULER</entry> + <entry>0.57721566490153286061</entry> + <entry>Euler constant [4.0.2]</entry> + </row> + </tbody> + </tgroup> + </table> + </para> + </sect2> + </sect1> + </partintro> + <refentry id="function.abs"> + <refnamediv> + <refname>Abs</refname> + <refpurpose>Valeur absolue</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>mixed <function>abs</function></funcdef> + <paramdef>mixed <parameter>number</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>abs</function> retourne la valeur absolue du nombre + <parameter>number</parameter>. Si le nombre est un nombre à + virgule flottante (<type>float</type>), le type retourné + est aussi un nombre à virgule flottante (<type>float</type>), + sinon, c'est un entier (<type>integer</type>). + </para> + </refsect1> + </refentry> + <refentry id="function.acos"> + <refnamediv> + <refname>Acos</refname> + <refpurpose>arc cosinus</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>float <function>acos</function></funcdef> + <paramdef>float <parameter>arg</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>acos</function> retourne l'arc cosinus de + <parameter>arg</parameter> (<parameter>arg</parameter> en radians). + </para> + <para> + Voir aussi + <function>asin</function> et + <function>atan</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.asin"> + <refnamediv> + <refname>Asin</refname> + <refpurpose>arc sinus</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>float <function>asin</function></funcdef> + <paramdef>float <parameter>arg</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>asin</function> retourne l'arc sinus de + <parameter>arg</parameter> (<parameter>arg</parameter> en radians). + </para> + <para> + Voir aussi + <function>acos</function> et + <function>atan</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.atan"> + <refnamediv> + <refname>Atan</refname> + <refpurpose>arc tangent</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>float <function>atan</function></funcdef> <paramdef>float <parameter>arg</parameter></paramdef> - </funcsynopsis> - <para> - <function>atan</function> retourne l'arc tangent de - <parameter>arg</parameter> (<parameter>arg</parameter> en radians). - </para> - <para> - Voir aussi <function>acos</function> et <function>atan</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.atan2"> - <refnamediv> - <refname>atan2</refname> - <refpurpose>arc tangent de deux variables</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>float <function>atan2</function></funcdef> - <paramdef>float <parameter>y</parameter></paramdef> - <paramdef>float <parameter>x</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <simpara> - <function>atan2</function> retourne l' arc tangent de deux variables - x et y. La formule est : " arc tangent (y / x) ", et les signes des - arguments sont utilisés pour déterminer le quadrant du - résultat. - </simpara> - <simpara> - <function>atan2</function> retourne un résultat en radians, - entre -PI et PI (inclus). - </simpara> - <para> - Voir aussi <function>acos</function> et <function>atan</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.base-convert"> - <refnamediv> - <refname>base_convert</refname> - <refpurpose>Convertit un nombre en des bases arbitraires.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>base_convert</function></funcdef> - <paramdef>string <parameter>number</parameter></paramdef> - <paramdef>int <parameter>frombase</parameter></paramdef> - <paramdef>int <parameter>tobase</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>base_convert</function> retourne une chaîne contenant - l'argument <parameter>number</parameter> représenté - dans la base <parameter>tobase</parameter>. La base de - représentation de <parameter>number</parameter> est - donnée par <parameter>frombase</parameter>. - <parameter>frombase</parameter> et <parameter>tobase</parameter> - doivent être compris entre 2 et 36, inclus. Les chiffres - supérieurs à 10 des bases supérieures - à 10 seront représentées par les lettres - de a à z, avec a = 10 et z = 36. - <example> - <title><function>base_convert</function></title> - <programlisting role="php"> + </funcprototype> + </funcsynopsis> + <para> + <function>atan</function> retourne l'arc tangent de + <parameter>arg</parameter> (<parameter>arg</parameter> en radians). + </para> + <para> + Voir aussi + <function>acos</function> et + <function>atan</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.atan2"> + <refnamediv> + <refname>Atan2</refname> + <refpurpose>arc tangent de deux variables</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>float <function>atan2</function></funcdef> + <paramdef>float <parameter>y</parameter></paramdef> + <paramdef>float <parameter>x</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <simpara> + <function>atan2</function> retourne l'arc tangent de deux variables + <parameter>x</parameter> et <parameter>y</parameter>. La formule est : + " arc tangent (y / x) ", et les signes des + arguments sont utilisés pour déterminer le quadrant du + résultat. + </simpara> + <simpara> + <function>atan2</function> retourne un résultat en radians, + entre -PI et PI (inclus). + </simpara> + <para> + Voir aussi + <function>acos</function> et + <function>atan</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.base-convert"> + <refnamediv> + <refname>base_convert</refname> + <refpurpose>Convertit un nombre entre des bases arbitraires.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>base_convert</function></funcdef> + <paramdef>string <parameter>number</parameter></paramdef> + <paramdef>int <parameter>frombase</parameter></paramdef> + <paramdef>int <parameter>tobase</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>base_convert</function> retourne une chaîne contenant + l'argument <parameter>number</parameter> représenté + dans la base <parameter>tobase</parameter>. La base de + représentation de <parameter>number</parameter> est + donnée par <parameter>frombase</parameter>. + <parameter>frombase</parameter> et <parameter>tobase</parameter> + doivent être compris entre 2 et 36 inclus. Les chiffres + supérieurs à 10 des bases supérieures + à 10 seront représentés par les lettres + de A à Z, avec A = 10 et Z = 36. + <example> + <title><function>base_convert</function></title> + <programlisting role="php"> <?php -$binary = base_convert($hexadecimal, 16, 2); + $binary = base_convert($hexadecimal, 16, 2); ?> - </programlisting> - </example> - </para> - </refsect1> - </refentry> - <refentry id="function.bindec"> - <refnamediv> - <refname>BinDec</refname> - <refpurpose>Convertit de binaire en décimal</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>bindec</function></funcdef> - <paramdef>string <parameter>binary_string</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>bindec</function> retourne la conversion d'un nombre - binaire représenté par la chaîne - <parameter>binary_string</parameter> en décimal. - </para> - <para> - <function>bindec</function> convertit un nombre binaire en décimal. - Le plus grand nombre convertible a 31 bits à 1, soit - 2147483647 en décimal. - </para> - <para> - Voir aussi <function>decbin</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.ceil"> - <refnamediv> - <refname>ceil</refname> - <refpurpose>arrondi au nombre supérieur</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>ceil</function></funcdef> - <paramdef>float <parameter>number</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>ceil</function> retourne l'entier supérieur du - nombre <parameter>number</parameter>. Utiliser - <function>ceil</function> sur un entier ne sert à rien. - <informalexample> - <programlisting role="php"> + </programlisting> + </example> + </para> + </refsect1> + </refentry> + <refentry id="function.bindec"> + <refnamediv> + <refname>BinDec</refname> + <refpurpose>Convertit de binaire en décimal</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>bindec</function></funcdef> + <paramdef>string <parameter>binary_string</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>bindec</function> retourne la conversion d'un nombre + binaire représenté par la chaîne + <parameter>binary_string</parameter> en décimal. + </para> + <para> + <function>bindec</function> convertit un nombre binaire en décimal. + Le plus grand nombre convertible a 31 bits à 1, soit + 2147483647 en décimal. + </para> + <para> + Voir aussi + <function>decbin</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.ceil"> + <refnamediv> + <refname>Ceil</refname> + <refpurpose>Arrondit au nombre supérieur</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>float <function>ceil</function></funcdef> + <paramdef>float <parameter>number</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ceil</function> retourne l'entier supérieur du + nombre <parameter>number</parameter>. Utiliser + <function>ceil</function> sur un entier ne sert à rien. + La valeur retournée est un nombre à virgule flottante + (<type>float</type>), car ces nombres peuvent être plus + grands que les entiers. + <informalexample> + <programlisting role="php"> <?php -$x = ceil(4.25); + $x = ceil(4.25); // ce qui donne $x=5 ?> - </programlisting> - </informalexample> - </para> - <simpara> - NOTE: <function>ceil</function> sous PHP/FI 2 retournait un nombre à - virgule flottante. Utilisez: <literal>$new = (double)ceil($number);</literal> - pour retrouver le comportement traditionnel. + </programlisting> + </informalexample> + </para> + <simpara> + NOTE: <function>ceil</function> sous PHP/FI 2 retournait un nombre à + virgule flottante. Utilisez: <literal>$new = (double)ceil($number);</literal> + pour retrouver le comportement traditionnel. </simpara> - <simpara> - Voir aussi <function>floor</function> et <function>round</function>. - </simpara> - </refsect1> - </refentry> - <refentry id="function.cos"> - <refnamediv> - <refname>cos</refname> - <refpurpose>cosinus</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>float <function>cos</function></funcdef> - <paramdef>float <parameter>arg</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>cos</function> retourne le cosinus de arg (<parameter>arg</parameter> en radians). - </para> - <para> - Voir aussi <function>sin</function> et <function>tan</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.decbin"> - <refnamediv> - <refname>DecBin</refname> - <refpurpose>Convertit de décimal en binaire</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>decbin</function></funcdef> - <paramdef>int <parameter>number</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>decbin</function> retourne une chaîne contenant - la représentation binaire de l'entier donné en argument. - Le plus grand nombre pouvant être converti est 2147483647 - en décimal, ce qui donne une série de 31 uns (1). - </para> - <para> - Voir aussi <function>bindec</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.dechex"> - <refnamediv> - <refname>DecHex</refname> - <refpurpose>Convertit de décimal en hexadécimal </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>dechex</function></funcdef> - <paramdef>int <parameter>number</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>dechex</function> retourne une chaîne contenant - la représentation hexadécimale du nombre - <parameter>number</parameter>. Le nombre le plus grand qui puisse être - convertit est 2147483647 en décimal, ce qui donnera "7fffffff". - </para> - <para> - Voir aussi <function>hexdec</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.decoct"> - <refnamediv> - <refname>DecOct</refname> - <refpurpose>Convertit de décimal en octal </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>decoct</function></funcdef> - <paramdef>int <parameter>number</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>decoct</function> retourne une chaîne contenant - la représentation octale du nombre donné - <parameter>number</parameter>. Le nombre le plus grand qui puisse - être converti est 2147483647 en décimal, ce qui - donnera "17777777777". - </para> - <para> - Voir aussi <function>octdec</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.deg2rad"> - <refnamediv> - <refname>deg2rad</refname> - <refpurpose> - Convertit un nombre en degré en radians - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>double <function>deg2rad</function></funcdef> - <paramdef>double <parameter>number</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>deg2rad</function> convertit <parameter>number</parameter> de - degrés en radians. - </para> - <para> - Voir aussi <function>rad2deg</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.exp"> - <refnamediv> - <refname>exp</refname> - <refpurpose>exponentielle</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> + <simpara> + Voir aussi + <function>floor</function> et + <function>round</function>. + </simpara> + </refsect1> + </refentry> + <refentry id="function.cos"> + <refnamediv> + <refname>Cos</refname> + <refpurpose>cosinus</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>float <function>cos</function></funcdef> + <paramdef>float <parameter>arg</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>cos</function> retourne le cosinus de <parameter>arg</parameter> + (<parameter>arg</parameter> en radians). + </para> + <para> + Voir aussi + <function>sin</function> et + <function>tan</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.decbin"> + <refnamediv> + <refname>DecBin</refname> + <refpurpose>Convertit de décimal en binaire</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>decbin</function></funcdef> + <paramdef>int <parameter>number</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>decbin</function> retourne une chaîne contenant + la représentation binaire de l'entier donné en argument. + Le plus grand nombre pouvant être converti est 2147483647 + en décimal, ce qui donne une série de 31 uns (1). + </para> + <para> + Voir aussi + <function>bindec</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.dechex"> + <refnamediv> + <refname>DecHex</refname> + <refpurpose>Convertit de décimal en hexadécimal </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>dechex</function></funcdef> + <paramdef>int <parameter>number</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>dechex</function> retourne une chaîne contenant + la représentation hexadécimale du nombre + <parameter>number</parameter>. Le nombre le plus grand qui puisse être + converti est 2147483647 en décimal, ce qui donnera "7fffffff". + </para> + <para> + Voir aussi + <function>hexdec</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.decoct"> + <refnamediv> + <refname>DecOct</refname> + <refpurpose>Convertit de décimal en octal </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>decoct</function></funcdef> + <paramdef>int <parameter>number</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>decoct</function> retourne une chaîne contenant + la représentation octale du nombre donné + <parameter>number</parameter>. Le nombre le plus grand qui puisse + être converti est 2147483647 en décimal, ce qui + donnera "17777777777". + </para> + <para> + Voir aussi + <function>octdec</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.deg2rad"> + <refnamediv> + <refname>deg2rad</refname> + <refpurpose> + Convertit un nombre de degrés en radians + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>double <function>deg2rad</function></funcdef> + <paramdef>double <parameter>number</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>deg2rad</function> convertit <parameter>number</parameter> de + degrés en radians. + </para> + <para> + Voir aussi + <function>rad2deg</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.exp"> + <refnamediv> + <refname>Exp</refname> + <refpurpose>exponentielle</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>float <function>exp</function></funcdef> <paramdef>float <parameter>arg</parameter></paramdef> - </funcsynopsis> - <para> - <function>exp</function> retourne l'exponentielle de - <parameter>arg</parameter>, c'est à dire - e élevé à la puissance - <parameter>arg</parameter>. - </para> - <para> - Voir aussi <function>pow</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.floor"> - <refnamediv> - <refname>floor</refname> - <refpurpose>Arrondi à l'entier inférieur </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>floor</function></funcdef> - <paramdef>float <parameter>number</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <simpara> - <function>floor</function> retourne l'entier inférieur - du nombre <parameter>number</parameter>. Utiliser - <function>floor</function> sur un entier ne sert à rien. - </simpara> - <simpara> - NOTE: <function>floor</function> sous PHP/FI retournait un float. - Utilisez: <literal>$new = (double)floor($number);</literal> - pour retrouver le comportement traditionnel. - </simpara> - <simpara> - Voir aussi <function>ceil</function> et <function>round</function>. - </simpara> - </refsect1> - </refentry> - <refentry id="function.getrandmax"> - <refnamediv> - <refname>getrandmax</refname> - <refpurpose>Plus grande valeur aléatoire possible.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>getrandmax</function></funcdef> - <paramdef>void </paramdef> - </funcprototype> - </funcsynopsis> - <simpara> - <function>getrandmax</function> retourne la plus grande valeur - aléatoire possible retournée par <function>rand</function>. - </simpara> - <simpara> - Voir aussi <function>rand</function>, - <function>srand</function> - <function>mt_rand</function>, - <function>mt_srand</function> et - <function>mt_getrandmax</function>. - </simpara> - </refsect1> - </refentry> - <refentry id="function.hexdec"> - <refnamediv> - <refname>HexDec</refname> - <refpurpose>Convertit de hexadécimal en décimal </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>hexdec</function></funcdef> - <paramdef>string <parameter>hex_string</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>hexdec</function> retourne une chaîne contenant la - représentation décimal du nombre - <parameter>hex_string</parameter>. Le nombre le plus grand - qui puisse être converti est 7fffffff en décimal, - ce qui donne "2147483647 ". - </para> - <para> - Voir aussi the <function>dechex</function>. - </para> - </refsect1> - </refentry> -<refentry id="function.lcg-value"> - <refnamediv> - <refname>lcg_value</refname> - <refpurpose> - Générateur de congruence combinée linéaire - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>double <function>lcg_value</function></funcdef> - <paramdef>void</paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>lcg_value</function> retourne un nombre pseudo-aléatoire, - compris entre 0 et 1. <function>lcg_value</function> combine deux - générateurs de congruence, de période respectives - 2^31 - 85 et 2^31 - 249. La période de cette fonction est le - produit de ces deux nombres premiers (soit ¤2^31 - 85)*(2^31 - 249)). - </para> - </refsect1> - </refentry> - <refentry id="function.log"> - <refnamediv> - <refname>log</refname> - <refpurpose>Logarithme naturel </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>float <function>log</function></funcdef> - <paramdef>float <parameter>arg</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>log</function> retourne le logarithme naturel de <parameter>arg</parameter>. - </para> - </refsect1> - </refentry> - <refentry id="function.log10"> - <refnamediv> - <refname>log10</refname> - <refpurpose>logarithme en base 10.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>float <function>log10</function></funcdef> - <paramdef>float <parameter>arg</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>log10</function> retourne le logarithme en base 10 de - <parameter>arg</parameter>. - </para> - </refsect1> - </refentry> - <refentry id="function.max"> - <refnamediv> - <refname>max</refname> - <refpurpose>La plus grande valeur.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>mixed <function>max</function></funcdef> - <paramdef>mixed <parameter>arg1</parameter></paramdef> - <paramdef>mixed <parameter>arg2</parameter></paramdef> - <paramdef>mixed <parameter>argn</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>max</function> retourne la plus grande valeur - numérique parmi les valeurs passées en paramètre. - </para> - <para> - Si le premier paramètre est un tableau, - <function>max</function> retourne la plus grande valeur de ce tableau. - Si le premier paramètre est un entier, une chaîne ou - un double, <function>max</function> requiert au moins deux paramètres, - et retournera alors le plus grand d'entre eux. - Le nombre d'argument est alors illimité. - </para> - <para> - Si au moins une valeur est de type double, elle seront toutes - traitées comme des doubles, et un double sera retourné. - Si aucune valeur n'est de type double, elles seront traitées - comme des entiers, et un entier sera retourné. - </para> - </refsect1> - </refentry> - <refentry id="function.min"> - <refnamediv> - <refname>min</refname> - <refpurpose>La plus petite valeur.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>mixed <function>min</function></funcdef> - <paramdef>mixed <parameter>arg1</parameter></paramdef> - <paramdef>mixed <parameter>arg2</parameter></paramdef> - <paramdef>mixed <parameter>argn</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>min</function> retourne la plus petite valeur - numérique parmi les valeurs passées en paramètre. - </para> - <para> - Si le premier paramètre est un tableau, <function>min</function> - retourne la plus petite valeur de ce tableau. Si le premier - paramètre est un entier, une chaîne ou un double, - <function>min</function> requiert au moins deux paramètres, et - retournera alors le plus petit d'entre eux. Le nombre d'argument est alors - illimité. - </para> + </funcprototype> + </funcsynopsis> + <para> + <function>exp</function> retourne l'exponentielle de + <parameter>arg</parameter>, c'est-à-dire + e élevé à la puissance + <parameter>arg</parameter>. + </para> + <para> + Voir aussi + <function>pow</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.floor"> + <refnamediv> + <refname>Floor</refname> + <refpurpose>Arrondi à l'entier inférieur </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>floats <function>floor</function></funcdef> + <paramdef>float <parameter>number</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <simpara> + <function>floor</function> retourne l'entier inférieur + du nombre <parameter>number</parameter>. La valeur retournée + est un nombre à virgule flottante, (<type>float</type>) + car ces nombres peuvent être plus grands que les entiers. + </simpara> + <simpara> + NOTE: <function>floor</function> sous PHP/FI retournait un float. + Utilisez: <literal>$new = (double)floor($number);</literal> + pour retrouver le comportement traditionnel. + </simpara> + <simpara> + Voir aussi + <function>ceil</function> et + <function>round</function>. + </simpara> + </refsect1> + </refentry> + <refentry id="function.getrandmax"> + <refnamediv> + <refname>getrandmax</refname> + <refpurpose>Plus grande valeur aléatoire possible.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>getrandmax</function></funcdef> + <paramdef>void </paramdef> + </funcprototype> + </funcsynopsis> + <simpara> + <function>getrandmax</function> retourne la plus grande valeur + aléatoire possible retournée par <function>rand</function>. + </simpara> + <simpara> + Voir aussi + <function>rand</function>, + <function>srand</function> + <function>mt_rand</function>, + <function>mt_srand</function> et + <function>mt_getrandmax</function>. + </simpara> + </refsect1> + </refentry> + <refentry id="function.hexdec"> + <refnamediv> + <refname>hexdec</refname> + <refpurpose>Convertit de hexadécimal en décimal</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>hexdec</function></funcdef> + <paramdef>string <parameter>hex_string</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>hexdec</function> retourne une chaîne contenant la + représentation décimale du nombre + <parameter>hex_string</parameter>. Le nombre le plus grand + qui puisse être converti est 7fffffff en décimal, + ce qui donne "2147483647". + </para> <para> - Si au moins une valeur est de type double, elle seront toutes - traitées comme des doubles, et un double sera retourné. - Si aucune valeur n'est de type double, elles seront traitées - comme des entiers, et un entier sera retourné. + <function>hexdec</function> remplace tous les caractères non-héxadecimal + par des <literal>0</literal>. Et si les zéros de gauche sont ignorés, + ceux de droite prennent le propre valeur. + <example> + <title>Exemple avec <function>hexdec</function></title> + <programlisting role="php"> +<?php + var_dump(hexdec("Hop comme ceci")); + var_dump(hexdec("0000c000e0cec0")); + var_dump(hexdec("c000e0cec0")); +// les deux affichent "int(14732992)" + var_dump(hexdec("aussi")); + var_dump(hexdec("a0000")); +// les deux affichent "int(655360)" +?> + </programlisting> + </example> </para> - </refsect1> - </refentry> - <refentry id="function.mt-rand"> - <refnamediv> - <refname>mt_rand</refname> - <refpurpose> - Génère une meilleure valeur aléatoire. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> + <para> + Voir aussi + <function>dechex</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.lcg-value"> + <refnamediv> + <refname>lcg_value</refname> + <refpurpose> + Générateur de congruence combinée linéaire + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>double <function>lcg_value</function></funcdef> + <paramdef>void</paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>lcg_value</function> retourne un nombre pseudo-aléatoire, + compris entre 0 et 1. <function>lcg_value</function> combine deux + générateurs de congruence, de périodes respectives + <literal>2^31 - 85</literal> et <literal>2^31 - 249</literal>. + La période de cette fonction est le produit de ces deux + nombres premiers (soit <literal>(2^31 - 85)*(2^31 - 249)</literal>). + </para> + </refsect1> + </refentry> + <refentry id="function.log"> + <refnamediv> + <refname>Log</refname> + <refpurpose>Logarithme naturel (nprien)</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>float <function>log</function></funcdef> + <paramdef>float <parameter>arg</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>log</function> retourne le logarithme naturel + (ou nprien) de <parameter>arg</parameter>. + </para> + </refsect1> + </refentry> + <refentry id="function.log10"> + <refnamediv> + <refname>Log10</refname> + <refpurpose>logarithme en base 10.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>float <function>log10</function></funcdef> + <paramdef>float <parameter>arg</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>log10</function> retourne le logarithme en base 10 de + <parameter>arg</parameter>. + </para> + </refsect1> + </refentry> + <refentry id="function.max"> + <refnamediv> + <refname>max</refname> + <refpurpose>La plus grande valeur.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>mixed <function>max</function></funcdef> + <paramdef>mixed <parameter>arg1</parameter></paramdef> + <paramdef>mixed <parameter>arg2</parameter></paramdef> + <paramdef>mixed <parameter>argn</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>max</function> retourne la plus grande valeur + numérique parmi les valeurs passées en paramètre. + </para> + <para> + Si le premier paramètre est un tableau, + <function>max</function> retourne la plus grande valeur de ce tableau. + Si le premier paramètre est un entier, une chaîne ou + un double, <function>max</function> requiert au moins deux paramètres, + et retournera alors le plus grand d'entre eux. + Le nombre d'arguments est alors illimité. + </para> + <para> + Si au moins une valeur est un entier double, elles seront toutes + traitées comme des doubles, et un double sera retourné. + Si aucune valeur n'est de type double, elles seront traitées + comme des entiers, et un entier sera retourné. + </para> + </refsect1> + </refentry> + <refentry id="function.min"> + <refnamediv> + <refname>min</refname> + <refpurpose>La plus petite valeur.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>mixed <function>min</function></funcdef> + <paramdef>mixed <parameter>arg1</parameter></paramdef> + <paramdef>mixed <parameter>arg2</parameter></paramdef> + <paramdef>mixed <parameter>argn</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>min</function> retourne la plus petite valeur + numérique parmi les valeurs passées en paramètres. + </para> + <para> + Si le premier paramètre est un tableau, <function>min</function> + retourne la plus petite valeur de ce tableau. Si le premier + paramètre est un entier, une chaîne ou un double, + <function>min</function> requiert au moins deux paramètres, et + retournera alors le plus petit d'entre eux. Le nombre d'arguments est alors + illimité. + </para> + <para> + Si au moins une valeur est un entier double, elles seront toutes + traitées comme des doubles, et un double sera retourné. + Si aucune valeur n'est de type double, elles seront traitées + comme des entiers, et un entier sera retourné. + </para> + </refsect1> + </refentry> + <refentry id="function.mt-rand"> + <refnamediv> + <refname>mt_rand</refname> + <refpurpose> + Génère une meilleure valeur aléatoire. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>int <function>mt_rand</function></funcdef> - <paramdef> - <parameter><optional>int min</optional></parameter> + <paramdef>int + <parameter><optional>min</optional></parameter> </paramdef> - <paramdef> - <parameter><optional>int max</optional></parameter> + <paramdef>int + <parameter><optional>max</optional></parameter> </paramdef> - </funcsynopsis> - <simpara> - De nombreux générateurs de nombre aléatoires - provenant de vieilles bibliothèques libcs ont des comportement - douteux et sont très lents. Par défaut, PHP utilise le - générateur de nombres aléatoires de libc avec la - fonction <function>rand</function>. <function>mt_rand</function> est une - fonction de remplacement, pour cette dernière. Elle utilise un - générateur de nombre aléatoire de caractéristique - connue, le " Mersenne Twister ", qui va produire des nombres utilisables en - cryptographie, et qui est 4 fois plus rapide que la fonction standard libc. - La "Homepage of the Mersenne Twister " est - <ulink url="&url.mersenne;">&url.mersenne;</ulink>, une version optimisée - des sources de MT est disponible à - <ulink url="&url.mersenne.twister;">&url.mersenne.twister;</ulink>. - </simpara> - <simpara> - Appelé sans les arguments optionnels <parameter>min</parameter>, - <parameter>max</parameter>, <function>mt_rand</function> retourne un nombre - pseudo-aléatoire, entre 0 et <constant>RAND_MAX</constant>. - Pour obtenir un nombre entre 5 et 15 (inclus), il faut utiliser - <literal>mt_rand(5,15)</literal>. - </simpara> - <simpara> - N'oubliez pas d'initialiser le générateur de nombre - aléatoire avec <function>mt_srand</function>. - </simpara> - <note> - <para> - Dans les versions antérieure à la 3.0.7 la signification - du paramètre <parameter>max</parameter> était "longueur". - Pour avoir le même résultat, il faut utiliser - <literal>mt_rand (5, 11)</literal> pour obtenir un nombre - aléatoire entre 5 et 15. - </para> - </note> - <simpara> - Voir aussi <function>mt_srand</function>, <function>mt_getrandmax</function>, - <function>srand</function>, <function>rand</function> et - <function>getrandmax</function>. - </simpara> - </refsect1> - </refentry> - <refentry id="function.mt-srand"> - <refnamediv> - <refname>mt_srand</refname> - <refpurpose>Initialise une meilleure valeur aléatoire</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>void <function>mt_srand</function></funcdef> - <paramdef>int <parameter>seed</parameter></paramdef> - </funcprototype> - </funcsynopsis> + </funcprototype> + </funcsynopsis> + <simpara> + De nombreux générateurs de nombres aléatoires + provenant de vieilles bibliothèques libcs ont des comportement + douteux et sont très lents. Par défaut, PHP utilise le + générateur de nombres aléatoires de libc avec la + fonction <function>rand</function>. <function>mt_rand</function> est une + fonction de remplacement, pour cette dernière. Elle utilise un + générateur de nombres aléatoire de caractéristique + connue, le " Mersenne Twister ", qui va produire des nombres utilisables en + cryptographie, et qui est 4 fois plus rapide que la fonction standard libc. + La "Homepage of the Mersenne Twister " est + <ulink url="&url.mersenne;">&url.mersenne;</ulink>. Une version optimisée + des sources de MT est disponible à + <ulink url="&url.mersenne.twister;">&url.mersenne.twister;</ulink>. + </simpara> + <simpara> + Appelée sans les arguments optionnels <parameter>min</parameter> et + <parameter>max</parameter>, <function>mt_rand</function> retourne un nombre + pseudo-aléatoire, entre 0 et <constant>RAND_MAX</constant>. + Pour obtenir un nombre entre 5 et 15 inclus, il faut utiliser + <literal>mt_rand(5,15)</literal>. + </simpara> + <simpara> + N'oubliez pas d'initialiser le générateur de nombres + aléatoires avec <function>mt_srand</function>. + </simpara> + <note> <para> - <function>mt_srand</function> initialise une meilleure valeur - aléatoire avec <parameter>seed</parameter>. - <informalexample> - <programlisting role="php"> + Dans les versions antérieures à la 3.0.7, la signification + du paramètre <parameter>max</parameter> était "longueur". + Pour avoir le même résultat, il faut utiliser + <literal>mt_rand (5, 11)</literal> pour obtenir un nombre + aléatoire entre 5 et 15. + </para> + </note> + <simpara> + Voir aussi + <function>mt_srand</function>, + <function>mt_getrandmax</function>, + <function>srand</function>, + <function>rand</function> et + <function>getrandmax</function>. + </simpara> + </refsect1> + </refentry> + <refentry id="function.mt-srand"> + <refnamediv> + <refname>mt_srand</refname> + <refpurpose>Initialise une meilleure valeur aléatoire</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>void <function>mt_srand</function></funcdef> + <paramdef>int <parameter>seed</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>mt_srand</function> initialise une meilleure valeur + aléatoire avec <parameter>seed</parameter>. + <informalexample> + <programlisting role="php"> <?php // initialise avec les microsecondes depuis la dernière seconde entière -mt_srand((double)microtime()*1000000); -$randval = mt_rand(); + mt_srand((double)microtime()*1000000); + $randval = mt_rand(); ?> - </programlisting> - </informalexample> - </para> - <simpara> - Voir aussi <function>mt_rand</function>, <function>mt_getrandmax</function>, - <function>srand</function>, <function>rand</function> et - <function>getrandmax</function>. - </simpara> - </refsect1> - </refentry> - <refentry id="function.mt-getrandmax"> - <refnamediv> - <refname>mt_getrandmax</refname> - <refpurpose>La plus grand valeur aléatoire possible.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>mt_getrandmax</function></funcdef> - <paramdef>void </paramdef> - </funcprototype> - </funcsynopsis> - <simpara> - <function>mt_getrandmax</function> retourne la plus grand valeur - aléatoire possible que peut retourner <function>mt_rand</function>. - </simpara> - <simpara> - Voir aussi <function>mt_rand</function>, <function>mt_srand</function> - <function>rand</function>, <function>srand</function> et - <function>getrandmax</function>. - </simpara> - </refsect1> - </refentry> - <refentry id="function.number-format"> - <refnamediv> - <refname>number_format</refname> - <refpurpose>Formate un nombre par groupe de millier.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>number_format</function></funcdef> - <paramdef>float <parameter>number</parameter></paramdef> - <paramdef>int <parameter>decimals</parameter></paramdef> - <paramdef>string <parameter>dec_point</parameter></paramdef> - <paramdef>string <parameter>thousands_sep</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>number_format</function> retourne une chaîne - représentant <parameter>number</parameter> formaté. - <function>number_format</function> accepte un, deux ou 4 paramètres - (mais pas trois). - </para> - <para> - Si un seul paramètre est donné, - <parameter>number</parameter> sera formaté sans - décimale, mais avec une virgule entre chaque série de 1000. - </para> - <para> - Avec deux paramètres, <parameter>number</parameter> sera - formaté avec <parameter>decimals</parameter> décimales - et un point ("."), une virgule entre chaque série de 1000. - </para> - <para> - Avec quatre paramètres, <parameter>number</parameter> sera - formaté avec <parameter>decimals</parameter> décimales - et <parameter>dec_point</parameter> à la place du point, une - virgule entre chaque série de 1000. - </para> - </refsect1> - </refentry> - <refentry id="function.octdec"> - <refnamediv> - <refname>OctDec</refname> - <refpurpose>Convertit d'octal en décimal.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>octdec</function></funcdef> - <paramdef>string <parameter>octal_string</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>octdec</function> retourne une chaîne contenant la - représentation décimale du nombre - <parameter>octal_tring</parameter>. Le nombre le plus grand qui - puisse être converti est 17777777777 en décimal, - ce qui donnera "2147483647". - </para> - <para> - Voir aussi <function>decoct</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.pi"> - <refnamediv> - <refname>pi</refname> - <refpurpose>Retourne la valeur de pi </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>double <function>pi</function></funcdef> - <paramdef>void </paramdef> - </funcprototype> - </funcsynopsis> - <simpara> - <function>pi</function> retourne la valeur de pi. - </simpara> - </refsect1> - </refentry> - <refentry id="function.pow"> - <refnamediv> - <refname>pow</refname> - <refpurpose>Puissance</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>float <function>pow</function></funcdef> - <paramdef>float <parameter>base</parameter></paramdef> - <paramdef>float <parameter>exp</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>pow</function> retourne <parameter>base</parameter> - élevé à la puissance <parameter>exp</parameter>. - </para> - <para> - Voir aussi <function>exp</function>. - </para> - </refsect1> - </refentry> -<refentry id="function.rad2deg"> - <refnamediv> - <refname>rad2deg</refname> - <refpurpose> - Convertit un nombre en radian en degrés - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>double <function>rad2deg</function></funcdef> - <paramdef>double <parameter>number</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>rad2deg</function> convertit <parameter>number</parameter> - (supposé en radians) en degrés. - </para> - <para> - Voir aussi <function>deg2rad</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.rand"> - <refnamediv> - <refname>rand</refname> - <refpurpose>Génère une valeur aléatoire.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>rand</function></funcdef> - <paramdef> - <parameter><optional>int min</optional></parameter> - </paramdef> - <paramdef> - <parameter><optional>int max</optional></parameter> - </paramdef> - </funcprototype> - </funcsynopsis> - <simpara> - Appelée sans les options <parameter>min</parameter> et - <parameter>max</parameter>, <function>rand</function> retourne un - nombre pseudo-aléatoire entre 0 et <constant>RAND_MAX</constant>. - Si vous voulez un nombre aléatoire entre 5 et 15 - (inclus), par exemple, utilisez <literal>rand (5, 15)</literal>. - </simpara> - <simpara> - N'oubliez pas d'initialiser le générateur de nombres - aléatoires avec <function>srand</function>. - </simpara> + </programlisting> + </informalexample> + </para> + <simpara> + Voir aussi + <function>mt_rand</function>, + <function>mt_getrandmax</function>, + <function>srand</function>, + <function>rand</function> et + <function>getrandmax</function>. + </simpara> + </refsect1> + </refentry> + <refentry id="function.mt-getrandmax"> + <refnamediv> + <refname>mt_getrandmax</refname> + <refpurpose>La plus grand valeur aléatoire possible.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>mt_getrandmax</function></funcdef> + <paramdef>void </paramdef> + </funcprototype> + </funcsynopsis> + <simpara> + <function>mt_getrandmax</function> retourne la plus grand valeur + aléatoire possible que peut retourner <function>mt_rand</function>. + </simpara> + <simpara> + Voir aussi + <function>mt_rand</function>, + <function>mt_srand</function> + <function>rand</function>, + <function>srand</function> et + <function>getrandmax</function>. + </simpara> + </refsect1> + </refentry> + <refentry id="function.number-format"> + <refnamediv> + <refname>number_format</refname> + <refpurpose>Formate un nombre pour l'affichage.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>number_format</function></funcdef> + <paramdef>float <parameter>number</parameter></paramdef> + <paramdef>int <parameter><optional>decimals</optional></parameter></paramdef> + <paramdef>string <parameter><optional>dec_point</optional></parameter></paramdef> + <paramdef>string <parameter><optional>thousands_sep</optional></parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>number_format</function> retourne une chaîne + représentant <parameter>number</parameter> formaté. + <function>number_format</function> accepte un, deux ou 4 paramètres + (mais pas trois). + </para> + <para> + Si le seul paramètre <parameter>number</parameter> est donné, + il sera formaté sans partie décimale, mais avec une + virgule entre chaque millier. + </para> + <para> + Si les deux paramètres <parameter>number</parameter> et + <parameter>decimals</parameter> sont fournis, <parameter>number</parameter> sera + formaté avec <parameter>decimals</parameter> décimales, + un point (".") comme séparateur décimal et une virgule entre chaque + millier. + </para> + <para> + Avec quatre paramètres, <parameter>number</parameter> sera + formaté avec <parameter>decimals</parameter> décimales, + <parameter>dec_point</parameter> comme séparateur décimal, et + <parameter>thousands_sep</parameter> comme séparateur de milliers. + </para> <note> <para> - Dans les versions antérieure à la 3.0.7 la signification - du paramètre <parameter>max</parameter> était longueur. - Pour avoir le même résultat, il faut utiliser - <literal>mt_rand (5, 11)</literal> pour obtenir un nombre aléatoire - entre 5 et 15. + Seul le premier caractère du paramètre <parameter>thousands_sep</parameter> + est utilisé. Par exemple, si vous utilisez <literal>foo</literal> comme + séparateur de milliers, sur le nombre <literal>1000</literal>, + <function>number_format</function> retournera <literal>1f000</literal>. </para> </note> - <simpara> - Voir aussi <function>srand</function>, <function>getrandmax</function>, - <function>mt_rand</function>, <function>mt_srand</function> et - <function>mt_getrandmax</function>. - </simpara> - </refsect1> - </refentry> - <refentry id="function.round"> - <refnamediv> - <refname>round</refname> - <refpurpose>Arrondi.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>double <function>round</function></funcdef> - <paramdef>double <parameter>val</parameter></paramdef> - <paramdef>int - <parameter><optional>precision</optional></parameter> - </paramdef> - </funcprototype> - </funcsynopsis> + <para> + En notation française, on utilise généralement deux chiffres + après la virgule, une virgule comme séparateur décimal, et un + espace comme séparateur de milliers. Cela donne : + <informalexample> + <programlisting role="php"> +<?php + $nombre = 1234.56; +// Notation anglaise (par défaut) + $english_format_number = number_format($nombre); +// 1,234.56 +// Notation française + $nombre_format_francais = number_format($nombre, 2, ',', ' '); +// 1 234,56 +?> + </programlisting> + </informalexample> + </para> + <para> + Voir aussi + <function>sprintf</function>, + <function>printf</function> et + <function>sscanf</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.octdec"> + <refnamediv> + <refname>OctDec</refname> + <refpurpose>Convertit d'octal en décimal.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>octdec</function></funcdef> + <paramdef>string <parameter>octal_string</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>octdec</function> retourne une chaîne contenant la + représentation décimale du nombre + <parameter>octal_tring</parameter>. Le nombre le plus grand qui + puisse être converti est 17777777777 en décimal, + ce qui donnera "2147483647". + </para> + <para> + Voir aussi + <function>decoct</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.pi"> + <refnamediv> + <refname>pi</refname> + <refpurpose>Retourne la valeur de pi </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>double <function>pi</function></funcdef> + <paramdef>void </paramdef> + </funcprototype> + </funcsynopsis> + <simpara> + <function>pi</function> retourne la valeur de pi. + </simpara> + <para> + <informalexample> + <programlisting role="php"> +<?php + echo pi(); +// 3.1415926535898 +?> + </programlisting> + </informalexample> + </para> + </refsect1> + </refentry> + <refentry id="function.pow"> + <refnamediv> + <refname>pow</refname> + <refpurpose>Puissance</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>float <function>pow</function></funcdef> + <paramdef>float <parameter>base</parameter></paramdef> + <paramdef>float <parameter>exp</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>pow</function> retourne <parameter>base</parameter> + élevé à la puissance <parameter>exp</parameter>. + Si le calcul est impossible (racine d'un nombre négatif, par + exemple), <function>exp</function> retourne <literal>NAN</literal>. + </para> + <para> + Voir aussi + <function>exp</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.rad2deg"> + <refnamediv> + <refname>rad2deg</refname> + <refpurpose> + Convertit de radians en degrés + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>double <function>rad2deg</function></funcdef> + <paramdef>double <parameter>number</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>rad2deg</function> convertit <parameter>number</parameter> + (supposé en radians) en degrés. + </para> + <para> + Voir aussi + <function>deg2rad</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.rand"> + <refnamediv> + <refname>rand</refname> + <refpurpose>Génère une valeur aléatoire.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>rand</function></funcdef> + <paramdef>int + <parameter><optional>min</optional></parameter> + </paramdef> + <paramdef>int + <parameter><optional>max</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <simpara> + Appelée sans les options <parameter>min</parameter> et + <parameter>max</parameter>, <function>rand</function> retourne un + nombre pseudo-aléatoire entre 0 et <constant>RAND_MAX</constant>. + Si vous voulez un nombre aléatoire entre 5 et 15 + (inclus), par exemple, utilisez <literal>rand (5, 15)</literal>. + </simpara> + <simpara> + N'oubliez pas d'initialiser le générateur de nombres + aléatoires avec <function>srand</function>. + </simpara> + <note> <para> - <function>round</function> retourne la valeur arrondie de <parameter>val</parameter> - à la précision <parameter>precision</parameter> - (nombre de chiffres après la virgule). - <informalexample> - <programlisting role="php"> + Dans les versions antérieures à la 3.0.7 la signification + du paramètre <parameter>max</parameter> était longueur. + Pour avoir le même résultat, il faut utiliser + <literal>mt_rand (5, 11)</literal> pour obtenir un nombre aléatoire + entre 5 et 15. + </para> + </note> + <simpara> + Voir aussi + <function>srand</function>, + <function>getrandmax</function>, + <function>mt_rand</function>, + <function>mt_srand</function> et + <function>mt_getrandmax</function>. + </simpara> + </refsect1> + </refentry> + <refentry id="function.round"> + <refnamediv> + <refname>round</refname> + <refpurpose>Arrondi.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>double <function>round</function></funcdef> + <paramdef>double <parameter>val</parameter></paramdef> + <paramdef>int + <parameter><optional>precision</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>round</function> retourne la valeur arrondie de <parameter>val</parameter> + à la précision <parameter>precision</parameter> + (nombre de chiffres après la virgule). + <informalexample> + <programlisting role="php"> <?php -$foo = round( 3.4 ); // $foo == 3.0 -$foo = round( 3.5 ); // $foo == 4.0 -$foo = round( 3.6 ); // $foo == 4.0 + $foo = round( 3.4 ); // $foo == 3.0 + $foo = round( 3.5 ); // $foo == 4.0 + $foo = round( 3.6 ); // $foo == 4.0 ?> - </programlisting> - </informalexample> - </para> - <note> - <simpara> - Le paramètre <parameter>precision</parameter> est disponible - uniquement en PHP 4. - </simpara> - </note> + </programlisting> + </informalexample> + </para> + <note> <simpara> - Voir aussi <function>ceil</function> et <function>floor</function>. + Le paramètre <parameter>precision</parameter> est disponible + uniquement en PHP 4. </simpara> - </refsect1> - </refentry> - <refentry id="function.sin"> - <refnamediv> - <refname>sin</refname> - <refpurpose>Sinus</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>float <function>sin</function></funcdef> - <paramdef>float <parameter>arg</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>sin</function> retourne le sinus de <parameter>arg</parameter> - (<parameter>arg</parameter> in radians). - </para> - <para> - Voir aussi <function>cos</function> et <function>tan</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.sqrt"> - <refnamediv> - <refname>sqrt</refname> - <refpurpose>Racine carrée.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>float <function>sqrt</function></funcdef> - <paramdef>float <parameter>arg</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>sqrt</function> retourne la racine carrée de - <parameter>arg</parameter>. + </note> + <simpara> + Voir aussi + <function>ceil</function> et + <function>floor</function>. + </simpara> + </refsect1> + </refentry> + <refentry id="function.sin"> + <refnamediv> + <refname>Sin</refname> + <refpurpose>Sinus</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>float <function>sin</function></funcdef> + <paramdef>float <parameter>arg</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>sin</function> retourne le sinus de <parameter>arg</parameter> + (<parameter>arg</parameter> in radians). </para> - </refsect1> - </refentry> - <refentry id="function.srand"> - <refnamediv> - <refname>srand</refname> - <refpurpose>Initialise le générateur de nombres aléatoires</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>void <function>srand</function></funcdef> - <paramdef>int <parameter>seed</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>srand</function> initialise le générateur de - nombres aléatoires avec <parameter>seed</parameter>. - <informalexample> - <programlisting role="php"> + <para> + Voir aussi + <function>cos</function> et + <function>tan</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.sqrt"> + <refnamediv> + <refname>Sqrt</refname> + <refpurpose>Racine carrée.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>float <function>sqrt</function></funcdef> + <paramdef>float <parameter>arg</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>sqrt</function> retourne la racine carrée de + <parameter>arg</parameter>. + </para> + </refsect1> + </refentry> + <refentry id="function.srand"> + <refnamediv> + <refname>srand</refname> + <refpurpose>Initialise le générateur de nombres aléatoires</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>void <function>srand</function></funcdef> + <paramdef>int <parameter>seed</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>srand</function> initialise le générateur de + nombres aléatoires avec <parameter>seed</parameter>. + <informalexample> + <programlisting role="php"> <?php // initialise avec les microsecondes depuis la dernière seconde entière -srand((double)microtime()*1000000); -$randval = rand(); + srand((double)microtime()*1000000); + $randval = rand(); ?> - </programlisting> - </informalexample> - </para> - <simpara> - Voir aussi <function>rand</function>, - <function>getrandmax</function>, - <function>mt_rand</function>, - <function>mt_srand</function> et <function>mt_getrandmax</function>. - </simpara> - </refsect1> - </refentry> - <refentry id="function.tan"> - <refnamediv> - <refname>tan</refname> - <refpurpose>Tangente</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>float <function>tan</function></funcdef> - <paramdef>float <parameter>arg</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>tan</function> retourne la tangente de - <parameter>arg</parameter> (<parameter>arg</parameter> en radians). - </para> - <para> - Voir aussi <function>sin</function> et <function>cos</function>. - </para> - </refsect1> - </refentry> - </reference> + </programlisting> + </informalexample> + </para> + <simpara> + Voir aussi + <function>rand</function>, + <function>getrandmax</function>, + <function>mt_rand</function>, + <function>mt_srand</function> et + <function>mt_getrandmax</function>. + </simpara> + </refsect1> + </refentry> + <refentry id="function.tan"> + <refnamediv> + <refname>Tan</refname> + <refpurpose>Tangente</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>float <function>tan</function></funcdef> + <paramdef>float <parameter>arg</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>tan</function> retourne la tangente de + <parameter>arg</parameter> (<parameter>arg</parameter> en radians). + </para> + <para> + Voir aussi + <function>sin</function> et + <function>cos</function>. + </para> + </refsect1> + </refentry> +</reference> <!-- Keep this comment at the end of the file Local variables: mode: sgml
Index: phpdoc/fr/functions/math.xml diff -u phpdoc/fr/functions/math.xml:1.10 phpdoc/fr/functions/math.xml:1.11 --- phpdoc/fr/functions/math.xml:1.10 Sat Jun 23 16:35:10 2001 +++ phpdoc/fr/functions/math.xml Tue Jul 24 09:08:31 2001 @@ -1,1117 +1,1243 @@ - <reference id="ref.math"> - <title>Mathématiques</title> - <titleabbrev>Maths</titleabbrev> - <partintro> - <sect1 id="math.intro"> - <title>Introduction</title> - <para> - Ces fonctions ne sont capables de manipuler que des entiers double, ou - des long. Si vous avez besoin de manipuler des nombres plus grands, - reportez vous aux fonctions mathématiques sur des - <link linkend="ref.bc">nombres de grande taille</link>. - </para> - <sect2 id="math.constants"> - <title>Constantes mathématiques</title> - <para> - Les valeurs suivantes sont définies comme des constantes dans PHP: - <table> - <title>Constantes mathématiques</title> - <tgroup cols="3"> - <thead> - <row> - <entry>Constante</entry> - <entry>Valeur</entry> - <entry>Description</entry> - </row> - </thead> - <tbody> - <row> - <entry>M_PI</entry> - <entry>3.14159265358979323846</entry> - <entry>Pi</entry> - </row> - <row> - <entry>M_E</entry> - <entry>2.7182818284590452354</entry> - <entry>e</entry> - </row> - <row> - <entry>M_LOG2E</entry> - <entry>1.4426950408889634074</entry> - <entry>log_2 e</entry> - </row> - <row> - <entry>M_LOG10E</entry> - <entry>0.43429448190325182765</entry> - <entry>log_10 e</entry> - </row> - <row> - <entry>M_LN2</entry> - <entry>0.69314718055994530942</entry> - <entry>log_e 2</entry> - </row> - <row> - <entry>M_LN10</entry> - <entry>2.30258509299404568402</entry> - <entry>log_e 10</entry> - </row> - <row> - <entry>M_PI_2</entry> - <entry>1.57079632679489661923</entry> - <entry>pi/2</entry> - </row> - <row> - <entry>M_PI_4</entry> - <entry>0.78539816339744830962</entry> - <entry>pi/4</entry> - </row> - <row> - <entry>M_1_PI</entry> - <entry>0.31830988618379067154</entry> - <entry>1/pi</entry> - </row> - <row> - <entry>M_2_PI</entry> - <entry>0.63661977236758134308</entry> - <entry>2/pi</entry> - </row> - <row> - <entry>M_SQRTPI</entry> - <entry>1.77245385090551602729</entry> - <entry>sqrt(pi) [4.0.2]</entry> - </row> - <row> - <entry>M_2_SQRTPI</entry> - <entry>1.12837916709551257390</entry> - <entry>2/sqrt(pi)</entry> - </row> - <row> - <entry>M_SQRT2</entry> - <entry>1.41421356237309504880</entry> - <entry>sqrt(2)</entry> - </row> - <row> - <entry>M_SQRT3</entry> - <entry>1.73205080756887729352</entry> - <entry>sqrt(3) [4.0.2]</entry> - </row> - <row> - <entry>M_SQRT1_2</entry> - <entry>0.70710678118654752440</entry> - <entry>1/sqrt(2)</entry> - </row> - <row> - <entry>M_LNPI</entry> - <entry>1.14472988584940017414</entry> - <entry>log_e(pi) [4.0.2]</entry> - </row> - <row> - <entry>M_EULER</entry> - <entry>0.57721566490153286061</entry> - <entry>Euler constant [4.0.2]</entry> - </row> - </tbody> - </tgroup> - </table> - </para> - </sect2> - </sect1> - </partintro> - <refentry id="function.abs"> - <refnamediv> - <refname>abs</refname> - <refpurpose>Valeur absolue</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>mixed <function>abs</function></funcdef> - <paramdef>mixed <parameter>number</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>abs</function> retourne la valeur absolue du nombre - <parameter>number</parameter>. Si le nombre est de type float, - le type retourné est float, sinon, c'est integer (entier). - </para> - </refsect1> - </refentry> - <refentry id="function.acos"> - <refnamediv> - <refname>acos</refname> - <refpurpose>arc cosinus</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>float <function>acos</function></funcdef> - <paramdef>float <parameter>arg</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>acos</function> retourne l'arc cosinus de - <parameter>arg</parameter> (<parameter>arg</parameter> en radians). - </para> - <para> - Voir aussi <function>asin</function> et <function>atan</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.asin"> - <refnamediv> - <refname>asin</refname> - <refpurpose>arc sinus</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>float <function>asin</function></funcdef> - <paramdef>float <parameter>arg</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>asin</function> retourne l'arc sinus de - <parameter>arg</parameter> (<parameter>arg</parameter> en radians). - </para> - <para> - Voir aussi <function>acos</function> et <function>atan</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.atan"> - <refnamediv> - <refname>atan</refname> - <refpurpose>arc tangent</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> +<reference id="ref.math"> + <title>Mathématiques</title> + <titleabbrev>Maths</titleabbrev> + <partintro> + <sect1 id="math.intro"> + <title>Introduction</title> + <para> + Ces fonctions ne sont capables de manipuler que des entiers "double", ou + des "long". Si vous avez besoin de manipuler des nombres plus grands, + reportez-vous aux fonctions mathématiques sur des + <link linkend="ref.bc">nombres de grande taille</link>. + </para> + <sect2 id="math.constants"> + <title>Constantes mathématiques</title> + <para> + Les valeurs suivantes sont définies comme des constantes en PHP : + <table> + <title>Constantes mathématiques</title> + <tgroup cols="3"> + <thead> + <row> + <entry>Constante</entry> + <entry>Valeur</entry> + <entry>Description</entry> + </row> + </thead> + <tbody> + <row> + <entry>M_PI</entry> + <entry>3.14159265358979323846</entry> + <entry>Pi</entry> + </row> + <row> + <entry>M_E</entry> + <entry>2.7182818284590452354</entry> + <entry>e</entry> + </row> + <row> + <entry>M_LOG2E</entry> + <entry>1.4426950408889634074</entry> + <entry>log_2 e</entry> + </row> + <row> + <entry>M_LOG10E</entry> + <entry>0.43429448190325182765</entry> + <entry>log_10 e</entry> + </row> + <row> + <entry>M_LN2</entry> + <entry>0.69314718055994530942</entry> + <entry>log_e 2</entry> + </row> + <row> + <entry>M_LN10</entry> + <entry>2.30258509299404568402</entry> + <entry>log_e 10</entry> + </row> + <row> + <entry>M_PI_2</entry> + <entry>1.57079632679489661923</entry> + <entry>pi/2</entry> + </row> + <row> + <entry>M_PI_4</entry> + <entry>0.78539816339744830962</entry> + <entry>pi/4</entry> + </row> + <row> + <entry>M_1_PI</entry> + <entry>0.31830988618379067154</entry> + <entry>1/pi</entry> + </row> + <row> + <entry>M_2_PI</entry> + <entry>0.63661977236758134308</entry> + <entry>2/pi</entry> + </row> + <row> + <entry>M_SQRTPI</entry> + <entry>1.77245385090551602729</entry> + <entry>sqrt(pi) [4.0.2]</entry> + </row> + <row> + <entry>M_2_SQRTPI</entry> + <entry>1.12837916709551257390</entry> + <entry>2/sqrt(pi)</entry> + </row> + <row> + <entry>M_SQRT2</entry> + <entry>1.41421356237309504880</entry> + <entry>sqrt(2)</entry> + </row> + <row> + <entry>M_SQRT3</entry> + <entry>1.73205080756887729352</entry> + <entry>sqrt(3) [4.0.2]</entry> + </row> + <row> + <entry>M_SQRT1_2</entry> + <entry>0.70710678118654752440</entry> + <entry>1/sqrt(2)</entry> + </row> + <row> + <entry>M_LNPI</entry> + <entry>1.14472988584940017414</entry> + <entry>log_e(pi) [4.0.2]</entry> + </row> + <row> + <entry>M_EULER</entry> + <entry>0.57721566490153286061</entry> + <entry>Euler constant [4.0.2]</entry> + </row> + </tbody> + </tgroup> + </table> + </para> + </sect2> + </sect1> + </partintro> + <refentry id="function.abs"> + <refnamediv> + <refname>Abs</refname> + <refpurpose>Valeur absolue</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>mixed <function>abs</function></funcdef> + <paramdef>mixed <parameter>number</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>abs</function> retourne la valeur absolue du nombre + <parameter>number</parameter>. Si le nombre est un nombre à + virgule flottante (<type>float</type>), le type retourné + est aussi un nombre à virgule flottante (<type>float</type>), + sinon, c'est un entier (<type>integer</type>). + </para> + </refsect1> + </refentry> + <refentry id="function.acos"> + <refnamediv> + <refname>Acos</refname> + <refpurpose>arc cosinus</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>float <function>acos</function></funcdef> + <paramdef>float <parameter>arg</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>acos</function> retourne l'arc cosinus de + <parameter>arg</parameter> (<parameter>arg</parameter> en radians). + </para> + <para> + Voir aussi + <function>asin</function> et + <function>atan</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.asin"> + <refnamediv> + <refname>Asin</refname> + <refpurpose>arc sinus</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>float <function>asin</function></funcdef> + <paramdef>float <parameter>arg</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>asin</function> retourne l'arc sinus de + <parameter>arg</parameter> (<parameter>arg</parameter> en radians). + </para> + <para> + Voir aussi + <function>acos</function> et + <function>atan</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.atan"> + <refnamediv> + <refname>Atan</refname> + <refpurpose>arc tangent</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>float <function>atan</function></funcdef> <paramdef>float <parameter>arg</parameter></paramdef> - </funcsynopsis> - <para> - <function>atan</function> retourne l'arc tangent de - <parameter>arg</parameter> (<parameter>arg</parameter> en radians). - </para> - <para> - Voir aussi <function>acos</function> et <function>atan</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.atan2"> - <refnamediv> - <refname>atan2</refname> - <refpurpose>arc tangent de deux variables</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>float <function>atan2</function></funcdef> - <paramdef>float <parameter>y</parameter></paramdef> - <paramdef>float <parameter>x</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <simpara> - <function>atan2</function> retourne l' arc tangent de deux variables - x et y. La formule est : " arc tangent (y / x) ", et les signes des - arguments sont utilisés pour déterminer le quadrant du - résultat. - </simpara> - <simpara> - <function>atan2</function> retourne un résultat en radians, - entre -PI et PI (inclus). - </simpara> - <para> - Voir aussi <function>acos</function> et <function>atan</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.base-convert"> - <refnamediv> - <refname>base_convert</refname> - <refpurpose>Convertit un nombre en des bases arbitraires.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>base_convert</function></funcdef> - <paramdef>string <parameter>number</parameter></paramdef> - <paramdef>int <parameter>frombase</parameter></paramdef> - <paramdef>int <parameter>tobase</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>base_convert</function> retourne une chaîne contenant - l'argument <parameter>number</parameter> représenté - dans la base <parameter>tobase</parameter>. La base de - représentation de <parameter>number</parameter> est - donnée par <parameter>frombase</parameter>. - <parameter>frombase</parameter> et <parameter>tobase</parameter> - doivent être compris entre 2 et 36, inclus. Les chiffres - supérieurs à 10 des bases supérieures - à 10 seront représentées par les lettres - de a à z, avec a = 10 et z = 36. - <example> - <title><function>base_convert</function></title> - <programlisting role="php"> + </funcprototype> + </funcsynopsis> + <para> + <function>atan</function> retourne l'arc tangent de + <parameter>arg</parameter> (<parameter>arg</parameter> en radians). + </para> + <para> + Voir aussi + <function>acos</function> et + <function>atan</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.atan2"> + <refnamediv> + <refname>Atan2</refname> + <refpurpose>arc tangent de deux variables</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>float <function>atan2</function></funcdef> + <paramdef>float <parameter>y</parameter></paramdef> + <paramdef>float <parameter>x</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <simpara> + <function>atan2</function> retourne l'arc tangent de deux variables + <parameter>x</parameter> et <parameter>y</parameter>. La formule est : + " arc tangent (y / x) ", et les signes des + arguments sont utilisés pour déterminer le quadrant du + résultat. + </simpara> + <simpara> + <function>atan2</function> retourne un résultat en radians, + entre -PI et PI (inclus). + </simpara> + <para> + Voir aussi + <function>acos</function> et + <function>atan</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.base-convert"> + <refnamediv> + <refname>base_convert</refname> + <refpurpose>Convertit un nombre entre des bases arbitraires.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>base_convert</function></funcdef> + <paramdef>string <parameter>number</parameter></paramdef> + <paramdef>int <parameter>frombase</parameter></paramdef> + <paramdef>int <parameter>tobase</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>base_convert</function> retourne une chaîne contenant + l'argument <parameter>number</parameter> représenté + dans la base <parameter>tobase</parameter>. La base de + représentation de <parameter>number</parameter> est + donnée par <parameter>frombase</parameter>. + <parameter>frombase</parameter> et <parameter>tobase</parameter> + doivent être compris entre 2 et 36 inclus. Les chiffres + supérieurs à 10 des bases supérieures + à 10 seront représentés par les lettres + de A à Z, avec A = 10 et Z = 36. + <example> + <title><function>base_convert</function></title> + <programlisting role="php"> <?php -$binary = base_convert($hexadecimal, 16, 2); + $binary = base_convert($hexadecimal, 16, 2); ?> - </programlisting> - </example> - </para> - </refsect1> - </refentry> - <refentry id="function.bindec"> - <refnamediv> - <refname>BinDec</refname> - <refpurpose>Convertit de binaire en décimal</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>bindec</function></funcdef> - <paramdef>string <parameter>binary_string</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>bindec</function> retourne la conversion d'un nombre - binaire représenté par la chaîne - <parameter>binary_string</parameter> en décimal. - </para> - <para> - <function>bindec</function> convertit un nombre binaire en décimal. - Le plus grand nombre convertible a 31 bits à 1, soit - 2147483647 en décimal. - </para> - <para> - Voir aussi <function>decbin</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.ceil"> - <refnamediv> - <refname>ceil</refname> - <refpurpose>arrondi au nombre supérieur</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>ceil</function></funcdef> - <paramdef>float <parameter>number</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>ceil</function> retourne l'entier supérieur du - nombre <parameter>number</parameter>. Utiliser - <function>ceil</function> sur un entier ne sert à rien. - <informalexample> - <programlisting role="php"> + </programlisting> + </example> + </para> + </refsect1> + </refentry> + <refentry id="function.bindec"> + <refnamediv> + <refname>BinDec</refname> + <refpurpose>Convertit de binaire en décimal</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>bindec</function></funcdef> + <paramdef>string <parameter>binary_string</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>bindec</function> retourne la conversion d'un nombre + binaire représenté par la chaîne + <parameter>binary_string</parameter> en décimal. + </para> + <para> + <function>bindec</function> convertit un nombre binaire en décimal. + Le plus grand nombre convertible a 31 bits à 1, soit + 2147483647 en décimal. + </para> + <para> + Voir aussi + <function>decbin</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.ceil"> + <refnamediv> + <refname>Ceil</refname> + <refpurpose>Arrondit au nombre supérieur</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>float <function>ceil</function></funcdef> + <paramdef>float <parameter>number</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ceil</function> retourne l'entier supérieur du + nombre <parameter>number</parameter>. Utiliser + <function>ceil</function> sur un entier ne sert à rien. + La valeur retournée est un nombre à virgule flottante + (<type>float</type>), car ces nombres peuvent être plus + grands que les entiers. + <informalexample> + <programlisting role="php"> <?php -$x = ceil(4.25); + $x = ceil(4.25); // ce qui donne $x=5 ?> - </programlisting> - </informalexample> - </para> - <simpara> - NOTE: <function>ceil</function> sous PHP/FI 2 retournait un nombre à - virgule flottante. Utilisez: <literal>$new = (double)ceil($number);</literal> - pour retrouver le comportement traditionnel. + </programlisting> + </informalexample> + </para> + <simpara> + NOTE: <function>ceil</function> sous PHP/FI 2 retournait un nombre à + virgule flottante. Utilisez: <literal>$new = (double)ceil($number);</literal> + pour retrouver le comportement traditionnel. </simpara> - <simpara> - Voir aussi <function>floor</function> et <function>round</function>. - </simpara> - </refsect1> - </refentry> - <refentry id="function.cos"> - <refnamediv> - <refname>cos</refname> - <refpurpose>cosinus</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>float <function>cos</function></funcdef> - <paramdef>float <parameter>arg</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>cos</function> retourne le cosinus de arg (<parameter>arg</parameter> en radians). - </para> - <para> - Voir aussi <function>sin</function> et <function>tan</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.decbin"> - <refnamediv> - <refname>DecBin</refname> - <refpurpose>Convertit de décimal en binaire</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>decbin</function></funcdef> - <paramdef>int <parameter>number</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>decbin</function> retourne une chaîne contenant - la représentation binaire de l'entier donné en argument. - Le plus grand nombre pouvant être converti est 2147483647 - en décimal, ce qui donne une série de 31 uns (1). - </para> - <para> - Voir aussi <function>bindec</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.dechex"> - <refnamediv> - <refname>DecHex</refname> - <refpurpose>Convertit de décimal en hexadécimal </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>dechex</function></funcdef> - <paramdef>int <parameter>number</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>dechex</function> retourne une chaîne contenant - la représentation hexadécimale du nombre - <parameter>number</parameter>. Le nombre le plus grand qui puisse être - convertit est 2147483647 en décimal, ce qui donnera "7fffffff". - </para> - <para> - Voir aussi <function>hexdec</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.decoct"> - <refnamediv> - <refname>DecOct</refname> - <refpurpose>Convertit de décimal en octal </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>decoct</function></funcdef> - <paramdef>int <parameter>number</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>decoct</function> retourne une chaîne contenant - la représentation octale du nombre donné - <parameter>number</parameter>. Le nombre le plus grand qui puisse - être converti est 2147483647 en décimal, ce qui - donnera "17777777777". - </para> - <para> - Voir aussi <function>octdec</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.deg2rad"> - <refnamediv> - <refname>deg2rad</refname> - <refpurpose> - Convertit un nombre en degré en radians - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>double <function>deg2rad</function></funcdef> - <paramdef>double <parameter>number</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>deg2rad</function> convertit <parameter>number</parameter> de - degrés en radians. - </para> - <para> - Voir aussi <function>rad2deg</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.exp"> - <refnamediv> - <refname>exp</refname> - <refpurpose>exponentielle</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> + <simpara> + Voir aussi + <function>floor</function> et + <function>round</function>. + </simpara> + </refsect1> + </refentry> + <refentry id="function.cos"> + <refnamediv> + <refname>Cos</refname> + <refpurpose>cosinus</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>float <function>cos</function></funcdef> + <paramdef>float <parameter>arg</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>cos</function> retourne le cosinus de <parameter>arg</parameter> + (<parameter>arg</parameter> en radians). + </para> + <para> + Voir aussi + <function>sin</function> et + <function>tan</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.decbin"> + <refnamediv> + <refname>DecBin</refname> + <refpurpose>Convertit de décimal en binaire</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>decbin</function></funcdef> + <paramdef>int <parameter>number</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>decbin</function> retourne une chaîne contenant + la représentation binaire de l'entier donné en argument. + Le plus grand nombre pouvant être converti est 2147483647 + en décimal, ce qui donne une série de 31 uns (1). + </para> + <para> + Voir aussi + <function>bindec</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.dechex"> + <refnamediv> + <refname>DecHex</refname> + <refpurpose>Convertit de décimal en hexadécimal </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>dechex</function></funcdef> + <paramdef>int <parameter>number</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>dechex</function> retourne une chaîne contenant + la représentation hexadécimale du nombre + <parameter>number</parameter>. Le nombre le plus grand qui puisse être + converti est 2147483647 en décimal, ce qui donnera "7fffffff". + </para> + <para> + Voir aussi + <function>hexdec</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.decoct"> + <refnamediv> + <refname>DecOct</refname> + <refpurpose>Convertit de décimal en octal </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>decoct</function></funcdef> + <paramdef>int <parameter>number</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>decoct</function> retourne une chaîne contenant + la représentation octale du nombre donné + <parameter>number</parameter>. Le nombre le plus grand qui puisse + être converti est 2147483647 en décimal, ce qui + donnera "17777777777". + </para> + <para> + Voir aussi + <function>octdec</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.deg2rad"> + <refnamediv> + <refname>deg2rad</refname> + <refpurpose> + Convertit un nombre de degrés en radians + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>double <function>deg2rad</function></funcdef> + <paramdef>double <parameter>number</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>deg2rad</function> convertit <parameter>number</parameter> de + degrés en radians. + </para> + <para> + Voir aussi + <function>rad2deg</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.exp"> + <refnamediv> + <refname>Exp</refname> + <refpurpose>exponentielle</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>float <function>exp</function></funcdef> <paramdef>float <parameter>arg</parameter></paramdef> - </funcsynopsis> - <para> - <function>exp</function> retourne l'exponentielle de - <parameter>arg</parameter>, c'est à dire - e élevé à la puissance - <parameter>arg</parameter>. - </para> - <para> - Voir aussi <function>pow</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.floor"> - <refnamediv> - <refname>floor</refname> - <refpurpose>Arrondi à l'entier inférieur </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>floor</function></funcdef> - <paramdef>float <parameter>number</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <simpara> - <function>floor</function> retourne l'entier inférieur - du nombre <parameter>number</parameter>. Utiliser - <function>floor</function> sur un entier ne sert à rien. - </simpara> - <simpara> - NOTE: <function>floor</function> sous PHP/FI retournait un float. - Utilisez: <literal>$new = (double)floor($number);</literal> - pour retrouver le comportement traditionnel. - </simpara> - <simpara> - Voir aussi <function>ceil</function> et <function>round</function>. - </simpara> - </refsect1> - </refentry> - <refentry id="function.getrandmax"> - <refnamediv> - <refname>getrandmax</refname> - <refpurpose>Plus grande valeur aléatoire possible.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>getrandmax</function></funcdef> - <paramdef>void </paramdef> - </funcprototype> - </funcsynopsis> - <simpara> - <function>getrandmax</function> retourne la plus grande valeur - aléatoire possible retournée par <function>rand</function>. - </simpara> - <simpara> - Voir aussi <function>rand</function>, - <function>srand</function> - <function>mt_rand</function>, - <function>mt_srand</function> et - <function>mt_getrandmax</function>. - </simpara> - </refsect1> - </refentry> - <refentry id="function.hexdec"> - <refnamediv> - <refname>HexDec</refname> - <refpurpose>Convertit de hexadécimal en décimal </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>hexdec</function></funcdef> - <paramdef>string <parameter>hex_string</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>hexdec</function> retourne une chaîne contenant la - représentation décimal du nombre - <parameter>hex_string</parameter>. Le nombre le plus grand - qui puisse être converti est 7fffffff en décimal, - ce qui donne "2147483647 ". - </para> - <para> - Voir aussi the <function>dechex</function>. - </para> - </refsect1> - </refentry> -<refentry id="function.lcg-value"> - <refnamediv> - <refname>lcg_value</refname> - <refpurpose> - Générateur de congruence combinée linéaire - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>double <function>lcg_value</function></funcdef> - <paramdef>void</paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>lcg_value</function> retourne un nombre pseudo-aléatoire, - compris entre 0 et 1. <function>lcg_value</function> combine deux - générateurs de congruence, de période respectives - 2^31 - 85 et 2^31 - 249. La période de cette fonction est le - produit de ces deux nombres premiers (soit ¤2^31 - 85)*(2^31 - 249)). - </para> - </refsect1> - </refentry> - <refentry id="function.log"> - <refnamediv> - <refname>log</refname> - <refpurpose>Logarithme naturel </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>float <function>log</function></funcdef> - <paramdef>float <parameter>arg</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>log</function> retourne le logarithme naturel de <parameter>arg</parameter>. - </para> - </refsect1> - </refentry> - <refentry id="function.log10"> - <refnamediv> - <refname>log10</refname> - <refpurpose>logarithme en base 10.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>float <function>log10</function></funcdef> - <paramdef>float <parameter>arg</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>log10</function> retourne le logarithme en base 10 de - <parameter>arg</parameter>. - </para> - </refsect1> - </refentry> - <refentry id="function.max"> - <refnamediv> - <refname>max</refname> - <refpurpose>La plus grande valeur.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>mixed <function>max</function></funcdef> - <paramdef>mixed <parameter>arg1</parameter></paramdef> - <paramdef>mixed <parameter>arg2</parameter></paramdef> - <paramdef>mixed <parameter>argn</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>max</function> retourne la plus grande valeur - numérique parmi les valeurs passées en paramètre. - </para> - <para> - Si le premier paramètre est un tableau, - <function>max</function> retourne la plus grande valeur de ce tableau. - Si le premier paramètre est un entier, une chaîne ou - un double, <function>max</function> requiert au moins deux paramètres, - et retournera alors le plus grand d'entre eux. - Le nombre d'argument est alors illimité. - </para> - <para> - Si au moins une valeur est de type double, elle seront toutes - traitées comme des doubles, et un double sera retourné. - Si aucune valeur n'est de type double, elles seront traitées - comme des entiers, et un entier sera retourné. - </para> - </refsect1> - </refentry> - <refentry id="function.min"> - <refnamediv> - <refname>min</refname> - <refpurpose>La plus petite valeur.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>mixed <function>min</function></funcdef> - <paramdef>mixed <parameter>arg1</parameter></paramdef> - <paramdef>mixed <parameter>arg2</parameter></paramdef> - <paramdef>mixed <parameter>argn</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>min</function> retourne la plus petite valeur - numérique parmi les valeurs passées en paramètre. - </para> - <para> - Si le premier paramètre est un tableau, <function>min</function> - retourne la plus petite valeur de ce tableau. Si le premier - paramètre est un entier, une chaîne ou un double, - <function>min</function> requiert au moins deux paramètres, et - retournera alors le plus petit d'entre eux. Le nombre d'argument est alors - illimité. - </para> + </funcprototype> + </funcsynopsis> + <para> + <function>exp</function> retourne l'exponentielle de + <parameter>arg</parameter>, c'est-à-dire + e élevé à la puissance + <parameter>arg</parameter>. + </para> + <para> + Voir aussi + <function>pow</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.floor"> + <refnamediv> + <refname>Floor</refname> + <refpurpose>Arrondi à l'entier inférieur </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>floats <function>floor</function></funcdef> + <paramdef>float <parameter>number</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <simpara> + <function>floor</function> retourne l'entier inférieur + du nombre <parameter>number</parameter>. La valeur retournée + est un nombre à virgule flottante, (<type>float</type>) + car ces nombres peuvent être plus grands que les entiers. + </simpara> + <simpara> + NOTE: <function>floor</function> sous PHP/FI retournait un float. + Utilisez: <literal>$new = (double)floor($number);</literal> + pour retrouver le comportement traditionnel. + </simpara> + <simpara> + Voir aussi + <function>ceil</function> et + <function>round</function>. + </simpara> + </refsect1> + </refentry> + <refentry id="function.getrandmax"> + <refnamediv> + <refname>getrandmax</refname> + <refpurpose>Plus grande valeur aléatoire possible.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>getrandmax</function></funcdef> + <paramdef>void </paramdef> + </funcprototype> + </funcsynopsis> + <simpara> + <function>getrandmax</function> retourne la plus grande valeur + aléatoire possible retournée par <function>rand</function>. + </simpara> + <simpara> + Voir aussi + <function>rand</function>, + <function>srand</function> + <function>mt_rand</function>, + <function>mt_srand</function> et + <function>mt_getrandmax</function>. + </simpara> + </refsect1> + </refentry> + <refentry id="function.hexdec"> + <refnamediv> + <refname>hexdec</refname> + <refpurpose>Convertit de hexadécimal en décimal</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>hexdec</function></funcdef> + <paramdef>string <parameter>hex_string</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>hexdec</function> retourne une chaîne contenant la + représentation décimale du nombre + <parameter>hex_string</parameter>. Le nombre le plus grand + qui puisse être converti est 7fffffff en décimal, + ce qui donne "2147483647". + </para> <para> - Si au moins une valeur est de type double, elle seront toutes - traitées comme des doubles, et un double sera retourné. - Si aucune valeur n'est de type double, elles seront traitées - comme des entiers, et un entier sera retourné. + <function>hexdec</function> remplace tous les caractères non-héxadecimal + par des <literal>0</literal>. Et si les zéros de gauche sont ignorés, + ceux de droite prennent le propre valeur. + <example> + <title>Exemple avec <function>hexdec</function></title> + <programlisting role="php"> +<?php + var_dump(hexdec("Hop comme ceci")); + var_dump(hexdec("0000c000e0cec0")); + var_dump(hexdec("c000e0cec0")); +// les deux affichent "int(14732992)" + var_dump(hexdec("aussi")); + var_dump(hexdec("a0000")); +// les deux affichent "int(655360)" +?> + </programlisting> + </example> </para> - </refsect1> - </refentry> - <refentry id="function.mt-rand"> - <refnamediv> - <refname>mt_rand</refname> - <refpurpose> - Génère une meilleure valeur aléatoire. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> + <para> + Voir aussi + <function>dechex</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.lcg-value"> + <refnamediv> + <refname>lcg_value</refname> + <refpurpose> + Générateur de congruence combinée linéaire + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>double <function>lcg_value</function></funcdef> + <paramdef>void</paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>lcg_value</function> retourne un nombre pseudo-aléatoire, + compris entre 0 et 1. <function>lcg_value</function> combine deux + générateurs de congruence, de périodes respectives + <literal>2^31 - 85</literal> et <literal>2^31 - 249</literal>. + La période de cette fonction est le produit de ces deux + nombres premiers (soit <literal>(2^31 - 85)*(2^31 - 249)</literal>). + </para> + </refsect1> + </refentry> + <refentry id="function.log"> + <refnamediv> + <refname>Log</refname> + <refpurpose>Logarithme naturel (nprien)</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>float <function>log</function></funcdef> + <paramdef>float <parameter>arg</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>log</function> retourne le logarithme naturel + (ou nprien) de <parameter>arg</parameter>. + </para> + </refsect1> + </refentry> + <refentry id="function.log10"> + <refnamediv> + <refname>Log10</refname> + <refpurpose>logarithme en base 10.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>float <function>log10</function></funcdef> + <paramdef>float <parameter>arg</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>log10</function> retourne le logarithme en base 10 de + <parameter>arg</parameter>. + </para> + </refsect1> + </refentry> + <refentry id="function.max"> + <refnamediv> + <refname>max</refname> + <refpurpose>La plus grande valeur.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>mixed <function>max</function></funcdef> + <paramdef>mixed <parameter>arg1</parameter></paramdef> + <paramdef>mixed <parameter>arg2</parameter></paramdef> + <paramdef>mixed <parameter>argn</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>max</function> retourne la plus grande valeur + numérique parmi les valeurs passées en paramètre. + </para> + <para> + Si le premier paramètre est un tableau, + <function>max</function> retourne la plus grande valeur de ce tableau. + Si le premier paramètre est un entier, une chaîne ou + un double, <function>max</function> requiert au moins deux paramètres, + et retournera alors le plus grand d'entre eux. + Le nombre d'arguments est alors illimité. + </para> + <para> + Si au moins une valeur est un entier double, elles seront toutes + traitées comme des doubles, et un double sera retourné. + Si aucune valeur n'est de type double, elles seront traitées + comme des entiers, et un entier sera retourné. + </para> + </refsect1> + </refentry> + <refentry id="function.min"> + <refnamediv> + <refname>min</refname> + <refpurpose>La plus petite valeur.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>mixed <function>min</function></funcdef> + <paramdef>mixed <parameter>arg1</parameter></paramdef> + <paramdef>mixed <parameter>arg2</parameter></paramdef> + <paramdef>mixed <parameter>argn</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>min</function> retourne la plus petite valeur + numérique parmi les valeurs passées en paramètres. + </para> + <para> + Si le premier paramètre est un tableau, <function>min</function> + retourne la plus petite valeur de ce tableau. Si le premier + paramètre est un entier, une chaîne ou un double, + <function>min</function> requiert au moins deux paramètres, et + retournera alors le plus petit d'entre eux. Le nombre d'arguments est alors + illimité. + </para> + <para> + Si au moins une valeur est un entier double, elles seront toutes + traitées comme des doubles, et un double sera retourné. + Si aucune valeur n'est de type double, elles seront traitées + comme des entiers, et un entier sera retourné. + </para> + </refsect1> + </refentry> + <refentry id="function.mt-rand"> + <refnamediv> + <refname>mt_rand</refname> + <refpurpose> + Génère une meilleure valeur aléatoire. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>int <function>mt_rand</function></funcdef> - <paramdef> - <parameter><optional>int min</optional></parameter> + <paramdef>int + <parameter><optional>min</optional></parameter> </paramdef> - <paramdef> - <parameter><optional>int max</optional></parameter> + <paramdef>int + <parameter><optional>max</optional></parameter> </paramdef> - </funcsynopsis> - <simpara> - De nombreux générateurs de nombre aléatoires - provenant de vieilles bibliothèques libcs ont des comportement - douteux et sont très lents. Par défaut, PHP utilise le - générateur de nombres aléatoires de libc avec la - fonction <function>rand</function>. <function>mt_rand</function> est une - fonction de remplacement, pour cette dernière. Elle utilise un - générateur de nombre aléatoire de caractéristique - connue, le " Mersenne Twister ", qui va produire des nombres utilisables en - cryptographie, et qui est 4 fois plus rapide que la fonction standard libc. - La "Homepage of the Mersenne Twister " est - <ulink url="&url.mersenne;">&url.mersenne;</ulink>, une version optimisée - des sources de MT est disponible à - <ulink url="&url.mersenne.twister;">&url.mersenne.twister;</ulink>. - </simpara> - <simpara> - Appelé sans les arguments optionnels <parameter>min</parameter>, - <parameter>max</parameter>, <function>mt_rand</function> retourne un nombre - pseudo-aléatoire, entre 0 et <constant>RAND_MAX</constant>. - Pour obtenir un nombre entre 5 et 15 (inclus), il faut utiliser - <literal>mt_rand(5,15)</literal>. - </simpara> - <simpara> - N'oubliez pas d'initialiser le générateur de nombre - aléatoire avec <function>mt_srand</function>. - </simpara> - <note> - <para> - Dans les versions antérieure à la 3.0.7 la signification - du paramètre <parameter>max</parameter> était "longueur". - Pour avoir le même résultat, il faut utiliser - <literal>mt_rand (5, 11)</literal> pour obtenir un nombre - aléatoire entre 5 et 15. - </para> - </note> - <simpara> - Voir aussi <function>mt_srand</function>, <function>mt_getrandmax</function>, - <function>srand</function>, <function>rand</function> et - <function>getrandmax</function>. - </simpara> - </refsect1> - </refentry> - <refentry id="function.mt-srand"> - <refnamediv> - <refname>mt_srand</refname> - <refpurpose>Initialise une meilleure valeur aléatoire</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>void <function>mt_srand</function></funcdef> - <paramdef>int <parameter>seed</parameter></paramdef> - </funcprototype> - </funcsynopsis> + </funcprototype> + </funcsynopsis> + <simpara> + De nombreux générateurs de nombres aléatoires + provenant de vieilles bibliothèques libcs ont des comportement + douteux et sont très lents. Par défaut, PHP utilise le + générateur de nombres aléatoires de libc avec la + fonction <function>rand</function>. <function>mt_rand</function> est une + fonction de remplacement, pour cette dernière. Elle utilise un + générateur de nombres aléatoire de caractéristique + connue, le " Mersenne Twister ", qui va produire des nombres utilisables en + cryptographie, et qui est 4 fois plus rapide que la fonction standard libc. + La "Homepage of the Mersenne Twister " est + <ulink url="&url.mersenne;">&url.mersenne;</ulink>. Une version optimisée + des sources de MT est disponible à + <ulink url="&url.mersenne.twister;">&url.mersenne.twister;</ulink>. + </simpara> + <simpara> + Appelée sans les arguments optionnels <parameter>min</parameter> et + <parameter>max</parameter>, <function>mt_rand</function> retourne un nombre + pseudo-aléatoire, entre 0 et <constant>RAND_MAX</constant>. + Pour obtenir un nombre entre 5 et 15 inclus, il faut utiliser + <literal>mt_rand(5,15)</literal>. + </simpara> + <simpara> + N'oubliez pas d'initialiser le générateur de nombres + aléatoires avec <function>mt_srand</function>. + </simpara> + <note> <para> - <function>mt_srand</function> initialise une meilleure valeur - aléatoire avec <parameter>seed</parameter>. - <informalexample> - <programlisting role="php"> + Dans les versions antérieures à la 3.0.7, la signification + du paramètre <parameter>max</parameter> était "longueur". + Pour avoir le même résultat, il faut utiliser + <literal>mt_rand (5, 11)</literal> pour obtenir un nombre + aléatoire entre 5 et 15. + </para> + </note> + <simpara> + Voir aussi + <function>mt_srand</function>, + <function>mt_getrandmax</function>, + <function>srand</function>, + <function>rand</function> et + <function>getrandmax</function>. + </simpara> + </refsect1> + </refentry> + <refentry id="function.mt-srand"> + <refnamediv> + <refname>mt_srand</refname> + <refpurpose>Initialise une meilleure valeur aléatoire</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>void <function>mt_srand</function></funcdef> + <paramdef>int <parameter>seed</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>mt_srand</function> initialise une meilleure valeur + aléatoire avec <parameter>seed</parameter>. + <informalexample> + <programlisting role="php"> <?php // initialise avec les microsecondes depuis la dernière seconde entière -mt_srand((double)microtime()*1000000); -$randval = mt_rand(); + mt_srand((double)microtime()*1000000); + $randval = mt_rand(); ?> - </programlisting> - </informalexample> - </para> - <simpara> - Voir aussi <function>mt_rand</function>, <function>mt_getrandmax</function>, - <function>srand</function>, <function>rand</function> et - <function>getrandmax</function>. - </simpara> - </refsect1> - </refentry> - <refentry id="function.mt-getrandmax"> - <refnamediv> - <refname>mt_getrandmax</refname> - <refpurpose>La plus grand valeur aléatoire possible.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>mt_getrandmax</function></funcdef> - <paramdef>void </paramdef> - </funcprototype> - </funcsynopsis> - <simpara> - <function>mt_getrandmax</function> retourne la plus grand valeur - aléatoire possible que peut retourner <function>mt_rand</function>. - </simpara> - <simpara> - Voir aussi <function>mt_rand</function>, <function>mt_srand</function> - <function>rand</function>, <function>srand</function> et - <function>getrandmax</function>. - </simpara> - </refsect1> - </refentry> - <refentry id="function.number-format"> - <refnamediv> - <refname>number_format</refname> - <refpurpose>Formate un nombre par groupe de millier.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>number_format</function></funcdef> - <paramdef>float <parameter>number</parameter></paramdef> - <paramdef>int <parameter>decimals</parameter></paramdef> - <paramdef>string <parameter>dec_point</parameter></paramdef> - <paramdef>string <parameter>thousands_sep</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>number_format</function> retourne une chaîne - représentant <parameter>number</parameter> formaté. - <function>number_format</function> accepte un, deux ou 4 paramètres - (mais pas trois). - </para> - <para> - Si un seul paramètre est donné, - <parameter>number</parameter> sera formaté sans - décimale, mais avec une virgule entre chaque série de 1000. - </para> - <para> - Avec deux paramètres, <parameter>number</parameter> sera - formaté avec <parameter>decimals</parameter> décimales - et un point ("."), une virgule entre chaque série de 1000. - </para> - <para> - Avec quatre paramètres, <parameter>number</parameter> sera - formaté avec <parameter>decimals</parameter> décimales - et <parameter>dec_point</parameter> à la place du point, une - virgule entre chaque série de 1000. - </para> - </refsect1> - </refentry> - <refentry id="function.octdec"> - <refnamediv> - <refname>OctDec</refname> - <refpurpose>Convertit d'octal en décimal.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>octdec</function></funcdef> - <paramdef>string <parameter>octal_string</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>octdec</function> retourne une chaîne contenant la - représentation décimale du nombre - <parameter>octal_tring</parameter>. Le nombre le plus grand qui - puisse être converti est 17777777777 en décimal, - ce qui donnera "2147483647". - </para> - <para> - Voir aussi <function>decoct</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.pi"> - <refnamediv> - <refname>pi</refname> - <refpurpose>Retourne la valeur de pi </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>double <function>pi</function></funcdef> - <paramdef>void </paramdef> - </funcprototype> - </funcsynopsis> - <simpara> - <function>pi</function> retourne la valeur de pi. - </simpara> - </refsect1> - </refentry> - <refentry id="function.pow"> - <refnamediv> - <refname>pow</refname> - <refpurpose>Puissance</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>float <function>pow</function></funcdef> - <paramdef>float <parameter>base</parameter></paramdef> - <paramdef>float <parameter>exp</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>pow</function> retourne <parameter>base</parameter> - élevé à la puissance <parameter>exp</parameter>. - </para> - <para> - Voir aussi <function>exp</function>. - </para> - </refsect1> - </refentry> -<refentry id="function.rad2deg"> - <refnamediv> - <refname>rad2deg</refname> - <refpurpose> - Convertit un nombre en radian en degrés - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>double <function>rad2deg</function></funcdef> - <paramdef>double <parameter>number</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>rad2deg</function> convertit <parameter>number</parameter> - (supposé en radians) en degrés. - </para> - <para> - Voir aussi <function>deg2rad</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.rand"> - <refnamediv> - <refname>rand</refname> - <refpurpose>Génère une valeur aléatoire.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>rand</function></funcdef> - <paramdef> - <parameter><optional>int min</optional></parameter> - </paramdef> - <paramdef> - <parameter><optional>int max</optional></parameter> - </paramdef> - </funcprototype> - </funcsynopsis> - <simpara> - Appelée sans les options <parameter>min</parameter> et - <parameter>max</parameter>, <function>rand</function> retourne un - nombre pseudo-aléatoire entre 0 et <constant>RAND_MAX</constant>. - Si vous voulez un nombre aléatoire entre 5 et 15 - (inclus), par exemple, utilisez <literal>rand (5, 15)</literal>. - </simpara> - <simpara> - N'oubliez pas d'initialiser le générateur de nombres - aléatoires avec <function>srand</function>. - </simpara> + </programlisting> + </informalexample> + </para> + <simpara> + Voir aussi + <function>mt_rand</function>, + <function>mt_getrandmax</function>, + <function>srand</function>, + <function>rand</function> et + <function>getrandmax</function>. + </simpara> + </refsect1> + </refentry> + <refentry id="function.mt-getrandmax"> + <refnamediv> + <refname>mt_getrandmax</refname> + <refpurpose>La plus grand valeur aléatoire possible.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>mt_getrandmax</function></funcdef> + <paramdef>void </paramdef> + </funcprototype> + </funcsynopsis> + <simpara> + <function>mt_getrandmax</function> retourne la plus grand valeur + aléatoire possible que peut retourner <function>mt_rand</function>. + </simpara> + <simpara> + Voir aussi + <function>mt_rand</function>, + <function>mt_srand</function> + <function>rand</function>, + <function>srand</function> et + <function>getrandmax</function>. + </simpara> + </refsect1> + </refentry> + <refentry id="function.number-format"> + <refnamediv> + <refname>number_format</refname> + <refpurpose>Formate un nombre pour l'affichage.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>number_format</function></funcdef> + <paramdef>float <parameter>number</parameter></paramdef> + <paramdef>int <parameter><optional>decimals</optional></parameter></paramdef> + <paramdef>string <parameter><optional>dec_point</optional></parameter></paramdef> + <paramdef>string <parameter><optional>thousands_sep</optional></parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>number_format</function> retourne une chaîne + représentant <parameter>number</parameter> formaté. + <function>number_format</function> accepte un, deux ou 4 paramètres + (mais pas trois). + </para> + <para> + Si le seul paramètre <parameter>number</parameter> est donné, + il sera formaté sans partie décimale, mais avec une + virgule entre chaque millier. + </para> + <para> + Si les deux paramètres <parameter>number</parameter> et + <parameter>decimals</parameter> sont fournis, <parameter>number</parameter> sera + formaté avec <parameter>decimals</parameter> décimales, + un point (".") comme séparateur décimal et une virgule entre chaque + millier. + </para> + <para> + Avec quatre paramètres, <parameter>number</parameter> sera + formaté avec <parameter>decimals</parameter> décimales, + <parameter>dec_point</parameter> comme séparateur décimal, et + <parameter>thousands_sep</parameter> comme séparateur de milliers. + </para> <note> <para> - Dans les versions antérieure à la 3.0.7 la signification - du paramètre <parameter>max</parameter> était longueur. - Pour avoir le même résultat, il faut utiliser - <literal>mt_rand (5, 11)</literal> pour obtenir un nombre aléatoire - entre 5 et 15. + Seul le premier caractère du paramètre <parameter>thousands_sep</parameter> + est utilisé. Par exemple, si vous utilisez <literal>foo</literal> comme + séparateur de milliers, sur le nombre <literal>1000</literal>, + <function>number_format</function> retournera <literal>1f000</literal>. </para> </note> - <simpara> - Voir aussi <function>srand</function>, <function>getrandmax</function>, - <function>mt_rand</function>, <function>mt_srand</function> et - <function>mt_getrandmax</function>. - </simpara> - </refsect1> - </refentry> - <refentry id="function.round"> - <refnamediv> - <refname>round</refname> - <refpurpose>Arrondi.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>double <function>round</function></funcdef> - <paramdef>double <parameter>val</parameter></paramdef> - <paramdef>int - <parameter><optional>precision</optional></parameter> - </paramdef> - </funcprototype> - </funcsynopsis> + <para> + En notation française, on utilise généralement deux chiffres + après la virgule, une virgule comme séparateur décimal, et un + espace comme séparateur de milliers. Cela donne : + <informalexample> + <programlisting role="php"> +<?php + $nombre = 1234.56; +// Notation anglaise (par défaut) + $english_format_number = number_format($nombre); +// 1,234.56 +// Notation française + $nombre_format_francais = number_format($nombre, 2, ',', ' '); +// 1 234,56 +?> + </programlisting> + </informalexample> + </para> + <para> + Voir aussi + <function>sprintf</function>, + <function>printf</function> et + <function>sscanf</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.octdec"> + <refnamediv> + <refname>OctDec</refname> + <refpurpose>Convertit d'octal en décimal.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>octdec</function></funcdef> + <paramdef>string <parameter>octal_string</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>octdec</function> retourne une chaîne contenant la + représentation décimale du nombre + <parameter>octal_tring</parameter>. Le nombre le plus grand qui + puisse être converti est 17777777777 en décimal, + ce qui donnera "2147483647". + </para> + <para> + Voir aussi + <function>decoct</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.pi"> + <refnamediv> + <refname>pi</refname> + <refpurpose>Retourne la valeur de pi </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>double <function>pi</function></funcdef> + <paramdef>void </paramdef> + </funcprototype> + </funcsynopsis> + <simpara> + <function>pi</function> retourne la valeur de pi. + </simpara> + <para> + <informalexample> + <programlisting role="php"> +<?php + echo pi(); +// 3.1415926535898 +?> + </programlisting> + </informalexample> + </para> + </refsect1> + </refentry> + <refentry id="function.pow"> + <refnamediv> + <refname>pow</refname> + <refpurpose>Puissance</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>float <function>pow</function></funcdef> + <paramdef>float <parameter>base</parameter></paramdef> + <paramdef>float <parameter>exp</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>pow</function> retourne <parameter>base</parameter> + élevé à la puissance <parameter>exp</parameter>. + Si le calcul est impossible (racine d'un nombre négatif, par + exemple), <function>exp</function> retourne <literal>NAN</literal>. + </para> + <para> + Voir aussi + <function>exp</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.rad2deg"> + <refnamediv> + <refname>rad2deg</refname> + <refpurpose> + Convertit de radians en degrés + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>double <function>rad2deg</function></funcdef> + <paramdef>double <parameter>number</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>rad2deg</function> convertit <parameter>number</parameter> + (supposé en radians) en degrés. + </para> + <para> + Voir aussi + <function>deg2rad</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.rand"> + <refnamediv> + <refname>rand</refname> + <refpurpose>Génère une valeur aléatoire.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>rand</function></funcdef> + <paramdef>int + <parameter><optional>min</optional></parameter> + </paramdef> + <paramdef>int + <parameter><optional>max</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <simpara> + Appelée sans les options <parameter>min</parameter> et + <parameter>max</parameter>, <function>rand</function> retourne un + nombre pseudo-aléatoire entre 0 et <constant>RAND_MAX</constant>. + Si vous voulez un nombre aléatoire entre 5 et 15 + (inclus), par exemple, utilisez <literal>rand (5, 15)</literal>. + </simpara> + <simpara> + N'oubliez pas d'initialiser le générateur de nombres + aléatoires avec <function>srand</function>. + </simpara> + <note> <para> - <function>round</function> retourne la valeur arrondie de <parameter>val</parameter> - à la précision <parameter>precision</parameter> - (nombre de chiffres après la virgule). - <informalexample> - <programlisting role="php"> + Dans les versions antérieures à la 3.0.7 la signification + du paramètre <parameter>max</parameter> était longueur. + Pour avoir le même résultat, il faut utiliser + <literal>mt_rand (5, 11)</literal> pour obtenir un nombre aléatoire + entre 5 et 15. + </para> + </note> + <simpara> + Voir aussi + <function>srand</function>, + <function>getrandmax</function>, + <function>mt_rand</function>, + <function>mt_srand</function> et + <function>mt_getrandmax</function>. + </simpara> + </refsect1> + </refentry> + <refentry id="function.round"> + <refnamediv> + <refname>round</refname> + <refpurpose>Arrondi.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>double <function>round</function></funcdef> + <paramdef>double <parameter>val</parameter></paramdef> + <paramdef>int + <parameter><optional>precision</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>round</function> retourne la valeur arrondie de <parameter>val</parameter> + à la précision <parameter>precision</parameter> + (nombre de chiffres après la virgule). + <informalexample> + <programlisting role="php"> <?php -$foo = round( 3.4 ); // $foo == 3.0 -$foo = round( 3.5 ); // $foo == 4.0 -$foo = round( 3.6 ); // $foo == 4.0 + $foo = round( 3.4 ); // $foo == 3.0 + $foo = round( 3.5 ); // $foo == 4.0 + $foo = round( 3.6 ); // $foo == 4.0 ?> - </programlisting> - </informalexample> - </para> - <note> - <simpara> - Le paramètre <parameter>precision</parameter> est disponible - uniquement en PHP 4. - </simpara> - </note> + </programlisting> + </informalexample> + </para> + <note> <simpara> - Voir aussi <function>ceil</function> et <function>floor</function>. + Le paramètre <parameter>precision</parameter> est disponible + uniquement en PHP 4. </simpara> - </refsect1> - </refentry> - <refentry id="function.sin"> - <refnamediv> - <refname>sin</refname> - <refpurpose>Sinus</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>float <function>sin</function></funcdef> - <paramdef>float <parameter>arg</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>sin</function> retourne le sinus de <parameter>arg</parameter> - (<parameter>arg</parameter> in radians). - </para> - <para> - Voir aussi <function>cos</function> et <function>tan</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.sqrt"> - <refnamediv> - <refname>sqrt</refname> - <refpurpose>Racine carrée.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>float <function>sqrt</function></funcdef> - <paramdef>float <parameter>arg</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>sqrt</function> retourne la racine carrée de - <parameter>arg</parameter>. + </note> + <simpara> + Voir aussi + <function>ceil</function> et + <function>floor</function>. + </simpara> + </refsect1> + </refentry> + <refentry id="function.sin"> + <refnamediv> + <refname>Sin</refname> + <refpurpose>Sinus</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>float <function>sin</function></funcdef> + <paramdef>float <parameter>arg</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>sin</function> retourne le sinus de <parameter>arg</parameter> + (<parameter>arg</parameter> in radians). </para> - </refsect1> - </refentry> - <refentry id="function.srand"> - <refnamediv> - <refname>srand</refname> - <refpurpose>Initialise le générateur de nombres aléatoires</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>void <function>srand</function></funcdef> - <paramdef>int <parameter>seed</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>srand</function> initialise le générateur de - nombres aléatoires avec <parameter>seed</parameter>. - <informalexample> - <programlisting role="php"> + <para> + Voir aussi + <function>cos</function> et + <function>tan</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.sqrt"> + <refnamediv> + <refname>Sqrt</refname> + <refpurpose>Racine carrée.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>float <function>sqrt</function></funcdef> + <paramdef>float <parameter>arg</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>sqrt</function> retourne la racine carrée de + <parameter>arg</parameter>. + </para> + </refsect1> + </refentry> + <refentry id="function.srand"> + <refnamediv> + <refname>srand</refname> + <refpurpose>Initialise le générateur de nombres aléatoires</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>void <function>srand</function></funcdef> + <paramdef>int <parameter>seed</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>srand</function> initialise le générateur de + nombres aléatoires avec <parameter>seed</parameter>. + <informalexample> + <programlisting role="php"> <?php // initialise avec les microsecondes depuis la dernière seconde entière -srand((double)microtime()*1000000); -$randval = rand(); + srand((double)microtime()*1000000); + $randval = rand(); ?> - </programlisting> - </informalexample> - </para> - <simpara> - Voir aussi <function>rand</function>, - <function>getrandmax</function>, - <function>mt_rand</function>, - <function>mt_srand</function> et <function>mt_getrandmax</function>. - </simpara> - </refsect1> - </refentry> - <refentry id="function.tan"> - <refnamediv> - <refname>tan</refname> - <refpurpose>Tangente</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>float <function>tan</function></funcdef> - <paramdef>float <parameter>arg</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>tan</function> retourne la tangente de - <parameter>arg</parameter> (<parameter>arg</parameter> en radians). - </para> - <para> - Voir aussi <function>sin</function> et <function>cos</function>. - </para> - </refsect1> - </refentry> - </reference> + </programlisting> + </informalexample> + </para> + <simpara> + Voir aussi + <function>rand</function>, + <function>getrandmax</function>, + <function>mt_rand</function>, + <function>mt_srand</function> et + <function>mt_getrandmax</function>. + </simpara> + </refsect1> + </refentry> + <refentry id="function.tan"> + <refnamediv> + <refname>Tan</refname> + <refpurpose>Tangente</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>float <function>tan</function></funcdef> + <paramdef>float <parameter>arg</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>tan</function> retourne la tangente de + <parameter>arg</parameter> (<parameter>arg</parameter> en radians). + </para> + <para> + Voir aussi + <function>sin</function> et + <function>cos</function>. + </para> + </refsect1> + </refentry> +</reference> <!-- Keep this comment at the end of the file Local variables: mode: sgml