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 @@ - - + Funzioni Matematiche Mat @@ -9,14 +8,17 @@ Introduzione - 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 funzioni matematiche a precisione arbitraria. + Queste funzioni matematiche operano esclusivamente nel range + dei tipi di dato integer e float 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 + funzioni matematiche a precisione arbitraria. Costanti Matematiche - 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:

Costanti Matematiche @@ -116,8 +118,9 @@
- 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. @@ -138,7 +141,10 @@ 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. + è di tipo float, il valore restituito è float, + altrimenti restituisce un integer (perché float di solito ha un range di + valori più grande di integer). + @@ -156,14 +162,40 @@ - Restituisce l'arco coseno di arg in radianti. - + Restituisce l'arco coseno di arg in radianti. + - Vedere anche asin e atan. - + Vedere anche arg, asin + e atan. + + + + + + + acosh + Inverso del coseno iperbolico + + + Descrizione + + + float acosh + float arg + + + + Restituisce l'inverso del coseno iperbolico + di arg, cioè il valore + il cui coseno iperbolico vale arg. + + ¬e.no-windows; + + Vedere anche acos, asin + e atan. + - @@ -179,19 +211,45 @@ - Restituisce l'arco seno di arg in radianti. - + Restituisce l'arco seno di arg in radianti. + - Vedere anche acos e atan. - + Vedere anche asinh, acos + e atan. + + + + + + + asinh + Inverso del seno iperbolico + + + Descrizione + + + float asinh + float arg + + + + Restituisce l'inverso del seno iperbolico + di arg, cioè il valore + il cui seno iperbolico vale arg + + ¬e.no-windows; + + vedere anche asin, acos + e atan. + - atan - arco tangente + Arco tangente Descrizione @@ -202,15 +260,41 @@ - Restituisce l'arco tangente di arg in radianti. - + Restituisce l'arco tangente di arg in radianti. + - Vedere anche asin e acos. - + Vedere anche atanh, asin + e acos. + - + + + atanh + Inverso della tangente iperbolica + + + Descrizione + + + float atanh + float arg + + + + Restituisce l'inverso della tangente iperbolica di + arg, cioè il valore + la cui tangente iperbolica vale arg. + + ¬e.no-windows; + + See also atan, asin + e acos. + + + + atan2 @@ -226,12 +310,16 @@ - Questa funzione calcola l'arco tangente delle due variabili x e y. E' simile al calcolo dell'arco - tangente di y / x, eccetto per il fatto che viene tenuto in considearazione il segno di entrambi + Questa funzione calcola l'arco tangente delle due variabili + x e y. È + simile al calcolo dell'arco tangente di + y / x, eccetto per il + fatto che viene tenuto in considearazione il segno di entrambi gli argomenti per determinare il quadrante del risultato. - 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). Vedere anche acos e atan. @@ -239,7 +327,6 @@ - base_convert @@ -258,16 +345,16 @@ Restituisce una stringa contenente numero rappresentata in base base_di_arrivo. La base in - cui numero è dato è specificata in - base_di_partenza. Entrambe + cui numero è dato è specificata da + base_di_partenza. Entrambe base_di_partenza e base_di_arrivo 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. - base_convert() + <function>base_convert</function> -$binary = base_convert ($hexadecimal, 16, 2); +$binario = base_convert ($esadecimale, 16, 2); @@ -277,7 +364,7 @@ - BinDec + bindec Da binario a decimale @@ -294,16 +381,16 @@ bindec converte un binario in - intero. Il più grande numero che può + integer. Il più grande numero che può essere convertito è 31 volte la cifra 1 oppure 2147483647 espresso in formato decimale. - Vedere anche la funzione decbin. + Vedere anche la funzione + decbin. - ceil @@ -318,7 +405,7 @@ - Restituisce il primo intero più grande di + Restituisce il primo intero più grande di numero, se necessario. Il valore restituito da ceil è ancora di tipo float, poiché la gamma di valori del tipo float è @@ -347,18 +434,39 @@ Restituisce il coseno di arg in radianti. - Vedere anche sin e tan. - + + + cosh + Coseno iperbolico + + + Descrizione + + + float cosh + float arg + + + + Restituisce il coseno iperbolico di arg, + definito come (exp(arg) + exp(-arg))/2. + + + Vedere anche cos, acosh, + sin and tan. + + + - DecBin + decbin Da decimale a binario @@ -371,21 +479,18 @@ Restituisce una stringa contenente una rappresentazione binaria di un dato - argomento numero. Il più grande numero che può essere convertito è + argomento numero. Il più grande numero che può essere convertito è 2147483647 in decimale risultante in una stringa composta da 31 volte la cifra 1. - Vedere anche la funzione bindec. - - - DecHex + dechex Da decimale a esadecimale @@ -398,21 +503,18 @@ Restituisce una stringa contenente una rappresentazione esadecimale di un dato - argomento numero. Il più grande numero che può essere - convertito è 2147483647 in decimale risultante in "7fffffff". + argomento numero. Il più grande numero che puù essere + convertito è 2147483647 in decimale risultante in "7fffffff". - Vedere anche la funzione hexdec. - - - DecOct + decoct Da decimale a ottale @@ -425,14 +527,15 @@ Restituisce una stringa contenente una rappresentazione in ottale di un dato - argomento numero. Il più grande numero che può essere convertito è + argomento numero. Il più grande numero che può essere convertito è 2147483647 in decimale risultante in "17777777777". Vedere anche octdec. - + + Vedere anche octdec. + - deg2rad @@ -449,7 +552,8 @@ - Questa funzione converte numero da gradi al valore equivalente espresso in radianti. + Questa funzione converte numero da gradi + al valore equivalente espresso in radianti. Vedere anche rad2deg. @@ -457,7 +561,6 @@ - exp @@ -474,19 +577,16 @@ Restituisce e elevato alla potenza di arg. - Vedere anche pow. - - floor - arrotonda le frazioni all'intero inferiore + Arrotonda le frazioni all'intero inferiore Descrizione @@ -497,52 +597,47 @@ - Restituisce il primo intero più piccolo di + Restituisce il primo intero più piccolo di numero, se necessario. Il valore restituito da floor è ancora di tipo float, poiché la gamma di valori del tipo float è solitamente più grande di quella del tipo int. - Vedere anche ceil e round. + Vedere anche ceil + e round. - getrandmax - mostra il più grande numero casuale disponibile + Mostra il più grande numero casuale disponibile Descrizione int getrandmax - void + - - 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 rand. - - Vedere anche rand, - srand - mt_rand, - mt_srand e + Vedere anche rand, srand + mt_rand, mt_srand e mt_getrandmax. - - HexDec + hexdec Da esadecimale a decimale @@ -556,8 +651,8 @@ Restituisce l'equivalente decimale di un numero esadecimale rappresentato dall'argomento stringa_esadecimale. hexdec 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. hexdec sostituisce ogni carattere non esadecimale @@ -591,8 +686,8 @@ Descriztione - double lcg_value - void + float lcg_value + @@ -620,11 +715,9 @@ Restituisce il logaritmo naturale di arg. - - log10 @@ -661,20 +754,20 @@ max restituisce il numericamente più grande dei - valori dati come parametri. + valori dati come parametro. - Se il primo parametro è un array, max + Se il primo parametro è un array, max 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 max restituisce il maggiore di tali valori. Si può confrontare un numero illimitato di valori. - 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. @@ -693,23 +786,30 @@ mixed arg2 mixed argn + + number min + array numeri + - min restituisce il numericamente più piccolo dei valori dati come - parametro. + min restituisce il numericamente più + piccolo dei valori dati come parametro. - Se il primo parametro è un array, min - 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 min 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 min restituisce il minimo fra i valori. + Si può confrontare un numero illimitato di valori. + + + Nella seconda variante, min + restituisce il più piccolo valore in numeri. - 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 float, tutti i valori + saranno + considerati come float, e verrà restituito un float. Se nessuno dei + valori è float, tutti verranno considerati come integer, e + verrà restituito un integer. @@ -724,11 +824,15 @@ int mt_rand + + + + int mt_rand int - min + min int - max + max @@ -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 rand. - La funzione mt_rand è un sostituto + La funzione mt_rand è 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: &url.mersenne;, e una versione ottimizzata - del codice sorgente di MT è disponibile a questo inidrizzo: &url.mersenne.twister;. + 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: &url.mersenne;, e una + versione ottimizzata del codice sorgente di MT è disponibile + a questo inidrizzo: &url.mersenne.twister; + . Se invocata senza i parametri opzionali min, @@ -764,7 +870,7 @@ max era range. Per ottenere lo stesso risultato in queste vecchie versioni un breve esempio dovrebbe essere il seguente: mt_rand (5, 11), si - otterrà un numero casuale compreso fra 5 e 15. + otterrà un numero casuale compreso fra 5 e 15. @@ -792,9 +898,13 @@ Inizializza il generatore di numeri casuali con il parametro seme. - -// inizializza usando i microsecondi passati dall'ultimo secondo "intero" -mt_srand((double)microtime()*1000000); + +// 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(); @@ -818,11 +928,11 @@ int mt_getrandmax - void + - 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 mt_rand. @@ -845,29 +955,29 @@ string number_format float numero - int decimali - string separatore_decimali - string separatore_migliaia + int decimali + string separatore_decimali + string separatore_migliaia number_format restituisce una versione formattata di - numero. Questa funzione accetta uno, + numero. Questa funzione accetta uno, due o quattro parametri (non tre): Se viene dato un solo parametro, - numero sarà formattato senza decimali, + numero sarà formattato senza decimali, ma con una virgola (",") fra ogni gruppo di migliaia. - Se vengono dati due parametri, numero sarà + Se vengono dati due parametri, numero sarà formattato con decimali decimali con un punto (".") davanti, e una virgola (",") fra ciascun gruppo di migliaia. Se vengono dati tutti e quattro i parametri, numero - sarà formattato con decimali decimali, + sarà formattato con decimali decimali, separatore_decimali invece di un punto (".") prima dei decimali e separatore_migliaia invece di una virgola (",") fra ciascun gruppo di migliaia. @@ -924,7 +1034,7 @@ - OctDec + octdec Da ottale a decimale @@ -938,7 +1048,7 @@ 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. @@ -993,9 +1103,35 @@ Restituisce base elevato alla potenza di - esp. Se questo non può essere computato, - exp restituirà NAN. + esp. Se possibile, questa funzione restituisce + un integer. + + + Se la potenza non può essere computata, viene generato un errore, + e pow restituirà &false;. + + Alcuni esempi di <function>pow</function> + + +]]> + + + + + Nel PHP 4.0.6 e precedenti, pow restituiva sempre + un float e non generava alcun errore. + + Vedere anche exp. @@ -1006,7 +1142,8 @@ rad2deg - Converte un numero in radianti nell'equivalente numero in gradi + Converte un numero in radianti nell'equivalente numero in gradi + Descrizione @@ -1036,11 +1173,15 @@ int rand - - int min + + + + int rand + int + min - - int max + int + max @@ -1062,13 +1203,12 @@ max era range. Per ottenere lo stesso risultato in queste vecchie versioni un breve esempio dovrebbe essere il seguente: rand (5, 11), si - otterrà un numero casuale compreso fra 5 e 15. + otterrà un numero casuale compreso fra 5 e 15. Vedere anche srand, - getrandmax, - mt_rand, + getrandmax, mt_rand, mt_srand e mt_getrandmax. @@ -1094,14 +1234,29 @@ Restituisce il valore arrotondato di val con la precisione specificata - (numero di cifre dopo il punto decimale. + (numero di cifre dopo il punto decimale). + precision può anche essere negativa o zero (predefinito). + + + + + Il PHP non maneggia correttamente stringhe quali "12,300.2" + in maniera predefinita. Fare riferimento a conversione da stringhe. + + + + $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 @@ -1140,6 +1295,29 @@ + + + sinh + Seno iperbolico + + + Descrizione + + + float sinh + float arg + + + + Restituisce il seno iperbolico di arg, + definito come (exp(arg) - exp(-arg))/2. + + + Vedere anche sin, asinh, + cos e tan. + + + @@ -1178,9 +1356,13 @@ seme. -// 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(); @@ -1215,6 +1397,30 @@ + + + tanh + Tangente iperbolica + + + Descrizione + + + float tanh + float arg + + + + Restituisce la tangente iperbolica di arg, + definita come sinh(arg)/cosh(arg). + + + Vedere anche tan, atanh, + sin e cos. + + + +