cvs: phpdoc /fr/functions gmp.xml

From: Date: Wed, 06 Dec 2000 16:17:21 +0000
Subject: cvs: phpdoc /fr/functions gmp.xml
Groups: php.doc 
Request: Send a blank email to phpdoc+get-969333165@lists.php.net to get a copy of this message
dams Wed Dec 6 08:17:21 2000 EDT Modified files: /phpdoc/fr/functions gmp.xml Log: Translation.

Index: phpdoc/fr/functions/gmp.xml diff -u phpdoc/fr/functions/gmp.xml:1.1 phpdoc/fr/functions/gmp.xml:1.2 --- phpdoc/fr/functions/gmp.xml:1.1 Wed Dec 6 06:59:49 2000 +++ phpdoc/fr/functions/gmp.xml Wed Dec 6 08:17:20 2000 @@ -1,63 +1,61 @@ <reference id="ref.gmp"> - <title>GMP functions</title> + <title>GMP</title> <titleabbrev>GMP</titleabbrev> <partintro> <simpara> - These functions allow you to work with arbitrary-length integers - using GNU <acronym>MP</acronym> library. In order to have these - functions available, you must compile PHP with - <acronym>GMP</acronym> - support by using the <option role="configure">--with-gmp</option> - option. + Ces fonctions vous permettent de travailler avec des nombres de taille + arbitraire, en utilisant la librairie GNU <acronym>MP</acronym>. + Pour pouvoir y acc&eacute;der, vous devez compiler PHP avec le support + <acronym>GMP</acronym> en utilisant l'option + <option role="configure">--with-gmp</option>. </simpara> <simpara> - You can download the <acronym>GMP</acronym> library from <ulink + Vous pouvez t&eacute;l&eacute;charger <acronym>GMP</acronym> sur le site de <ulink url="&url.gmp;">&url.gmp;</ulink>. - This site also has the <acronym>GMP</acronym> manual available. + Ce site propose aussi un manuel <acronym>GMP</acronym>. </simpara> <simpara> - You will need GMP version 2 or better to use these functions. Some - functions may require more recent version of the GMP library. + Vous devez utiliser GMP version 2 ou plus r&eacute;cent pour utiliser ces fonctions. + Certaines d'entre elles peuvent requ&eacute;rir une version encore plus r&eacute;cente de + GMP. </simpara> <simpara> - These functions have been added in PHP 4.0.4. + Ces fonctions ont &eacute;t&eacute; ajout&eacute;e dans PHP 4.0.4. </simpara> <note><para> - Most GMP functions accept GMP number arguments, defined as - <literal>resource</literal> below. However, most of these functions - will accept also numeric and string arguments, given it's possible - to convert the latter to number. Also, if there's faster function that - can operate on integer arguments, it would be used instead of - slower function when supplied arguments are integers. This is done - transparently, so the bootom line is that you can use integers in - every function that expects GMP number. See also - <function>gmp_init</function> function. + La pluspart des fonctions GMP acceptent des nombres GMP comme arguments, + d&eacute;finis ci-dessous comme <literal>resource</literal>. Cependant, + la plus part de ces fonctions acceptent aussi des nombres et des cha&icirc;nes + &agrave; partir du moment o&ugrave; on peut les convertir en nombre. Si une fonction + utilisant les entiers est plus rapide, elle sera automatiquement + appel&eacute;e si les arguments fournis sont des entiers. Cela se fait + de mani&egrave;re transparante : vous pouvez donc utiliser des entiers + avec les fonctions GMP sans perte de vitesse. Voir aussi + <function>gmp_init</function>. </para></note> <para> <example> - <title>Factorial function using GMP</title> + <title>Factorielle avec GMP</title> <programlisting role="php"> &lt;?php function fact($x) { - if($x <= 1) + if($x <= 1) return 1; else return gmp_mul($x,fact($x-1)); } - print gmp_strval(fact(1000))."\n"; ?> </programlisting> </example> - This will calculate factiorial of 1000 (pretty big number) - very fast. + Cet exemple va calculer factiorielle de 1000 (un plut&ocirc;t + grand nombre) tr&egrave;s vite. </para> </partintro> - <refentry id="function.gmp-init"> <refnamediv> <refname>gmp_init</refname> - <refpurpose>Create GMP number</refpurpose> + <refpurpose>Cr&eacute;e un nombre GMP</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -68,13 +66,14 @@ </funcprototype> </funcsynopsis> <para> - Creates a GMP number from integer or string. String representation - can be decimal or hexadecimal. In the latter case, the string should - start with <literal>0x</literal>. + <function>gmp_init</function> cr&eacute;e un nombre GMP, &agrave; partir d'un + entier ou d'une cha&icirc;ne. Les chaines peuvent &ecirc;tre en d&eacute;cimal ou en + hexad&eacute;cimal. Dans ce dernier cas, la chaine doit commencer par + <literal>0x</literal>. </para> <para> <example> - <title>Creating GMP number</title> + <title>Cr&eacute;ation d'un nombre GMP</title> <programlisting role="php"> &lt;?php $a = gmp_init(123456); @@ -85,20 +84,20 @@ </para> <note> <para> - It is not necessary to call this function if you want to use - integer or string in place of GMP number in GMP functions, like - <function>gmp_add</function>. Function arguments are automatically - converted to GMP numbers, if such conversion is possible and needed, - using the same rules as <function>gmp_init</function>. + Il n'est pas n&eacute;cessaire d'appeler cette fonction si vous voulez utiliser + des entiers ou des cha&icirc;nes &agrave; la place de nombre GMP dans les fonctions + GMP, comme par exemple <function>gmp_add</function>. Les arguments de + cette fonction sont automatiquement convertis en nombres GMP, si cette + conversion est possible et n&eacute;cessaire, en utilisant les m&ecirc;mes r&egrave;gles + que <function>gmp_init</function>. </para> </note> </refsect1> </refentry> - <refentry id="function.gmp-intval"> <refnamediv> <refname>gmp_intval</refname> - <refpurpose>Convert GMP number to integer</refpurpose> + <refpurpose>Converti un nombre GMP en entier</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -109,21 +108,22 @@ </funcprototype> </funcsynopsis> <para> - This function allows to convert GMP number to integer. - <warning><simpara> - This function returns useful result only if the number actually - fits the PHP integer (i.e., signed long type). If you want just to - print the GMP number, use <function>gmp_strval</function>. - </simpara> - </warning> + <function>gmp_intval</function> converti un nombre GMP en entier. + <warning> + <simpara> + <function>gmp_intval</function> retourne un r&eacute;sultat coh&eacute;rent + uniquement si le nombre GMP peut &ecirc;tre repr&eacute;sent&eacute; par un entier + PHP (i.e. type long sign&eacute;). Si vous vous voulez simplement afficher + un nombre GMP, utilisez plut&ocirc;t <function>gmp_strval</function>. + </simpara> + </warning> </para> </refsect1> </refentry> - <refentry id="function.gmp-strval"> <refnamediv> <refname>gmp_strval</refname> - <refpurpose>Convert GMP number to string</refpurpose> + <refpurpose>Convertit un nombre GMP en cha&icirc;ne</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -137,28 +137,27 @@ </funcprototype> </funcsynopsis> <para> - Convert GMP number to string representation in base - <parameter>base</parameter>. The default base is 10. - Allowed values for the base are from 2 to 36. + <function>gmp_strval</function> convertit un nombre GMP en + cha&icirc;ne de caract&egrave;res, dans la base <parameter>base</parameter>. + La base par d&eacute;faut est 10. Les valeurs possibles vont de 2 &agrave; 36. </para> <para> <example> - <title>Converting GMP number to string</title> + <title>Conversion d'un nombre GMP en cha&icirc;ne</title> <programlisting role="php"> &lt;?php $a = gmp_init("0x41682179fbf5"); - printf("Decimal: %s, 36-based: %s", gmp_strval($a), gmp_strval($a,36)); + printf("D&eacute;cimal: %s, base 36: %s", gmp_strval($a), gmp_strval($a,36)); ?> - </programlisting> - </example> + </programlisting> + </example> </para> </refsect1> </refentry> - <refentry id="function.gmp-add"> <refnamediv> <refname>gmp_add</refname> - <refpurpose>Add numbers</refpurpose> + <refpurpose>Addition de 2 nombres GMP</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -170,16 +169,15 @@ </funcprototype> </funcsynopsis> <para> - Add two GMP numbers. The result will be GMP number representing - the sum of the arguments. + <function>gmp_add</function> additionne les nombres GMP <parameter>a</parameter> + et <parameter>b</parameter>. Le r&eacute;sultat est un nombre GMP. </para> </refsect1> </refentry> - <refentry id="function.gmp-sub"> <refnamediv> <refname>gmp_sub</refname> - <refpurpose>Subtract numbers</refpurpose> + <refpurpose>Soustraction de 2 nombres GMP</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -191,16 +189,15 @@ </funcprototype> </funcsynopsis> <para> - Subtract <parameter>b</parameter> from <parameter>a</parameter> - and returns the result. + <function>gmp_sub</function> soustrait le nombre GMP <parameter>b</parameter> + de <parameter>a</parameter>. Le r&eacute;sultat est un nombre GMP. </para> </refsect1> </refentry> - <refentry id="function.gmp-mul"> <refnamediv> <refname>gmp_mul</refname> - <refpurpose>Multiply numbers</refpurpose> + <refpurpose>Multiplication de 2 nombres GMP</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -212,16 +209,15 @@ </funcprototype> </funcsynopsis> <para> - Multiplies <parameter>a</parameter> by <parameter>b</parameter> - and returns the result. + <function>gmp_mul</function> multiplie les nombres GMP <parameter>a</parameter> + et <parameter>b</parameter>. Le r&eacute;sultat est un nombre GMP. </para> </refsect1> </refentry> - <refentry id="function.gmp-div-q"> <refnamediv> <refname>gmp_div_q</refname> - <refpurpose>Divide numbers</refpurpose> + <refpurpose>Divisions de 2 nombres GMP</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -236,44 +232,43 @@ </funcprototype> </funcsynopsis> <para> - Divides <parameter>a</parameter> by <parameter>b</parameter> - and returns the integer result. The result rounding is defined by - the <parameter>round</parameter>, which can have the following - values: + <function>gmp_div_q</function> divise le nombre GMP <parameter>b</parameter> + par <parameter>a</parameter>. Le r&eacute;sultat est un entier. L'arrondi + du r&eacute;sultat est d&eacute;fini par <parameter>round</parameter>, qui peut prendre l'une + des valeurs suivantes : <itemizedlist> <listitem> <simpara> - <parameter>GMP_ROUND_ZERO</parameter>: The result is truncated -towards 0. + <parameter>GMP_ROUND_ZERO</parameter>: Le r&eacute;sultat est tronqu&eacute; vers 0. </simpara> </listitem> <listitem> <simpara> - <parameter>GMP_ROUND_PLUSINF</parameter>: The result is -rounded towards <literal>+infinity</literal>. + <parameter>GMP_ROUND_PLUSINF</parameter>: Le r&eacute;sultat est tronqu&eacute; vers + <literal>+infinity</literal> </simpara> </listitem> <listitem> <simpara> - <parameter>GMP_ROUND_MINUSINF</parameter>: The result is -rounded towards <literal>-infinity</literal>. + <parameter>GMP_ROUND_MINUSINF</parameter>: Le r&eacute;sultat est tronqu&eacute; vers + <literal>-infinity</literal> </simpara> </listitem> </itemizedlist> </para> <simpara> - This function can also be called as <function>gmp_div</function>. + <function>gmp_div_q</function> peut aussi &ecirc;tre appel&eacute;e + <function>gmp_div</function>. </simpara> <para> - See also <function>gmp_div_r</function>, <function>gmp_div_qr</function> + Voir aussi <function>gmp_div_r</function>, <function>gmp_div_qr</function>. </para> </refsect1> </refentry> - <refentry id="function.gmp-div-r"> <refnamediv> <refname>gmp_div_r</refname> - <refpurpose>Remainder of the division of numbers</refpurpose> + <refpurpose>Reste de la division de deux nombres GMP</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -288,24 +283,23 @@ </funcprototype> </funcsynopsis> <para> - Calculates remainder of the integer division of - <parameter>n</parameter> by <parameter>d</parameter>. The remainder - has the sign of the <parameter>n</parameter> argument, if not zero. + <function>gmp_div_r</function> le reste de la division enti&egrave;re + de <parameter>n</parameter> par <parameter>d</parameter>. Le reste + a le m&ecirc;me signe que <parameter>n</parameter>, s'il est non nul. </para> <para> - See the <function>gmp_div_q</function> function for description - of the <parameter>round</parameter> argument. + Voir <function>gmp_div_q</function> pour une description du parm&egrave;tre + <parameter>round</parameter>. </para> <para> - See also <function>gmp_div_q</function>, <function>gmp_div_qr</function> + Voir aussi <function>gmp_div_q</function>, <function>gmp_div_qr</function>. </para> </refsect1> </refentry> - <refentry id="function.gmp-div-qr"> <refnamediv> <refname>gmp_div_qr</refname> - <refpurpose>Divide numbers and get quotient and remainder</refpurpose> + <refpurpose>Divise deux nombres GMP</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -320,38 +314,36 @@ </funcprototype> </funcsynopsis> <para> - The function divides <parameter>n</parameter> by - <parameter>d</parameter> and returns array, with the first element being - <literal>[n/d]</literal> (the integer result of the - division) and the second being <literal>(n - [n/d] * d)</literal> - (the remainder of the division). + <function>gmp_div_qr</function> divise <parameter>n</parameter> par + <parameter>d</parameter> et retourne un tableau, dont le premier &eacute;l&eacute;ment + est <literal>[n/d]</literal> (le quotient entier de la division) et le + second est <literal>(n - [n/d] * d)</literal> (le reste). </para> <para> - See the <function>gmp_div_q</function> function for description - of the <parameter>round</parameter> argument. + Voir <function>gmp_div_q</function> pour une description du parm&egrave;tre + <parameter>round</parameter>. </para> <para> <example> - <title>Division of GMP numbers</title> + <title>Division de nombres GMP</title> <programlisting role="php"> &lt;?php $a = gmp_init("0x41682179fbf5"); $res = gmp_div_qr($a, "0xDEFE75"); - printf("Result is: q - %s, r - %s", gmp_strval($res[0]), gmp_strval($res[1])); + printf("Le r&eacute;sultat est: q - %s, r - %s", gmp_strval($res[0]), gmp_strval($res[1])); ?> </programlisting> </example> </para> <para> - See also <function>gmp_div_q</function>, <function>gmp_div_r</function>. + Voir aussi <function>gmp_div_q</function>, <function>gmp_div_r</function>. </para> </refsect1> </refentry> - <refentry id="function.gmp-div"> <refnamediv> <refname>gmp_div</refname> - <refpurpose>Divide numbers</refpurpose> + <refpurpose>Divise deux nombres GMP</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -363,15 +355,14 @@ </funcprototype> </funcsynopsis> <para> - This function is an alias to <function>gmp_div_q</function>. + <function>gmp_divexact</function> est un alias de <function>gmp_div_q</function>. </para> </refsect1> </refentry> - <refentry id="function.gmp-mod"> <refnamediv> <refname>gmp_mod</refname> - <refpurpose>Modulo operation</refpurpose> + <refpurpose>Modulo GMP</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -383,17 +374,16 @@ </funcprototype> </funcsynopsis> <para> - Calculates <parameter>n</parameter> modulo - <parameter>d</parameter>. The result is always non-negative, the - sign of <parameter>d</parameter> is ignored. + <function>gmp_mod</function> calcule <parameter>n</parameter> modulo + <parameter>d</parameter>. Le r&eacute;sultat est toujours positif ou nul, car + le signe de <parameter>d</parameter> est ignor&eacute;. </para> </refsect1> </refentry> - <refentry id="function.gmp-divexact"> <refnamediv> <refname>gmp_divexact</refname> - <refpurpose>Exact division of numbers</refpurpose> + <refpurpose>Division exacte de nombres GMP</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -405,18 +395,18 @@ </funcprototype> </funcsynopsis> <para> - Divides <parameter>n</parameter> by <parameter>d</parameter>, - using fast "exact division" algorithm. This function produces - correct results only when it is known in advance that - <parameter>d</parameter> divides <parameter>n</parameter>. + <function>gmp_divexact</function> divis <parameter>n</parameter> par + <parameter>d</parameter>, en utilisant les algorithmes de "division + exacte". Cette fonction ne fournit de r&eacute;sultats coh&eacute;rents que + s'il est su par avance que <parameter>d</parameter> divise + <parameter>n</parameter>. </para> </refsect1> </refentry> - <refentry id="function.gmp-cmp"> <refnamediv> <refname>gmp_cmp</refname> - <refpurpose>Compare numbers</refpurpose> + <refpurpose>Compare des nombres GMP</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -428,16 +418,16 @@ </funcprototype> </funcsynopsis> <para> - Returns positive value if <literal>a > b</literal>, zero if - <literal>a = b</literal> and negative value if <literal>a &lt; b</literal>. + <function>gmp_cmp</function> retourne une valeur positive si + <literal>a > b</literal>, z&eacute;ro si <literal>a = b</literal> et n&eacute;gative + si <literal>a &lt; b</literal>. </para> </refsect1> </refentry> - <refentry id="function.gmp-neg"> <refnamediv> <refname>gmp_neg</refname> - <refpurpose>Negate number</refpurpose> + <refpurpose>Oppos&eacute; de nombre GMP</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -448,15 +438,15 @@ </funcprototype> </funcsynopsis> <para> - Returns -<parameter>a</parameter>. + <function>gmp_neg</function> retourne l'oppos&eacute; de <function>gmp_neg</function><parameter>a</parameter> + (-<parameter>a</parameter>). </para> </refsect1> </refentry> - <refentry id="function.gmp-abs"> <refnamediv> <refname>gmp_abs</refname> - <refpurpose>Absolute value</refpurpose> + <refpurpose>Valeur absolue GMP</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -467,15 +457,15 @@ </funcprototype> </funcsynopsis> <para> - Returns absolute value of <parameter>a</parameter>. + <function>gmp_abs</function> retourne la valeur absolue de + <parameter>a</parameter>. </para> </refsect1> </refentry> - <refentry id="function.gmp-sign"> <refnamediv> <refname>gmp_sign</refname> - <refpurpose>Sign of number</refpurpose> + <refpurpose>Signe du nombre GMP</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -486,16 +476,15 @@ </funcprototype> </funcsynopsis> <para> - Return sign of <parameter>a</parameter> - 1 if - <parameter>a</parameter> is positive and -1 if it's negative. + <function>gmp_sign</function> retourne le signe de <parameter>a</parameter> : + 1 si <parameter>a</parameter> est positif et -1 s'il est n&eacute;gatif. </para> </refsect1> </refentry> - <refentry id="function.gmp-fact"> <refnamediv> <refname>gmp_fact</refname> - <refpurpose>Factorial</refpurpose> + <refpurpose>Factorielle GMP</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -506,15 +495,15 @@ </funcprototype> </funcsynopsis> <para> - Calculates factorial (<literal>a!</literal>) of <parameter>a</parameter>. + <function>gmp_fact</function> calcule la factorielle + de <parameter>a</parameter> : <literal>a!</literal>. </para> </refsect1> </refentry> - <refentry id="function.gmp-sqrt"> <refnamediv> <refname>gmp_sqrt</refname> - <refpurpose>Square root</refpurpose> + <refpurpose>Racine carr&eacute;e GMP</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -525,15 +514,15 @@ </funcprototype> </funcsynopsis> <para> - Calculates square root of <parameter>a</parameter>. + <function>gmp_sqrt</function> calcule la racine carr&eacute;e de + <parameter>a</parameter>. </para> </refsect1> </refentry> - <refentry id="function.gmp-sqrtrm"> <refnamediv> <refname>gmp_sqrtrm</refname> - <refpurpose>Square root with remainder</refpurpose> + <refpurpose>Racine carr&eacute;e avec reste GMP</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -544,18 +533,18 @@ </funcprototype> </funcsynopsis> <para> - Returns array where first element is the integer square root of - <parameter>a</parameter> (see also <function>gmp_sqrt</function>), and - the second is the remainder (i.e., the difference between - <parameter>a</parameter> and the first element squared). + <function>gmp_sqrtrm</function> retourne un tableau dont le + premier &eacute;l&eacute;ment est la racine carr&eacute;e enti&egrave;re de + <parameter>a</parameter> (voir aussi <function>gmp_sqrt</function>), et + le second est le reste de (i.e., la diff&eacute;rence entre + <parameter>a</parameter> et le carr&eacute; du premier &eacute;l&eacute;ment). </para> </refsect1> </refentry> - <refentry id="function.gmp-perfect-square"> <refnamediv> <refname>gmp_perfect_square</refname> - <refpurpose>Perfect square check</refpurpose> + <refpurpose>Carr&eacute; parfait GMP</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -566,20 +555,18 @@ </funcprototype> </funcsynopsis> <para> - Returns true if <parameter>a</parameter> is a prefect square, - false otherwise. + <function>gmp_perfect_square</function> retourn TRUE si + <parameter>a</parameter> est un carr&eacute; parfait, et FALSE sinon. </para> <para> - See also: <function>gmp_sqrt</function>, - <function>gmp_sqrtrm</function>. - </para> + Voir aussi : <function>gmp_sqrt</function>, <function>gmp_sqrtrm</function>. + </para> </refsect1> </refentry> - <refentry id="function.gmp-pow"> <refnamediv> <refname>gmp_pow</refname> - <refpurpose>Raise number into power</refpurpose> + <refpurpose>Puissance</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -591,17 +578,17 @@ </funcprototype> </funcsynopsis> <para> - Raise <parameter>base</parameter> into power - <parameter>exp</parameter>. The case of 0^0 yields - 1. <parameter>exp</parameter> cannot be negative. + <function>gmp_pow</function> &eacute;l&egrave;ve <parameter>base</parameter> &agrave; la + puissance <parameter>exp</parameter>. Dans le cas de 0^0, + <function>gmp_pow</function> retourne 1.<parameter>exp</parameter> + ne doit pas &ecirc;tre n&eacute;gatif. </para> </refsect1> </refentry> - <refentry id="function.gmp-powm"> <refnamediv> <refname>gmp_powm</refname> - <refpurpose>Raise number into power with modulo</refpurpose> + <refpurpose>Puissance et modulo</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -614,17 +601,17 @@ </funcprototype> </funcsynopsis> <para> - Calculate (<parameter>base</parameter> raised into power - <parameter>exp</parameter>) modulo <parameter>mod</parameter>. If - <parameter>exp</parameter> is negative, result is undefined. + <function>gmp_powm</function> calcule (<parameter>base</parameter> + puissnace <parameter>exp</parameter>) modulo <parameter>mod</parameter>. Si + <parameter>exp</parameter> est n&eacute;gatif, le r&eacute;sultat est + ind&eacute;fini. </para> </refsect1> </refentry> - <refentry id="function.gmp-prob-prime"> <refnamediv> <refname>gmp_prob_prime</refname> - <refpurpose>Check if number is "probably prime"</refpurpose> + <refpurpose>Nombre GMP probablement premier</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -636,23 +623,24 @@ </funcprototype> </funcsynopsis> <para> - If this function returns 0, <parameter>a</parameter> is definitely - not prime. If it returns 1, then <parameter>a</parameter> is - "probably" prime. If it returns 2, then <parameter>a</parameter> is - surely prime. Reasonable values of <parameter>reps</parameter> - vary from 5 to 10 (default being 10); a higher value lowers the - probability for a non-prime to pass as a "probable" prime. + Si <function>gmp_prob_prime</function> retourne 0, <parameter>a</parameter> + est d&eacute;fini comme non premier. Si <function>gmp_prob_prime</function> retourne + 1, alors <parameter>a</parameter> est "probablement" premier. + Si <function>gmp_prob_prime</function> retourne 2, alors + <parameter>a</parameter> est s&ucirc;rement premier. <parameter>reps</parameter> + peut raisonnablement varier de 5 &agrave; 10 (par d&eacute;faut, c'est 10); une valeur + sup&eacute;rieure r&eacute;duit la probabilit&eacute; qu'un nombre non premier soit + identifi&eacute; comme "probablement" premier. </para> <para> - The function uses Miller-Rabin's probabilistic test. + Cette focntion utilise le teste de probabilit&eacute; Miller-Rabin. </para> </refsect1> </refentry> - <refentry id="function.gmp-gcd"> <refnamediv> <refname>gmp_gcd</refname> - <refpurpose>Calculate GCD</refpurpose> + <refpurpose>PGCD</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -664,17 +652,17 @@ </funcprototype> </funcsynopsis> <para> - Calculate greatest common divisor of <parameter>a</parameter> and - <parameter>b</parameter>. The result is always positive even if - either of or both input operands are negative. + <function>gmp_gcd</function> calcule de PGCD (plus grand commun + diviseur) de <parameter>a</parameter> et <parameter>b</parameter>. + Le r&eacute;sultat est toujours positif, m&ecirc;me si l'un des deux (ou les deux) + nombres est n&eacute;gatif. </para> </refsect1> </refentry> - <refentry id="function.gmp-gcdext"> <refnamediv> <refname>gmp_gcdext</refname> - <refpurpose>Calculate GCD and multipliers</refpurpose> + <refpurpose>PGCD &eacute;tendu</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -686,17 +674,17 @@ </funcprototype> </funcsynopsis> <para> - Calculates g, s, and t, such that - <literal>a*s + b*t = g = gcd(a,b)</literal>, where gcd is gretest - common divisor. Returns array with respective elements g, s and t. + <function>gmp_gcdext</function> calcule les entiers g, s, et t, tels que + <literal>a*s + b*t = g = gcd(a,b)</literal>, o&ugrave; gcd est le pgcd de + <parameter>a</parameter> et <parameter>b</parameter>. La fonction + retourne un tableau avec les &eacute;l&eacute;ments g, s et t. </para> </refsect1> </refentry> - <refentry id="function.gmp-invert"> <refnamediv> <refname>gmp_invert</refname> - <refpurpose>Inverse by modulo</refpurpose> + <refpurpose>Inverse modulo</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -708,16 +696,15 @@ </funcprototype> </funcsynopsis> <para> - Computes the inverse of <parameter>a</parameter> modulo - <parameter>b</parameter>. Returns false if an inverse does not exist. + <function>gmp_invert</function> calcule l'invers de + <parameter>a</parameter> modulo <parameter>b</parameter>. Retourne FALSE si un tel inverse n'existe pas. </para> </refsect1> </refentry> - <refentry id="function.gmp-legendre"> <refnamediv> <refname>gmp_legendre</refname> - <refpurpose>Legendre symbol</refpurpose> + <refpurpose>Symbole de Legendre</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -729,19 +716,18 @@ </funcprototype> </funcsynopsis> <para> - Compute the + <function>gmp_legendre</function> calcule le <ulink url="http://www.utm.edu/research/primes/glossary/LegendreSymbol.html"> - Legendre symbol</ulink> of <parameter>a</parameter> and - <parameter>p</parameter>. <parameter>p</parameter> should be odd - and must be positive. + symbole de Legendre</ulink> de <parameter>a</parameter> et + <parameter>p</parameter>. <parameter>p</parameter> doit &ecirc;tre positif et + impair. </para> </refsect1> </refentry> - <refentry id="function.gmp-jacobi"> <refnamediv> <refname>gmp_jacobi</refname> - <refpurpose>Jacobi symbol</refpurpose> + <refpurpose>Symbole de Jacobi</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -753,20 +739,19 @@ </funcprototype> </funcsynopsis> <para> - Computes + <function>gmp_jacobi</function> calcule le <ulink url="http://www.utm.edu/research/primes/glossary/JacobiSymbol.html"> - Jacobi symbol</ulink> of <parameter>a</parameter> and - <parameter>p</parameter>. <parameter>p</parameter> should be odd - and must be positive. + symbole de Jacobi</ulink> de <parameter>a</parameter> et + <parameter>p</parameter>. <parameter>p</parameter> doit &ecirc;tre positif et + impair. </para> </refsect1> </refentry> - <refentry id="function.gmp-random"> <refnamediv> <refname>gmp_random</refname> - <refpurpose>Random number</refpurpose> + <refpurpose>Nombre GMP al&eacute;atoire</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -777,17 +762,17 @@ </funcprototype> </funcsynopsis> <para> - Generate a random number. The number will be up to - <parameter>limiter</parameter> words long. If - <parameter>limiter</parameter> is negative, negative numbers are generated. + <function>gmp_random</function> g&eacute;n&egrave;re un nombre al&eacute;toire. + Ce nombre est limit&eacute; par <parameter>limiter</parameter>. Si + <parameter>limiter</parameter> est n&eacute;gatif, un nombre n&eacute;gatif est + g&eacute;n&eacute;r&eacute;. </para> </refsect1> </refentry> - <refentry id="function.gmp-and"> <refnamediv> <refname>gmp_and</refname> - <refpurpose>Logical AND</refpurpose> + <refpurpose>ET logique</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -799,15 +784,15 @@ </funcprototype> </funcsynopsis> <para> - Calculates logical AND of two GMP numbers. + <function>gmp_and</function> calcule le ET logique de + <parameter>a</parameter> et <parameter>b</parameter>. </para> </refsect1> </refentry> - <refentry id="function.gmp-or"> <refnamediv> <refname>gmp_or</refname> - <refpurpose>Logical OR</refpurpose> + <refpurpose>OU logique</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -819,15 +804,15 @@ </funcprototype> </funcsynopsis> <para> - Calculates logical inclusive OR of two GMP numbers. + <function>gmp_or</function> calcule le OU logique de + <parameter>a</parameter> et <parameter>b</parameter>. </para> </refsect1> </refentry> - <refentry id="function.gmp-xor"> <refnamediv> <refname>gmp_xor</refname> - <refpurpose>Logical XOR</refpurpose> + <refpurpose>OU exclusif logique</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -839,15 +824,15 @@ </funcprototype> </funcsynopsis> <para> - Calculates logical exclusive OR (XOR) of two GMP numbers. + <function>gmp_or</function> calcule le OU exclusif logique de + <parameter>a</parameter> et <parameter>b</parameter>. </para> </refsect1> </refentry> - <refentry id="function.gmp-setbit"> <refnamediv> <refname>gmp_setbit</refname> - <refpurpose>Set bit</refpurpose> + <refpurpose>Modifie un bit</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -860,17 +845,16 @@ </funcprototype> </funcsynopsis> <para> - Sets bit <parameter>index</parameter> in - <parameter>a</parameter>. <parameter>set_clear</parameter> defines - if the bit is set to 0 or 1. By default the bit is set to 1. + <function>gmp_setbit</function> modifie le bit <parameter>index</parameter> + dans <parameter>a</parameter>. <parameter>set_clear</parameter> indique si + le bit est mis &agrave; 0 ou 1. Par d&eacute;faut, il est mis &agrave; 1. </para> </refsect1> </refentry> - <refentry id="function.gmp-clrbit"> <refnamediv> <refname>gmp_clrbit</refname> - <refpurpose>Clear bit</refpurpose> + <refpurpose>Annule un bit</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -882,16 +866,15 @@ </funcprototype> </funcsynopsis> <para> - Clears (sets to 0) bit <parameter>index</parameter> in - <parameter>a</parameter>. + <function>gmp_clrbit</function> met le bit <parameter>index</parameter> + &agrave; 0 dans le nombre GMP <parameter>a</parameter>. </para> </refsect1> </refentry> - <refentry id="function.gmp-scan0"> <refnamediv> <refname>gmp_scan0</refname> - <refpurpose>Scan for 0</refpurpose> + <refpurpose>Recherche 0</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -903,18 +886,17 @@ </funcprototype> </funcsynopsis> <para> - Scans <parameter>a</parameter>, starting with bit - <parameter>start</parameter>, towards more significant - bits, until the first clear bit is found. Returns the index of the - found bit. + <function>gmp_scan0</function> recherche dans <parameter>a</parameter>, + en commencant &agrave; la position <parameter>start</parameter>, vers les bits + de poids lourd, jusqu'&agrave; ce qu'elle rencontre un bit &agrave; 0. Sa position est + alors retourn&eacute;e. </para> </refsect1> </refentry> - <refentry id="function.gmp-scan1"> <refnamediv> <refname>gmp_scan1</refname> - <refpurpose>Scan for 1</refpurpose> + <refpurpose>Recherche 0</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -926,18 +908,17 @@ </funcprototype> </funcsynopsis> <para> - Scans <parameter>a</parameter>, starting with bit - <parameter>start</parameter>, towards more significant - bits, until the first set bit is found. Returns the index of the - found bit. + <function>gmp_scan1</function> recherche dans <parameter>a</parameter>, + en commencant &agrave; la position <parameter>start</parameter>, vers les bits + de poids lourd, jusqu'&agrave; ce qu'elle rencontre un bit &agrave; 1. Sa position est + alors retourn&eacute;e. </para> </refsect1> </refentry> - <refentry id="function.gmp-popcount"> <refnamediv> <refname>gmp_popcount</refname> - <refpurpose>Population count</refpurpose> + <refpurpose>Compte de population</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -948,15 +929,15 @@ </funcprototype> </funcsynopsis> <para> - Return the population count of <parameter>a</parameter>. + <function>gmp_popcount</function> d&eacute;nombre la population de + <parameter>a</parameter>. </para> </refsect1> </refentry> - <refentry id="function.gmp-hamdist"> <refnamediv> <refname>gmp_hamdist</refname> - <refpurpose>Hamming distance</refpurpose> + <refpurpose>Distance de Hamming</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -968,14 +949,13 @@ </funcprototype> </funcsynopsis> <para> - Returns the hamming distance between <parameter>a</parameter> and - <parameter>a</parameter>. Both operands should be non-negative. + <function>gmp_hamdist</function> retourne la distance de Hamming + entre <parameter>a</parameter> et <parameter>a</parameter>. Les deux + param&egrave;tres doivent &ecirc;tre strictement positif. </para> </refsect1> </refentry> - </reference> - <!-- Keep this comment at the end of the file Local variables: mode: sgml @@ -992,4 +972,3 @@ sgml-local-ecat-files:nil End: --> -
« previous php.doc (#969333165) next »