cortesi Tue Mar 26 08:00:14 2002 EDT
Modified files:
/phpdoc/it/functions gmp.xml
Log:
adding translation up to EN 1.25 by Mariano Calandra
Index: phpdoc/it/functions/gmp.xml
diff -u /dev/null phpdoc/it/functions/gmp.xml:1.4
--- /dev/null Tue Mar 26 08:00:14 2002
+++ phpdoc/it/functions/gmp.xml Tue Mar 26 08:00:13 2002
@@ -0,0 +1,966 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!-- EN-Revision: 1.25 Maintainer: calandra Status: ready -->
+ <reference id="ref.gmp">
+ <title>Funzioni GMP</title>
+ <titleabbrev>GMP</titleabbrev>
+ <partintro>
+ <simpara>
+ Queste funzioni permettono di lavorare con numeri interi
+ di lunghezza arbitraria usando le librerie GNU <acronym>MP</acronym>. In pratica
+per poter usufruire di
+ queste funzioni, bisogna installare il supporto
+ <acronym>GMP</acronym> usando la seguente opzione <option
+ role="configure">--with-gmp</option>.
+ </simpara>
+ <simpara>
+ Puoi scaricare la libreria <acronym>GMP</acronym> dal sito <ulink
+ url="&url.gmp;">&url.gmp;</ulink>. Dove � possibile anche scaricare il manuale
+ <acronym>GMP</acronym>.
+ </simpara>
+ <simpara>
+ Per usare queste funzioni � necessaria la versione 2
+ o superiore delle librerie GMP.
+ </simpara>
+ <simpara>
+ Queste funzioni sono state aggiunte in PHP 4.0.4.
+ </simpara>
+ <note>
+ <para>
+ Molte funzioni accettano argomenti numerici GMP, definiti come
+ <literal>risorse</literal>pi� in basso. Comunque, molte di queste funzioni
+accetteranno anche normali
+ argomenti numerici e stringhe, considerato ci� � quindi possibile convertire
+ queste ultime in numero. Inoltre, se c'� una funzione che pu� operare
+velocemente su
+ argomenti interi, questa potrebbe essere usata al posto della pi� lenta quando
+l'argomento
+ fornito � un intero.
+ Questo � fatto con chiarezza, cos� la logica vuole che tu possa utilizzare
+ numeri interi in ogni funzione che richieda un numero GMP.
+ Vedere anche la funzione <function>gmp_init</function>.
+ </para>
+ </note>
+
+ <warning>
+ <simpara>
+ Se desideri specificare un "large integer" come costante, scrivilo
+ tra virgolette come stringa. Se non lo fai, PHP interpreter� l'"integer literal"
+ immediatamente, con una possibile perdita di precisione,
+ ancora prima che la libreria <literal>GMP</literal>
+ venga richiamata.
+ </simpara>
+ </warning>
+
+ <para>
+ <example>
+ <title>Funzione fattoriale usando GMP</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+function fact ($x) {
+ if ($x <= 1)
+ return 1;
+ else
+ return gmp_mul ($x, fact ($x-1));
+}
+
+print gmp_strval (fact (1000)) . "\n";
+?>
+]]>
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ Questo calcoler� il fattoriale di 1000 (numero abbastanza grande)
+ molto velocemente.
+ </para>
+ </partintro>
+
+ <refentry id="function.gmp-init">
+ <refnamediv>
+ <refname>gmp_init</refname>
+ <refpurpose>Crea un numero GMP</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <methodsynopsis>
+ <type>resource</type><methodname>gmp_init</methodname>
+ <methodparam><type>mixed</type><parameter>number</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Crea un numero GMP partendo da un intero o da una stringa.
+ La stringa pu� essere decimale o esadecimale. Nell'ultimo caso,
+ la stringa dovrebbe iniziare con <literal>0x</literal>.
+ </para>
+ <para>
+ <example>
+ <title>Creare un numero GMP</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+ $a = gmp_init (123456);
+ $b = gmp_init ("0xFFFFDEBACDFEDF7200");
+?>
+]]>
+ </programlisting>
+ </example>
+ </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>.
+ </para>
+ </note>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.gmp-intval">
+ <refnamediv>
+ <refname>gmp_intval</refname>
+ <refpurpose>Converte un numero GMP in un intero</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <methodsynopsis>
+ <type>int</type><methodname>gmp_intval</methodname>
+ <methodparam><type>resource</type><parameter>gmpnumber</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Questa funzione converte un numero GMP in un intero.
+ <warning>
+ <simpara>
+ Questa funzione restituisce un risultato utile, solo se il numero attualmente
+ fornito al PHP � un intero (per esempio, un tipo signed long).
+ Se desideri solo stampare il numero GMP, usa <function>gmp_strval</function>.
+ </simpara>
+ </warning>
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.gmp-strval">
+ <refnamediv>
+ <refname>gmp_strval</refname>
+ <refpurpose>Converte un numero GMP in una stringa</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <methodsynopsis>
+ <type>string</type><methodname>gmp_strval</methodname>
+ <methodparam><type>resource</type><parameter>gmpnumber</parameter></methodparam>
+ <methodparam
+choice="opt"><type>int</type><parameter>base</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Converte un numero GMP in una stringa rappresentato in base
+ <parameter>base</parameter>. La base di default � 10. Le basi
+ consentite variano dal 2 al 36.
+ </para>
+ <para>
+ <example>
+ <title>Converte un numero GMP in una stringa</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+ $a = gmp_init("0x41682179fbf5");
+ printf ("Decimal: %s, 36-based: %s", gmp_strval($a), gmp_strval($a,36));
+?>
+]]>
+ </programlisting>
+ </example>
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.gmp-add">
+ <refnamediv>
+ <refname>gmp_add</refname>
+ <refpurpose>Somma di numeri</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <methodsynopsis>
+ <type>resource</type><methodname>gmp_add</methodname>
+ <methodparam><type>resource</type><parameter>a</parameter></methodparam>
+ <methodparam><type>resource</type><parameter>b</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Somma due numeri GMP. Il risultato, sar� un numero GMP
+ che rappresenta la somma degli argomenti.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.gmp-sub">
+ <refnamediv>
+ <refname>gmp_sub</refname>
+ <refpurpose>Sottrazione di numeri</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <methodsynopsis>
+ <type>resource</type><methodname>gmp_sub</methodname>
+ <methodparam><type>resource</type><parameter>a</parameter></methodparam>
+ <methodparam><type>resource</type><parameter>b</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Sottrae <parameter>b</parameter> da <parameter>a</parameter>
+ e restituisce il risultato.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.gmp-mul">
+ <refnamediv>
+ <refname>gmp_mul</refname>
+ <refpurpose>Prodotto di numeri</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <methodsynopsis>
+ <type>resource</type><methodname>gmp_mul</methodname>
+ <methodparam><type>resource</type><parameter>a</parameter></methodparam>
+ <methodparam><type>resource</type><parameter>b</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Moltiplica <parameter>a</parameter> per <parameter>b</parameter>
+ e restituisce il risultato.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.gmp-div-q">
+ <refnamediv>
+ <refname>gmp_div_q</refname>
+ <refpurpose>Divide due numberi</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <methodsynopsis>
+ <type>resource</type><methodname>gmp_div_q</methodname>
+ <methodparam><type>resource</type><parameter>a</parameter></methodparam>
+ <methodparam><type>resource</type><parameter>b</parameter></methodparam>
+ <methodparam
+choice="opt"><type>int</type><parameter>round</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Divide <parameter>a</parameter> per <parameter>b</parameter> e
+ restituisce un numero intero. L'arrotondamento del risultato, � definito dal
+ <parameter>round</parameter>, che pu� avere i seguenti
+ valori:
+ <itemizedlist>
+ <listitem>
+ <simpara>
+ <parameter>GMP_ROUND_ZERO</parameter>: Il risultato � troncato
+ verso 0.
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ <parameter>GMP_ROUND_PLUSINF</parameter>: Il risultato � arrotondato verso
+ <literal>+infinito</literal>.
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ <parameter>GMP_ROUND_MINUSINF</parameter>: Il risultato �
+ arrotondato verso <literal>-infinito</literal>.
+ </simpara>
+ </listitem>
+ </itemizedlist>
+ </para>
+ <simpara>
+ Questa funzione pu� anche essere richiamata come <function>gmp_div</function>.
+ </simpara>
+ <para>
+ Vedere anche <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>Resto di una divisione</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <methodsynopsis>
+ <type>resource</type><methodname>gmp_div_r</methodname>
+ <methodparam><type>resource</type><parameter>n</parameter></methodparam>
+ <methodparam><type>resource</type><parameter>d</parameter></methodparam>
+ <methodparam
+choice="opt"><type>int</type><parameter>round</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Calcola il resto di una divisione intera fra
+ <parameter>n</parameter> e <parameter>d</parameter>. Se non � zero, il resto ha
+il segno
+ dell'argomento <parameter>n</parameter>.
+ </para>
+ <para>
+ Vedi la funzione <function>gmp_div_q</function> per la descrizione
+dell'argomento
+ <parameter>round</parameter>.
+ </para>
+ <para>
+ Vedere anche <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 due numeri e restituisce quoziente e resto</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <methodsynopsis>
+ <type>array</type><methodname>gmp_div_qr</methodname>
+ <methodparam><type>resource</type><parameter>n</parameter></methodparam>
+ <methodparam><type>resource</type><parameter>d</parameter></methodparam>
+ <methodparam
+choice="opt"><type>int</type><parameter>round</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Questa funzione, esegue la divisione tra <parameter>n</parameter> e
+ <parameter>d</parameter> , restituendo un array, il primo elemento �,
+ <literal>[n/d]</literal> (il risultato intero della divisione)
+ il secondo � <literal>(n - [n/d] * d)</literal>
+ (cio� il resto della divisone).
+ </para>
+ <para>
+ Vedi la funzione <function>gmp_div_q</function> per la descrizione
+dell'argomento
+ <parameter>round</parameter>.
+ </para>
+ <para>
+ <example>
+ <title>Divisione di numeri GMP</title>
+ <programlisting role="php">
+<![CDATA[
+<?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]));
+?>
+]]>
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ Vedere anche <function>gmp_div_q</function>,
+ <function>gmp_div_r</function>.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.gmp-div">
+ <refnamediv>
+ <refname>gmp_div</refname>
+ <refpurpose>Divisione di numberi</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <methodsynopsis>
+ <type>resource</type><methodname>gmp_div</methodname>
+ <methodparam><type>resource</type><parameter>a</parameter></methodparam>
+ <methodparam><type>resource</type><parameter>b</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Questa funzione � la stessa di <function>gmp_div_q</function>.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.gmp-mod">
+ <refnamediv>
+ <refname>gmp_mod</refname>
+ <refpurpose>Modulo</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <methodsynopsis>
+ <type>resource</type><methodname>gmp_mod</methodname>
+ <methodparam><type>resource</type><parameter>n</parameter></methodparam>
+ <methodparam><type>resource</type><parameter>d</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Calcola il modulo di <parameter>n</parameter> rispetto a
+ <parameter>d</parameter>. Il risultato � sempre non-negativo, il segno di
+ <parameter>d</parameter> viene ignorato.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.gmp-divexact">
+ <refnamediv>
+ <refname>gmp_divexact</refname>
+ <refpurpose>Divisione intera di numeri</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <methodsynopsis>
+ <type>resource</type><methodname>gmp_divexact</methodname>
+ <methodparam><type>resource</type><parameter>n</parameter></methodparam>
+ <methodparam><type>resource</type><parameter>d</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Divide <parameter>n</parameter> per <parameter>d</parameter>,
+ usando un algoritmo di "esatta divisione". Questa funzione,
+ restituisce un valore corretto solo quando � noto a priori che
+ <parameter>d</parameter> divide <parameter>n</parameter>.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.gmp-cmp">
+ <refnamediv>
+ <refname>gmp_cmp</refname>
+ <refpurpose>Confronto di numeri</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <methodsynopsis>
+ <type>int</type><methodname>gmp_cmp</methodname>
+ <methodparam><type>resource</type><parameter>a</parameter></methodparam>
+ <methodparam><type>resource</type><parameter>b</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Restituisce un valore positivo se <literal>a > b</literal>, zero se
+ <literal>a = b</literal> e negativo se <literal>a <
+ b</literal>.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.gmp-neg">
+ <refnamediv>
+ <refname>gmp_neg</refname>
+ <refpurpose>Rende un numero negativo</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <methodsynopsis>
+ <type>resource</type><methodname>gmp_neg</methodname>
+ <methodparam><type>resource</type><parameter>a</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Restituisce <parameter>a</parameter>.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id='function.gmp-com'>
+ <refnamediv>
+ <refname>gmp_com</refname>
+ <refpurpose>Calcola il complemento a uno di 'a'</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <methodsynopsis>
+ <type>resource</type><methodname>gmp_com</methodname>
+ <methodparam><type>resource</type><parameter>a</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ &warn.undocumented.func;
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.gmp-abs">
+ <refnamediv>
+ <refname>gmp_abs</refname>
+ <refpurpose>Valore assoluto</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <methodsynopsis>
+ <type>resource</type><methodname>gmp_abs</methodname>
+ <methodparam><type>resource</type><parameter>a</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Restituisce il valore assoluto di <parameter>a</parameter>.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.gmp-sign">
+ <refnamediv>
+ <refname>gmp_sign</refname>
+ <refpurpose>Segno di un numero</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <methodsynopsis>
+ <type>int</type><methodname>gmp_sign</methodname>
+ <methodparam><type>resource</type><parameter>a</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Restituisce il segno di <parameter>a</parameter> : 1 se
+ <parameter>a</parameter> � positivo e -1 se � negativo.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.gmp-fact">
+ <refnamediv>
+ <refname>gmp_fact</refname>
+ <refpurpose>Fattoriale</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <methodsynopsis>
+ <type>resource</type><methodname>gmp_fact</methodname>
+ <methodparam><type>int</type><parameter>a</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Calcola il fattoriale (<literal>a!</literal>) di <parameter>a</parameter>.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.gmp-sqrt">
+ <refnamediv>
+ <refname>gmp_sqrt</refname>
+ <refpurpose>Radice quadrata</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <methodsynopsis>
+ <type>resource</type><methodname>gmp_sqrt</methodname>
+ <methodparam><type>resource</type><parameter>a</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Calcola la radice quadrata di <parameter>a</parameter>.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.gmp-sqrtrem">
+ <refnamediv>
+ <refname>gmp_sqrtrm</refname>
+ <refpurpose>Radice quadrata con resto</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <methodsynopsis>
+ <type>array</type><methodname>gmp_sqrtrm</methodname>
+ <methodparam><type>resource</type><parameter>a</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Restituisce un array con due valori, il primo � la radice quadrata (fornita come
+intero) di
+ <parameter>a</parameter> (vedere anche
+ <function>gmp_sqrt</function>), e il secondo � il resto (cio�, la differenza tra
+ <parameter>a</parameter> e il primo elemento al quadrato).
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.gmp-perfect-square">
+ <refnamediv>
+ <refname>gmp_perfect_square</refname>
+ <refpurpose>Controllo quadrato perfetto</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <methodsynopsis>
+ <type>bool</type><methodname>gmp_perfect_square</methodname>
+ <methodparam><type>resource</type><parameter>a</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Restituisce un valore vero &true; se <parameter>a</parameter> � un quadrato
+perfetto,falso
+ &false; se non lo �.
+ </para>
+ <para>
+ Vedere anche: <function>gmp_sqrt</function>,
+ <function>gmp_sqrtrm</function>.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.gmp-pow">
+ <refnamediv>
+ <refname>gmp_pow</refname>
+ <refpurpose>Eleva un numero a potenza</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <methodsynopsis>
+ <type>resource</type><methodname>gmp_pow</methodname>
+ <methodparam><type>resource</type><parameter>base</parameter></methodparam>
+ <methodparam><type>int</type><parameter>exp</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Eleva la base <parameter>base</parameter> ad una potenza
+ <parameter>exp</parameter>. Nel caso di 0^0 il risultato sar� 1. L'argomento
+ <parameter>exp</parameter> non pu� essere negativo.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.gmp-powm">
+ <refnamediv>
+ <refname>gmp_powm</refname>
+ <refpurpose>Modulo di un elevamento a potenza.</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <methodsynopsis>
+ <type>resource</type><methodname>gmp_powm</methodname>
+ <methodparam><type>resource</type><parameter>base</parameter></methodparam>
+ <methodparam><type>resource</type><parameter>exp</parameter></methodparam>
+ <methodparam><type>resource</type><parameter>mod</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Calcola il (<parameter>base</parameter> elevato a potenza
+ <parameter>exp</parameter>) modulo <parameter>mod</parameter>. Se
+ <parameter>exp</parameter> � negativo, il risultato sar� indefinito.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.gmp-prob-prime">
+ <refnamediv>
+ <refname>gmp_prob_prime</refname>
+ <refpurpose>Controlla se il numero � "probabilmente primo"</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <methodsynopsis>
+ <type>int</type><methodname>gmp_prob_prime</methodname>
+ <methodparam><type>resource</type><parameter>a</parameter></methodparam>
+ <methodparam
+choice="opt"><type>int</type><parameter>reps</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Se questa funzione da come risultato 0, <parameter>a</parameter> non � primo.
+ Se sar� 1, allora
+ <parameter>a</parameter> � "probabilmente" primo. Invece se il risultato � 2,
+allora
+ <parameter>a</parameter> sar� sicuramente primo. I valori "attendibili" di
+ <parameter>reps</parameter> possono variare da 5 a 10 (di default 10); un
+valore pi� alto fa diminuire
+ la probabilit� che un numero non primo passi come "probabile" primo.
+ </para>
+ <para>
+ La funzione usa il test probabilistico di Miller-Rabin.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.gmp-gcd">
+ <refnamediv>
+ <refname>gmp_gcd</refname>
+ <refpurpose>Calcola il MCD</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <methodsynopsis>
+ <type>resource</type><methodname>gmp_gcd</methodname>
+ <methodparam><type>resource</type><parameter>a</parameter></methodparam>
+ <methodparam><type>resource</type><parameter>b</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Calcola il massimo comune divisore (MCD) di <parameter>a</parameter> e
+ <parameter>b</parameter>. Il risultato � sempre positivo, anche
+ se uno o entrambi gli operatori sono negativi.
+
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.gmp-gcdext">
+ <refnamediv>
+ <refname>gmp_gcdext</refname>
+ <refpurpose>Calcola il MCD e moltiplicatori</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <methodsynopsis>
+ <type>array</type><methodname>gmp_gcdext</methodname>
+ <methodparam><type>resource</type><parameter>a</parameter></methodparam>
+ <methodparam><type>resource</type><parameter>b</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Calcola g, s e t, in questo modo <literal>a*s + b*t = g =
+ gcd(a,b)</literal>, dove MCD � il massimo comune divisore.
+ Restituisce un array con i rispettivi argomenti, cio�, g, s e t.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.gmp-invert">
+ <refnamediv>
+ <refname>gmp_invert</refname>
+ <refpurpose>Inversione di modulo</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <methodsynopsis>
+ <type>resource</type><methodname>gmp_invert</methodname>
+ <methodparam><type>resource</type><parameter>a</parameter></methodparam>
+ <methodparam><type>resource</type><parameter>b</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Calcola l'inverso di <parameter>a</parameter> modulo
+ <parameter>b</parameter>. Restituisce un valore &false; se l'inversione non
+ esiste.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.gmp-legendre">
+ <refnamediv>
+ <refname>gmp_legendre</refname>
+ <refpurpose>Simbolo di Legendre</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <methodsynopsis>
+ <type>int</type><methodname>gmp_legendre</methodname>
+ <methodparam><type>resource</type><parameter>a</parameter></methodparam>
+ <methodparam><type>resource</type><parameter>p</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Calcolo del
+ <ulink url="&url.symbole-legendre;">
+ Legendre symbol</ulink> di <parameter>a</parameter> e
+ <parameter>p</parameter>. <parameter>p</parameter> potrebbe essere
+ dispari e deve essere positivo.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.gmp-jacobi">
+ <refnamediv>
+ <refname>gmp_jacobi</refname>
+ <refpurpose>Simbolo di Jacobi</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <methodsynopsis>
+ <type>int</type><methodname>gmp_jacobi</methodname>
+ <methodparam><type>resource</type><parameter>a</parameter></methodparam>
+ <methodparam><type>resource</type><parameter>p</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Calcola il
+ <ulink url="http://www.utm.edu/research/primes/glossary/JacobiSymbol.html";>
+ simbolo di Jacobi </ulink> di <parameter>a</parameter> e
+ <parameter>p</parameter>. <parameter>p</parameter> p potrebbe essere dispari
+ e deve essere positivo.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.gmp-random">
+ <refnamediv>
+ <refname>gmp_random</refname>
+ <refpurpose>Generatore di numeri casuali</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <methodsynopsis>
+ <type>resource</type><methodname>gmp_random</methodname>
+ <methodparam><type>int</type><parameter>limiter</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Genera un numero casuale. Il numero, sar� lungo un numero di WORD (2 byte) non
+superiore all'argomento
+ <parameter>limiter</parameter>. Se l'argomento
+ <parameter>limiter</parameter> � negativo, il numero generato sar�
+ anch'esso negativo.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.gmp-and">
+ <refnamediv>
+ <refname>gmp_and</refname>
+ <refpurpose>AND logico</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <methodsynopsis>
+ <type>resource</type><methodname>gmp_and</methodname>
+ <methodparam><type>resource</type><parameter>a</parameter></methodparam>
+ <methodparam><type>resource</type><parameter>b</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Calcola l'AND logico di due numeri GMP.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.gmp-or">
+ <refnamediv>
+ <refname>gmp_or</refname>
+ <refpurpose>OR logico</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <methodsynopsis>
+ <type>resource</type><methodname>gmp_or</methodname>
+ <methodparam><type>resource</type><parameter>a</parameter></methodparam>
+ <methodparam><type>resource</type><parameter>b</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Calcola l'OR logico di due numeri GMP.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.gmp-xor">
+ <refnamediv>
+ <refname>gmp_xor</refname>
+ <refpurpose>XOR logico</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <methodsynopsis>
+ <type>resource</type><methodname>gmp_xor</methodname>
+ <methodparam><type>resource</type><parameter>a</parameter></methodparam>
+ <methodparam><type>resource</type><parameter>b</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Calcola l'OR logico esclusivo (XOR) di due numeri GMP.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.gmp-setbit">
+ <refnamediv>
+ <refname>gmp_setbit</refname>
+ <refpurpose>Imposta bit</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <methodsynopsis>
+ <type>resource</type><methodname>gmp_setbit</methodname>
+ <methodparam><type>resource</type><parameter>&a</parameter></methodparam>
+ <methodparam><type>int</type><parameter>index</parameter></methodparam>
+ <methodparam
+choice="opt"><type>bool</type><parameter>set_clear</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Sets bit <parameter>index</parameter> in
+ <parameter>a</parameter>. <parameter>set_clear</parameter>
+ definisce se il bit � settato su 0 o su 1. Di default il bit � settato a
+ 1.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.gmp-clrbit">
+ <refnamediv>
+ <refname>gmp_clrbit</refname>
+ <refpurpose>Pulisce bit</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <methodsynopsis>
+ <type>resource</type><methodname>gmp_clrbit</methodname>
+ <methodparam><type>resource</type><parameter>&a</parameter></methodparam>
+ <methodparam><type>int</type><parameter>index</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Ripulisce (imposta a 0) il bit <parameter>index</parameter> in
+ <parameter>a</parameter>.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.gmp-scan0">
+ <refnamediv>
+ <refname>gmp_scan0</refname>
+ <refpurpose>Ricerca per 0</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <methodsynopsis>
+ <type>int</type><methodname>gmp_scan0</methodname>
+ <methodparam><type>resource</type><parameter>a</parameter></methodparam>
+ <methodparam><type>int</type><parameter>start</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Cerca in <parameter>a</parameter>, partendo dal bit
+ <parameter>start</parameter>verso i bit pi� significativi,
+ fermandosi sul primo bit nullo, di cui
+ restituisce l'indice.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.gmp-scan1">
+ <refnamediv>
+ <refname>gmp_scan1</refname>
+ <refpurpose>Ricerca per 1</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <methodsynopsis>
+ <type>int</type><methodname>gmp_scan1</methodname>
+ <methodparam><type>resource</type><parameter>a</parameter></methodparam>
+ <methodparam><type>int</type><parameter>start</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Cerca in <parameter>a</parameter>, partendo dal bit
+ <parameter>start</parameter>, verso i bit pi� significativi,
+ fermandosi sul primo bit nullo, di cui
+ restituisce l'indice.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.gmp-popcount">
+ <refnamediv>
+ <refname>gmp_popcount</refname>
+ <refpurpose>Conteggio della popolazione</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <methodsynopsis>
+ <type>int</type><methodname>gmp_popcount</methodname>
+ <methodparam><type>resource</type><parameter>a</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Restituisce il conteggio della popolazione di <parameter>a</parameter>.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.gmp-hamdist">
+ <refnamediv>
+ <refname>gmp_hamdist</refname>
+ <refpurpose>Distanza dell'hamming</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <methodsynopsis>
+ <type>int</type><methodname>gmp_hamdist</methodname>
+ <methodparam><type>resource</type><parameter>a</parameter></methodparam>
+ <methodparam><type>resource</type><parameter>b</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Restituisce la distanza di hamming tra <parameter>a</parameter> e
+ <parameter>b</parameter>. Entrambe gli operandi dovrebbero essere non-negativi.
+ </para>
+ </refsect1>
+ </refentry>
+
+ </reference>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"../../manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
