cortesi Thu Nov 15 04:40:18 2001 EDT
Modified files:
/phpdoc/it/functions math.xml
Log:
in sync with EN tree
Index: phpdoc/it/functions/math.xml
diff -u phpdoc/it/functions/math.xml:1.15 phpdoc/it/functions/math.xml:1.16
--- phpdoc/it/functions/math.xml:1.15 Sat Nov 10 16:50:02 2001
+++ phpdoc/it/functions/math.xml Thu Nov 15 04:40:17 2001
@@ -1,6 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- EN-Revision: 1.38 Maintainer: cortesi Status: ready -->
-
+<!-- EN-Revision: 1.58 Maintainer: cortesi Status: ready -->
<reference id="ref.math">
<title>Funzioni Matematiche</title>
<titleabbrev>Mat</titleabbrev>
@@ -9,14 +8,17 @@
<sect1 id="math.intro">
<title>Introduzione</title>
<para>
- Queste funzioni matematiche operano esclusivamente nel range dei tipi di dato
"long"
- e "double" del singolo computer. Se si ha necessità di lavorare con numeri più
- grandi, fare riferimento alle <link linkend="ref.bc">funzioni matematiche a
precisione arbitraria</link>.
+ Queste funzioni matematiche operano esclusivamente nel range
+ dei tipi di dato <type>integer</type> e <type>float</type> del computer.
+ (questo corrisponde attualmente ai tipi di dati long e double del C)
+ Se si ha necessità di lavorare con numeri più grandi, fare
+riferimento alle
+ <link linkend="ref.bc">funzioni matematiche a precisione arbitraria</link>.
</para>
<sect2 id="math.constants">
<title>Costanti Matematiche</title>
<para>
- I seguenti valori sono definiti come costanti nel PHP dall'estensione
matematica del linguaggio:
+ I seguenti valori sono definiti come costanti nel PHP dall'estensione
+ matematica del linguaggio:
<table>
<title>Costanti Matematiche</title>
<tgroup cols="3">
@@ -116,8 +118,9 @@
</tbody>
</tgroup>
</table>
- Soltanto M_PI è disponibile nelle versioni precedenti alla PHP4RC1 (compresa).
- Tutte le rimanenti costanti sono disponibili a partire dalla versione PHP 4.0.
+ Soltanto M_PI è disponibile nelle versioni precedenti alla PHP4RC1
+(compresa).
+ Tutte le rimanenti costanti sono disponibili a partire dal PHP 4.0. Le costanti
+ indicate con [4.0.2] sono state aggiunte nel PHP 4.0.2.
</para>
</sect2>
</sect1>
@@ -138,7 +141,10 @@
</funcsynopsis>
<para>
Restituisce il valore assoluto di un numero. Se l'argomento della funzione
- è float, il valore restituito è anch'esso float, negli altri casi restituisce un
int.</para>
+ è di tipo <type>float</type>, il valore restituito è
+<type>float</type>,
+ altrimenti restituisce un <type>integer</type> (perché <type>float</type>
+di solito ha un range di
+ valori più grande di <type>integer</type>).
+ </para>
</refsect1>
</refentry>
@@ -156,14 +162,40 @@
</funcprototype>
</funcsynopsis>
<para>
- Restituisce l'arco coseno di arg in radianti.</para>
-
+ Restituisce l'arco coseno di <parameter>arg</parameter> in radianti.
+ </para>
<para>
- Vedere anche <function>asin</function> e <function>atan</function>.</para>
-
+ Vedere anche <parameter>arg</parameter>, <function>asin</function>
+ e <function>atan</function>.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.acosh">
+ <refnamediv>
+ <refname>acosh</refname>
+ <refpurpose>Inverso del coseno iperbolico</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>float <function>acosh</function></funcdef>
+ <paramdef>float <parameter>arg</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Restituisce l'inverso del coseno iperbolico
+ di <parameter>arg</parameter>, cioè il valore
+ il cui coseno iperbolico vale <parameter>arg</parameter>.
+ </para>
+ ¬e.no-windows;
+ <para>
+ Vedere anche <function>acos</function>, <function>asin</function>
+ e <function>atan</function>.
+ </para>
</refsect1>
</refentry>
-
<refentry id="function.asin">
<refnamediv>
@@ -179,19 +211,45 @@
</funcprototype>
</funcsynopsis>
<para>
- Restituisce l'arco seno di arg in radianti.</para>
-
+ Restituisce l'arco seno di arg in radianti.
+ </para>
<para>
- Vedere anche <function>acos</function> e <function>atan</function>.</para>
-
+ Vedere anche <function>asinh</function>, <function>acos</function>
+ e <function>atan</function>.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.asinh">
+ <refnamediv>
+ <refname>asinh</refname>
+ <refpurpose>Inverso del seno iperbolico</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>float <function>asinh</function></funcdef>
+ <paramdef>float <parameter>arg</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Restituisce l'inverso del seno iperbolico
+ di <parameter>arg</parameter>, cioè il valore
+ il cui seno iperbolico vale <parameter>arg</parameter>
+ </para>
+ ¬e.no-windows;
+ <para>
+ vedere anche <function>asin</function>, <function>acos</function>
+ e <function>atan</function>.
+ </para>
</refsect1>
</refentry>
-
<refentry id="function.atan">
<refnamediv>
<refname>atan</refname>
- <refpurpose>arco tangente</refpurpose>
+ <refpurpose>Arco tangente</refpurpose>
</refnamediv>
<refsect1>
<title>Descrizione</title>
@@ -202,15 +260,41 @@
</funcprototype>
</funcsynopsis>
<para>
- Restituisce l'arco tangente di arg in radianti.</para>
-
+ Restituisce l'arco tangente di arg in radianti.
+ </para>
<para>
- Vedere anche <function>asin</function> e <function>acos</function>.</para>
-
+ Vedere anche <function>atanh</function>, <function>asin</function>
+ e <function>acos</function>.
+ </para>
</refsect1>
</refentry>
-
+<refentry id="function.atanh">
+ <refnamediv>
+ <refname>atanh</refname>
+ <refpurpose>Inverso della tangente iperbolica</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>float <function>atanh</function></funcdef>
+ <paramdef>float <parameter>arg</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Restituisce l'inverso della tangente iperbolica di
+ <parameter>arg</parameter>, cioè il valore
+ la cui tangente iperbolica vale <parameter>arg</parameter>.
+ </para>
+ ¬e.no-windows;
+ <para>
+ See also <function>atan</function>, <function>asin</function>
+ e <function>acos</function>.
+ </para>
+ </refsect1>
+ </refentry>
+
<refentry id="function.atan2">
<refnamediv>
<refname>atan2</refname>
@@ -226,12 +310,16 @@
</funcprototype>
</funcsynopsis>
<simpara>
- Questa funzione calcola l'arco tangente delle due variabili x e y. E' simile al
calcolo dell'arco
- tangente di <parameter>y</parameter> / <parameter>x</parameter>, eccetto per il
fatto che viene tenuto in considearazione il segno di entrambi
+ Questa funzione calcola l'arco tangente delle due variabili
+ <parameter>x</parameter> e <parameter>y</parameter>. È
+ simile al calcolo dell'arco tangente di
+ <parameter>y</parameter> / <parameter>x</parameter>, eccetto per il
+ fatto che viene tenuto in considearazione il segno di entrambi
gli argomenti per determinare il quadrante del risultato.
</simpara>
<simpara>
- La funzione restituisce il risultato in radianti, compreso fra -PI e PI
(inclusi).
+ La funzione restituisce il risultato in radianti, compreso fra
+ -PI e PI (inclusi).
</simpara>
<para>
Vedere anche <function>acos</function> e <function>atan</function>.
@@ -239,7 +327,6 @@
</refsect1>
</refentry>
-
<refentry id="function.base-convert">
<refnamediv>
<refname>base_convert</refname>
@@ -258,16 +345,16 @@
<para>
Restituisce una stringa contenente <parameter>numero</parameter>
rappresentata in base <parameter>base_di_arrivo</parameter>. La base in
- cui <parameter>numero</parameter> è dato è specificata in
- <parameter>base_di_partenza</parameter>. Entrambe
+ cui <parameter>numero</parameter> è dato è specificata da
+ <parameter>base_di_partenza</parameter>. Entrambe
<parameter>base_di_partenza</parameter> e <parameter>base_di_arrivo</parameter>
devono essere comprese fra 2 e 36, inclusi. Cifre in numeri con una
base maggiore di 10 saranno rappresentati con le lettere a-z,
con a significante 10, b significante 11 e z significante 35.
<example>
- <title>base_convert()</title>
+ <title><function>base_convert</function></title>
<programlisting role="php">
-$binary = base_convert ($hexadecimal, 16, 2);
+$binario = base_convert ($esadecimale, 16, 2);
</programlisting>
</example>
</para>
@@ -277,7 +364,7 @@
<refentry id="function.bindec">
<refnamediv>
- <refname>BinDec</refname>
+ <refname>bindec</refname>
<refpurpose>Da binario a decimale</refpurpose>
</refnamediv>
<refsect1>
@@ -294,16 +381,16 @@
</para>
<para>
<function>bindec</function> converte un binario in
- <type>intero</type>. Il più grande numero che può
+ <type>integer</type>. Il più grande numero che può
essere convertito è 31 volte la cifra 1 oppure 2147483647 espresso in
formato decimale.
</para>
<para>
- Vedere anche la funzione <function>decbin</function>.
+ Vedere anche la funzione
+ <function>decbin</function>.
</para>
</refsect1>
</refentry>
-
<refentry id="function.ceil">
<refnamediv>
<refname>ceil</refname>
@@ -318,7 +405,7 @@
</funcprototype>
</funcsynopsis>
<simpara>
- Restituisce il primo intero più grande di
+ Restituisce il primo intero più grande di
<parameter>numero</parameter>, se necessario.
Il valore restituito da <function>ceil</function> è ancora di tipo
<type>float</type>, poiché la gamma di valori del tipo <type>float</type>
è
@@ -347,18 +434,39 @@
<para>
Restituisce il coseno di arg in radianti.
</para>
-
<para>
Vedere anche <function>sin</function> e <function>tan</function>.
</para>
-
</refsect1>
</refentry>
+ <refentry id="function.cosh">
+ <refnamediv>
+ <refname>cosh</refname>
+ <refpurpose>Coseno iperbolico</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>float <function>cosh</function></funcdef>
+ <paramdef>float <parameter>arg</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Restituisce il coseno iperbolico di <parameter>arg</parameter>,
+ definito come <literal>(exp(arg) + exp(-arg))/2</literal>.
+ </para>
+ <para>
+ Vedere anche <function>cos</function>, <function>acosh</function>,
+ <function>sin</function> and <function>tan</function>.
+ </para>
+ </refsect1>
+ </refentry>
<refentry id="function.decbin">
<refnamediv>
- <refname>DecBin</refname>
+ <refname>decbin</refname>
<refpurpose>Da decimale a binario</refpurpose>
</refnamediv>
<refsect1>
@@ -371,21 +479,18 @@
</funcsynopsis>
<para>
Restituisce una stringa contenente una rappresentazione binaria di un dato
- argomento <parameter>numero</parameter>. Il più grande numero che può essere
convertito è
+ argomento <parameter>numero</parameter>. Il più grande numero che
+può essere convertito è
2147483647 in decimale risultante in una stringa composta da 31 volte la cifra 1.
</para>
-
<para>
Vedere anche la funzione <function>bindec</function>.
</para>
-
</refsect1>
</refentry>
-
<refentry id="function.dechex">
<refnamediv>
- <refname>DecHex</refname>
+ <refname>dechex</refname>
<refpurpose>Da decimale a esadecimale</refpurpose>
</refnamediv>
<refsect1>
@@ -398,21 +503,18 @@
</funcsynopsis>
<para>
Restituisce una stringa contenente una rappresentazione esadecimale di un dato
- argomento <parameter>numero</parameter>. Il più grande numero che può essere
- convertito è 2147483647 in decimale risultante in "7fffffff".
+ argomento <parameter>numero</parameter>. Il più grande numero che
+puù essere
+ convertito è 2147483647 in decimale risultante in "7fffffff".
</para>
-
<para>
Vedere anche la funzione <function>hexdec</function>.
</para>
-
</refsect1>
</refentry>
-
<refentry id="function.decoct">
<refnamediv>
- <refname>DecOct</refname>
+ <refname>decoct</refname>
<refpurpose>Da decimale a ottale</refpurpose>
</refnamediv>
<refsect1>
@@ -425,14 +527,15 @@
</funcsynopsis>
<para>
Restituisce una stringa contenente una rappresentazione in ottale di un dato
- argomento <parameter>numero</parameter>. Il più grande numero che può essere
convertito è
+ argomento <parameter>numero</parameter>. Il più grande numero che
+può essere convertito è
2147483647 in decimale risultante in "17777777777". Vedere anche
<function>octdec</function>.
</para>
-
+ <para>
+ Vedere anche <function>octdec</function>.
+ </para>
</refsect1>
</refentry>
-
<refentry id="function.deg2rad">
<refnamediv>
<refname>deg2rad</refname>
@@ -449,7 +552,8 @@
</funcprototype>
</funcsynopsis>
<para>
- Questa funzione converte <parameter>numero</parameter> da gradi al valore
equivalente espresso in radianti.
+ Questa funzione converte <parameter>numero</parameter> da gradi
+ al valore equivalente espresso in radianti.
</para>
<para>
Vedere anche <function>rad2deg</function>.
@@ -457,7 +561,6 @@
</refsect1>
</refentry>
-
<refentry id="function.exp">
<refnamediv>
<refname>exp</refname>
@@ -474,19 +577,16 @@
<para>
Restituisce e elevato alla potenza di <parameter>arg</parameter>.
</para>
-
<para>
Vedere anche <function>pow</function>.
</para>
-
</refsect1>
</refentry>
-
<refentry id="function.floor">
<refnamediv>
<refname>floor</refname>
- <refpurpose>arrotonda le frazioni all'intero inferiore</refpurpose>
+ <refpurpose>Arrotonda le frazioni all'intero inferiore</refpurpose>
</refnamediv>
<refsect1>
<title>Descrizione</title>
@@ -497,52 +597,47 @@
</funcprototype>
</funcsynopsis>
<simpara>
- Restituisce il primo intero più piccolo di
+ Restituisce il primo intero più piccolo di
<parameter>numero</parameter>, se necessario.
Il valore restituito da <function>floor</function> è ancora di tipo
<type>float</type>, poiché la gamma di valori del tipo <type>float</type>
è
solitamente più grande di quella del tipo <type>int</type>.
</simpara>
<simpara>
- Vedere anche <function>ceil</function> e <function>round</function>.
+ Vedere anche <function>ceil</function>
+ e <function>round</function>.
</simpara>
</refsect1>
</refentry>
-
<refentry id="function.getrandmax">
<refnamediv>
<refname>getrandmax</refname>
- <refpurpose>mostra il più grande numero casuale disponibile</refpurpose>
+ <refpurpose>Mostra il più grande numero casuale disponibile</refpurpose>
</refnamediv>
<refsect1>
<title>Descrizione</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>getrandmax</function></funcdef>
- <paramdef>void </paramdef>
+ <void/>
</funcprototype>
</funcsynopsis>
-
<simpara>
- Restituisce il valore massimo che può essere restituito da una chiamata alla
+ Restituisce il valore massimo che può essere restituito da una chiamata
+alla
funzione <function>rand</function>.
</simpara>
-
<simpara>
- Vedere anche <function>rand</function>,
- <function>srand</function>
- <function>mt_rand</function>,
- <function>mt_srand</function> e
+ Vedere anche <function>rand</function>, <function>srand</function>
+ <function>mt_rand</function>, <function>mt_srand</function> e
<function>mt_getrandmax</function>.
</simpara>
</refsect1>
</refentry>
-
<refentry id="function.hexdec">
<refnamediv>
- <refname>HexDec</refname>
+ <refname>hexdec</refname>
<refpurpose>Da esadecimale a decimale</refpurpose>
</refnamediv>
<refsect1>
@@ -556,8 +651,8 @@
<para>
Restituisce l'equivalente decimale di un numero esadecimale rappresentato
dall'argomento stringa_esadecimale. <function>hexdec</function> converte una
- stringa esadecimale in un numero decimale. Il più grande numero che può
- essere convertito è 7fffffff o 2147483647 espresso in decimale.
+ stringa esadecimale in un numero decimale. Il più grande numero che
+può
+ essere convertito è 7fffffff o 2147483647 espresso in decimale.
</para>
<para>
<function>hexdec</function> sostituisce ogni carattere non esadecimale
@@ -591,8 +686,8 @@
<title>Descriztione</title>
<funcsynopsis>
<funcprototype>
- <funcdef>double <function>lcg_value</function></funcdef>
- <paramdef>void</paramdef>
+ <funcdef>float <function>lcg_value</function></funcdef>
+ <void/>
</funcprototype>
</funcsynopsis>
<para>
@@ -620,11 +715,9 @@
<para>
Restituisce il logaritmo naturale di arg.
</para>
-
</refsect1>
</refentry>
-
<refentry id="function.log10">
<refnamediv>
<refname>log10</refname>
@@ -661,20 +754,20 @@
</funcsynopsis>
<para>
<function>max</function> restituisce il numericamente più grande dei
- valori dati come parametri.
+ valori dati come parametro.
</para>
<para>
- Se il primo parametro è un array, <function>max</function>
+ Se il primo parametro è un array, <function>max</function>
restituisce il massimo dei valori di tale array. Se il primo parametro
è un integer, string o double, si ha bisogno almeno di due parametri
e <function>max</function> restituisce il maggiore di tali valori.
Si può confrontare un numero illimitato di valori.
</para>
<para>
- Se uno o più valori sono double, tutti i valori saranno
- considerati come double, e verrà restituito un double. Se nessuno dei
+ Se uno o più valori sono float, tutti i valori saranno
+ considerati come float, e verrà restituito un float. Se nessuno dei
valori è double, tutti verranno considerati come integer, e
- verrà restituito un integer.
+ verrà restituito un integer.
</para>
</refsect1>
</refentry>
@@ -693,23 +786,30 @@
<paramdef>mixed <parameter>arg2</parameter></paramdef>
<paramdef>mixed <parameter>argn</parameter></paramdef>
</funcprototype>
+ <funcprototype>
+ <funcdef>number <function>min</function></funcdef>
+ <paramdef>array <parameter>numeri</parameter></paramdef>
+ </funcprototype>
</funcsynopsis>
<para>
- <function>min</function> restituisce il numericamente più piccolo dei valori
dati come
- parametro.
+ <function>min</function> restituisce il numericamente più
+ piccolo dei valori dati come parametro.
</para>
<para>
- Se il primo parametro è un array, <function>min</function>
- restituisce il minimo dei valori di tale array. Se il primo parametro
- è un integer, string o double, si ha bisogno almeno di due parametri
- e <function>min</function> restituisce il minore di tali valori.
- Si può confrontare un numero illimitato di valori.
+ Nella prima variante, si ha bisogno di almeno due parametri
+ e <function>min</function> restituisce il minimo fra i valori.
+ Si può confrontare un numero illimitato di valori.
+ </para>
+ <para>
+ Nella seconda variante, <function>min</function>
+ restituisce il più piccolo valore in <parameter>numeri</parameter>.
</para>
<para>
- Se uno o più valori sono double, tutti i valori saranno
- considerati come double, e verrà restituito un double. Se nessuno dei
- valori è double, tutti verranno considerati come integer, e
- verrà restituito un integer.
+ Se uno o più valori sono <type>float</type>, tutti i valori
+ saranno
+ considerati come float, e verrà restituito un float. Se nessuno dei
+ valori è float, tutti verranno considerati come <type>integer</type>, e
+ verrà restituito un integer.
</para>
</refsect1>
</refentry>
@@ -724,11 +824,15 @@
<funcsynopsis>
<funcprototype>
<funcdef>int <function>mt_rand</function></funcdef>
+ <void/>
+ </funcprototype>
+ <funcprototype>
+ <funcdef>int <function>mt_rand</function></funcdef>
<paramdef>int
- <parameter><optional>min</optional></parameter>
+ <parameter>min</parameter>
</paramdef>
<paramdef>int
- <parameter><optional>max</optional></parameter>
+ <parameter>max</parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
@@ -736,15 +840,17 @@
Molti generatori di numeri casuali di vecchie libc hanno caratteristiche
dubbie o sconosciute e sono lenti. Di default, PHP usa il
generatore di numeri casuali libc con la funzione <function>rand</function>.
- La funzione <function>mt_rand</function> è un sostituto
+ La funzione <function>mt_rand</function> è un sostituto
per questa. Usa un generatore di numeri casuali con
caratteristiche conosciute, il Mersenne Twister, che assicura
numeri casuali che dovrebbero essere adatti per scopi crittografici
- e che è mediamente quattro volte più veloce di libc. L'Homepage
- del Mersenne Twister può essere trovata qui: <ulink
- url="&url.mersenne;">&url.mersenne;</ulink>, e una versione ottimizzata
- del codice sorgente di MT è disponibile a questo inidrizzo: <ulink
- url="&url.mersenne.twister;">&url.mersenne.twister;</ulink>.
+ e (vedere la homepage per i dettagli) e che è mediamente quattro
+ volte più veloce di libc. L'Homepage
+ del Mersenne Twister può essere trovata
+ qui: <ulink url="&url.mersenne;">&url.mersenne;</ulink>, e una
+ versione ottimizzata del codice sorgente di MT è disponibile
+ a questo inidrizzo: <ulink url="&url.mersenne.twister;">&url.mersenne.twister;
+ </ulink>.
</simpara>
<simpara>
Se invocata senza i parametri opzionali <parameter>min</parameter>,
@@ -764,7 +870,7 @@
<parameter>max</parameter> era <parameter>range</parameter>. Per
ottenere lo stesso risultato in queste vecchie versioni un breve
esempio dovrebbe essere il seguente: <literal>mt_rand (5, 11)</literal>, si
- otterrà un numero casuale compreso fra 5 e 15.
+ otterrà un numero casuale compreso fra 5 e 15.
</para>
</note>
<simpara>
@@ -792,9 +898,13 @@
Inizializza il generatore di numeri casuali con il parametro
<parameter>seme</parameter>.
<informalexample>
- <programlisting>
-// inizializza usando i microsecondi passati dall'ultimo secondo "intero"
-mt_srand((double)microtime()*1000000);
+ <programlisting role="php">
+// inizializza usando i microsecondi
+function crea_seme() {
+ list($usec, $sec) = explode(' ', microtime());
+ return (float) $sec + ((float) $usec * 100000);
+}
+mt_srand(crea_seme());
$valorecasuale = mt_rand();
</programlisting>
</informalexample>
@@ -818,11 +928,11 @@
<funcsynopsis>
<funcprototype>
<funcdef>int <function>mt_getrandmax</function></funcdef>
- <paramdef>void </paramdef>
+ <void/>
</funcprototype>
</funcsynopsis>
<simpara>
- Restituisce il massimo valore che può essere restituito da una chiamata alla
funzione
+ Restituisce il massimo valore che può essere restituito da una chiamata
+alla funzione
<function>mt_rand</function>.
</simpara>
<simpara>
@@ -845,29 +955,29 @@
<funcprototype>
<funcdef>string <function>number_format</function></funcdef>
<paramdef>float <parameter>numero</parameter></paramdef>
- <paramdef>int <parameter>decimali</parameter></paramdef>
- <paramdef>string <parameter>separatore_decimali</parameter></paramdef>
- <paramdef>string <parameter>separatore_migliaia</parameter></paramdef>
+ <paramdef>int <parameter><optional>decimali</optional></parameter></paramdef>
+ <paramdef>string
+<parameter><optional>separatore_decimali</optional></parameter></paramdef>
+ <paramdef>string
+<parameter><optional>separatore_migliaia</optional></parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
<function>number_format</function> restituisce una versione formattata di
- <parameter>numero</parameter>. Questa funzione accetta uno,
+ <parameter>numero</parameter>. Questa funzione accetta uno,
due o quattro parametri (non tre):
</para>
<para>Se viene dato un solo parametro,
- <parameter>numero</parameter> sarà formattato senza decimali,
+ <parameter>numero</parameter> sarà formattato senza decimali,
ma con una virgola (",") fra ogni gruppo di migliaia.
</para>
<para>
- Se vengono dati due parametri, <parameter>numero</parameter> sarà
+ Se vengono dati due parametri, <parameter>numero</parameter> sarà
formattato con <parameter>decimali</parameter> decimali con un
punto (".") davanti, e una virgola (",") fra ciascun gruppo di
migliaia.
</para>
<para>
Se vengono dati tutti e quattro i parametri, <parameter>numero</parameter>
- sarà formattato con <parameter>decimali</parameter> decimali,
+ sarà formattato con <parameter>decimali</parameter> decimali,
<parameter>separatore_decimali</parameter> invece di un punto (".") prima
dei decimali e <parameter>separatore_migliaia</parameter> invece di
una virgola (",") fra ciascun gruppo di migliaia.
@@ -924,7 +1034,7 @@
<refentry id="function.octdec">
<refnamediv>
- <refname>OctDec</refname>
+ <refname>octdec</refname>
<refpurpose>Da ottale a decimale</refpurpose>
</refnamediv>
<refsect1>
@@ -938,7 +1048,7 @@
<para>
Restituisce l'equivalente decimale del numero ottale
rappresentato dall'argomento stringa_ottale.
- OctDec converte una stringa ottale in un numero decimale. Il più grande
+ OctDec converte una stringa ottale in un numero decimale. Il più grande
numero che può essere convertito è 17777777777 o 2147483647 in
decimale.
</para>
@@ -993,9 +1103,35 @@
</funcsynopsis>
<para>
Restituisce <parameter>base</parameter> elevato alla potenza di
- <parameter>esp</parameter>. Se questo non può essere computato,
- <function>exp</function> restituirà <literal>NAN</literal>.
+ <parameter>esp</parameter>. Se possibile, questa funzione restituisce
+ un <type>integer</type>.
+ </para>
+ <para>
+ Se la potenza non può essere computata, viene generato un errore,
+ e <function>pow</function> restituirà &false;.
</para>
+ <example>
+ <title>Alcuni esempi di <function>pow</function></title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+
+var_dump( pow(2,8) ); // int(256)
+echo pow(-1,20); // 1
+echo pow(0, 0); // 1
+
+echo pow(-1, 5.5); // errore
+
+?>
+]]>
+ </programlisting>
+ </example>
+ <warning>
+ <para>
+ Nel PHP 4.0.6 e precedenti, <function>pow</function> restituiva sempre
+ un <type>float</type> e non generava alcun errore.
+ </para>
+ </warning>
<para>
Vedere anche <function>exp</function>.
</para>
@@ -1006,7 +1142,8 @@
<refnamediv>
<refname>rad2deg</refname>
<refpurpose>
- Converte un numero in radianti nell'equivalente numero in gradi</refpurpose>
+ Converte un numero in radianti nell'equivalente numero in gradi
+ </refpurpose>
</refnamediv>
<refsect1>
<title>Descrizione</title>
@@ -1036,11 +1173,15 @@
<funcsynopsis>
<funcprototype>
<funcdef>int <function>rand</function></funcdef>
- <paramdef>
- <parameter><optional>int min</optional></parameter>
+ <void/>
+ </funcprototype>
+ <funcprototype>
+ <funcdef>int <function>rand</function></funcdef>
+ <paramdef>int
+ <parameter>min</parameter>
</paramdef>
- <paramdef>
- <parameter><optional>int max</optional></parameter>
+ <paramdef>int
+ <parameter>max</parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
@@ -1062,13 +1203,12 @@
<parameter>max</parameter> era <parameter>range</parameter>. Per
ottenere lo stesso risultato in queste vecchie versioni un breve
esempio dovrebbe essere il seguente: <literal>rand (5, 11)</literal>, si
- otterrà un numero casuale compreso fra 5 e 15.
+ otterrà un numero casuale compreso fra 5 e 15.
</para>
</note>
<simpara>
Vedere anche <function>srand</function>,
- <function>getrandmax</function>,
- <function>mt_rand</function>,
+ <function>getrandmax</function>, <function>mt_rand</function>,
<function>mt_srand</function> e
<function>mt_getrandmax</function>.
</simpara>
@@ -1094,14 +1234,29 @@
<para>
Restituisce il valore arrotondato di <parameter>val</parameter> con
la <parameter>precisione</parameter> specificata
- (numero di cifre dopo il punto decimale.
+ (numero di cifre dopo il punto decimale).
+ <parameter>precision</parameter> può anche essere negativa o zero
+(predefinito).
+ </para>
+ <para>
+ <caution>
+ <simpara>
+ Il PHP non maneggia correttamente stringhe quali <literal>"12,300.2"</literal>
+ in maniera predefinita. Fare riferimento a <link
+linkend="language.types.string.conversion"
+ >conversione da stringhe</link>.
+ </simpara>
+ </caution>
+ </para>
+ <para>
<informalexample>
<programlisting>
$foo = round (3.4); // $foo == 3.0
$foo = round (3.5); // $foo == 4.0
$foo = round (3.6); // $foo == 4.0
+$foo = round(3.6, 0); // equivalente alla riga sopra
$foo = round (1.95583, 2); // $foo == 1.96
+
+$foo = round(1241757, -3); // $foo == 1242000
</programlisting>
</informalexample>
</para>
@@ -1140,6 +1295,29 @@
</refsect1>
</refentry>
+ <refentry id="function.sinh">
+ <refnamediv>
+ <refname>sinh</refname>
+ <refpurpose>Seno iperbolico</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>float <function>sinh</function></funcdef>
+ <paramdef>float <parameter>arg</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Restituisce il seno iperbolico di <parameter>arg</parameter>,
+ definito come <literal>(exp(arg) - exp(-arg))/2</literal>.
+ </para>
+ <para>
+ Vedere anche <function>sin</function>, <function>asinh</function>,
+ <function>cos</function> e <function>tan</function>.
+ </para>
+ </refsect1>
+ </refentry>
<refentry id="function.sqrt">
<refnamediv>
@@ -1178,9 +1356,13 @@
<parameter>seme</parameter>.
<informalexample>
<programlisting>
-// inizializza usando i microsecondi passati dall'ultimo secondo "intero"
+// inizializza usando i microsecondi
+function crea_seme() {
+ list($usec, $sec) = explode(' ', microtime());
+ return (float) $sec + ((float) $usec * 100000);
+}
srand((double)microtime()*1000000);
-$randval = rand();
+$valorecasuale = rand();
</programlisting>
</informalexample>
</para>
@@ -1215,6 +1397,30 @@
</refsect1>
</refentry>
+ <refentry id="function.tanh">
+ <refnamediv>
+ <refname>tanh</refname>
+ <refpurpose>Tangente iperbolica</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>float <function>tanh</function></funcdef>
+ <paramdef>float <parameter>arg</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Restituisce la tangente iperbolica di <parameter>arg</parameter>,
+ definita come <literal>sinh(arg)/cosh(arg)</literal>.
+ </para>
+ <para>
+ Vedere anche <function>tan</function>, <function>atanh</function>,
+ <function>sin</function> e <function>cos</function>.
+ </para>
+ </refsect1>
+ </refentry>
+
</reference>
<!-- Keep this comment at the end of the file
