cvs: phpdoc /fr/functions math.xml

From:	Damien Seguy	Date:	Thu, 23 Nov 2000 14:27:29 +0000
Subject:	cvs: phpdoc /fr/functions math.xml
Groups:	php.doc
Request:	Send a blank email to phpdoc+get-969333048@lists.php.net to get a copy of this message

dams Thu Nov 23 06:27:29 2000 EDT Modified files: /phpdoc/fr/functions math.xml Log: Adding deg2rad and rad2deg.

Index: phpdoc/fr/functions/math.xml diff -u phpdoc/fr/functions/math.xml:1.2 phpdoc/fr/functions/math.xml:1.3 --- phpdoc/fr/functions/math.xml:1.2 Sat Oct 14 06:26:30 2000 +++ phpdoc/fr/functions/math.xml Thu Nov 23 06:27:29 2000 @@ -1,965 +1,1104 @@ - <reference id="ref.math"> - <title>Fonctions 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 à - <link linkend="ref.bc">fonctions mathématiques de nombre de taille arbitraire</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>La valeur de PI</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> - <funcdef>mixed <function>abs</function></funcdef> - <paramdef>mixed <parameter>number</parameter></paramdef> - </funcsynopsis> - <para> - 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> - <funcdef>float <function>acos</function></funcdef> - <paramdef>float <parameter>arg</parameter></paramdef> - </funcsynopsis> - <para> - Retourne l'arc cosinus de <parameter>arg</parameter> (arg 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> - <funcdef>float <function>asin</function></funcdef> - <paramdef>float <parameter>arg</parameter></paramdef> - </funcsynopsis> - <para> - Retourne l'arc sinus de <parameter>arg</parameter> (arg 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> - <funcdef>float <function>atan</function></funcdef> - <paramdef>float <parameter>arg</parameter></paramdef> - </funcsynopsis> - <para> - Retourne l'arc tangent de <parameter>arg</parameter> (arg 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> - <funcdef>float <function>atan2</function></funcdef> - <paramdef>float <parameter>y</parameter></paramdef> - <paramdef>float <parameter>x</parameter></paramdef> - </funcsynopsis> - <simpara> - 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> - Cette fonction 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>Converti un nombre en des bases arbitraires.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>strin <function>base_convert</function></funcdef> - <paramdef>string <parameter>number</parameter></paramdef> - <paramdef>int <parameter>frombase</parameter></paramdef> - <paramdef>int <parameter>tobase</parameter></paramdef> - </funcsynopsis> - <para> - 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>base_convert()</title> - <programlisting role="php"> -$binary = base_convert($hexadecimal, 16, 2); -</programlisting> - </example></para> - </refsect1> - </refentry> - - - <refentry id="function.bindec"> - <refnamediv> - <refname>BinDec</refname> - <refpurpose>Converti de binaire en décimal </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>bindec</function></funcdef> - <paramdef>string <parameter>binary_string</parameter></paramdef> - </funcsynopsis> - <para> - 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> - <funcdef>int <function>ceil</function></funcdef> - <paramdef>float <parameter>number</parameter></paramdef> - </funcsynopsis> - <simpara> - Retourne l'entier supérieur du nombre <parameter>number</parameter>. Utiliser - <function>ceil</function> sur un entier ne sert à rien. - </simpara> - - <simpara> - NOTE: <function>ceil</function> sous PHP/FI 2 retournait un float. - 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> - <funcdef>float <function>cos</function></funcdef> - <paramdef>float <parameter>arg</parameter></paramdef> - </funcsynopsis> - <para> - Retourne le cosinus de arg (arg 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>Converti de décimal en binaire</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>string <function>decbin</function></funcdef> - <paramdef>int <parameter>number</parameter></paramdef> - </funcsynopsis> - <para> - 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>Converti de décimal en hexadécimal </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>string <function>dechex</function></funcdef> - <paramdef>int <parameter>number</parameter></paramdef> - </funcsynopsis> - <para> - 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>converti de décimal en octal </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>string <function>decoct</function></funcdef> - <paramdef>int <parameter>number</parameter></paramdef> - </funcsynopsis> - <para> - 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.exp"> - <refnamediv> - <refname>Exp</refname> - <refpurpose>exponentielle</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>float <function>exp</function></funcdef> - <paramdef>float <parameter>arg</parameter></paramdef> - </funcsynopsis> - <para> - 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> - <funcdef>int <function>floor</function></funcdef> - <paramdef>float <parameter>number</parameter></paramdef> - </funcsynopsis> - <simpara> - 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> - <funcdef>int <function>getrandmax</function></funcdef> - <paramdef>void </paramdef> - </funcsynopsis> - - <simpara> - 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>Converti de hexadécimal en décimal </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>hexdec</function></funcdef> - <paramdef>string <parameter>hex_string</parameter></paramdef> - </funcsynopsis> - <para> - 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.log"> - <refnamediv> - <refname>Log</refname> - <refpurpose>Logarithme naturel </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>float <function>log</function></funcdef> - <paramdef>float <parameter>arg</parameter></paramdef> - </funcsynopsis> - <para> - Retourne le logarithme naturel de arg. - </para> - - </refsect1> - </refentry> - - - <refentry id="function.log10"> - <refnamediv> - <refname>Log10</refname> - <refpurpose>logarithme en base 10.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>float <function>log10</function></funcdef> - <paramdef>float <parameter>arg</parameter></paramdef> - </funcsynopsis> - <para> - 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> - <funcdef>mixed <function>max</function></funcdef> - <paramdef>mixed <parameter>arg1</parameter></paramdef> - <paramdef>mixed <parameter>arg2</parameter></paramdef> - <paramdef>mixed <parameter>argn</parameter></paramdef> - </funcsynopsis> - <para> - <function>max</function> retourne la 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> - <funcdef>mixed <function>min</function></funcdef> - <paramdef>mixed <parameter>arg1</parameter></paramdef> - <paramdef>mixed <parameter>arg2</parameter></paramdef> - <paramdef>mixed <parameter>argn</parameter></paramdef> - </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> - <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.mt-rand"> - <refnamediv> - <refname>mt_rand</refname> - <refpurpose>Génère une meilleure valeur aléatoire.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>mt_rand</function></funcdef> - <paramdef> - <parameter><optional>int min</optional></parameter> - </paramdef> - <paramdef> - <parameter><optional>int 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> - <funcdef>void <function>mt_srand</function></funcdef> - <paramdef>int <parameter>seed</parameter></paramdef> - </funcsynopsis> - - <para> - Initialise une meilleure valeur aléatoire avec <parameter>seed</parameter>. - - <informalexample> - <programlisting> -// initialise avec les microsecondes depuis la dernière seconde entière -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> - <funcdef>int <function>mt_getrandmax</function></funcdef> - <paramdef>void </paramdef> - </funcsynopsis> - - <simpara> - 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 milliers.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <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> - </funcsynopsis> - <para> - <function>number_format</function> retourne une chaîne représentant - <parameter>number</parameter> formaté. Cette fonction 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>Converti d'octal en décimal.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>octdec</function></funcdef> - <paramdef>string <parameter>octal_string</parameter></paramdef> - </funcsynopsis> - <para> - Retourne une chaîne contenant la représentation décimale du nombre - <parameter>octal_string</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> - <funcdef>double <function>pi</function></funcdef> - <paramdef>void </paramdef> - </funcsynopsis> - - <simpara> - 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> - <funcdef>float <function>pow</function></funcdef> - <paramdef>float <parameter>base</parameter></paramdef> - <paramdef>float <parameter>exp</parameter></paramdef> - </funcsynopsis> - <para> - Retourne <parameter>base</parameter> élevé à la puissance - <parameter>exp</parameter>. - </para> - - <para> - Voir aussi <function>exp</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> - <funcdef>int <function>rand</function></funcdef> - <paramdef> - <parameter><optional>int min</optional></parameter> - </paramdef> - <paramdef> - <parameter><optional>int max</optional></parameter> - </paramdef> - </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> - 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>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> - <funcdef>double <function>round</function></funcdef> - <paramdef>double <parameter>val</parameter></paramdef> - </funcsynopsis> - - <para> - Retourne la valeur arrondie de <parameter>val</parameter>. - - <informalexample> - <programlisting> -$foo = round( 3.4 ); // $foo == 3.0 -$foo = round( 3.5 ); // $foo == 4.0 -$foo = round( 3.6 ); // $foo == 4.0 - </programlisting> - </informalexample> - </para> - - <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> - <funcdef>float <function>sin</function></funcdef> - <paramdef>float <parameter>arg</parameter></paramdef> - </funcsynopsis> - <para> - Retourne le sinus de <parameter>arg</parameter> ( arg 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> - <funcdef>float <function>sqrt</function></funcdef> - <paramdef>float <parameter>arg</parameter></paramdef> - </funcsynopsis> - - <para> - 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> - <funcdef>void <function>srand</function></funcdef> - <paramdef>int <parameter>seed</parameter></paramdef> - </funcsynopsis> - - <para> - Initialise le générateur de nombres aléatoires avec <parameter>seed</parameter>. - - <informalexample> - <programlisting> -// initialise avec les microsecondes depuis la dernière seconde entière -sret((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> - <funcdef>float <function>tan</function></funcdef> - <paramdef>float <parameter>arg</parameter></paramdef> - </funcsynopsis> - <para> - Retourne la tangente de <parameter>arg</parameter> (arg en radians). - </para> - - <para> - Voir aussi <function>sin</function> et <function>cos</function>. - </para> - - </refsect1> - </refentry> - - - </reference> - - + <reference id="ref.math"> + <title>Fonctions 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>La valeur de 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>Constante d'Euler[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> (arg 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> (arg 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> + <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> (arg 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> + Cette fonction 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>Converti 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"> +$binary = base_convert($hexadecimal, 16, 2); +</programlisting> + </example></para> + </refsect1> + </refentry> + <refentry id="function.bindec"> + <refnamediv> + <refname>BinDec</refname> + <refpurpose>Converti 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> + <simpara> + <function>ceil</function> retourne l'entier supérieur du + nombre <parameter>number</parameter>. Utiliser + <function>ceil</function> sur un entier ne sert à rien. + </simpara> + <simpara> + NOTE: <function>ceil</function> sous PHP/FI 2 retournait un float. + 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 (arg 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>Converti 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>Converti 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>converti 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> + Converti 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> + Cette fonction converti <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> + <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>Converti 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> + <void/> + </funcprototype> + </funcsynopsis> + <para> + <function>lcg_value</function> retourne un nombre pseudo-aléatoire, + compris entre 0 et 1. Cette fonction 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 arg. + </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> + <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.mt-rand"> + <refnamediv> + <refname>mt_rand</refname> + <refpurpose> + Génère une meilleure valeur aléatoire. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcdef>int <function>mt_rand</function></funcdef> + <paramdef> + <parameter><optional>int min</optional></parameter> + </paramdef> + <paramdef> + <parameter><optional>int 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> + <para> + <function>mt_srand</function> initialise une meilleure valeur + aléatoire avec <parameter>seed</parameter>. + <informalexample> + <programlisting> +// initialise avec les microsecondes depuis la dernière seconde entière +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 milliers.</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é. + Cette fonction 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>Converti 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> + 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> + Converti 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> converti <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> + <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>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>. + <informalexample> + <programlisting> +$foo = round( 3.4 ); // $foo == 3.0 +$foo = round( 3.5 ); // $foo == 4.0 +$foo = round( 3.6 ); // $foo == 4.0 + </programlisting> + </informalexample> + </para> + <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> + (arg 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>. + </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> +// initialise avec les microsecondes depuis la dernière seconde entière +sret((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> (arg en radians). + </para> + <para> + Voir aussi <function>sin</function> et <function>cos</function>. + </para> + </refsect1> + </refentry> + </reference> +