Number (ActionScript 3.0)

	Proprietà	Definito da
		constructor: Object Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto.	Object
		prototype: Object [statico] Un riferimento all'oggetto prototipo di un oggetto classe o funzione.	Object

	Metodo	Definito da
		Number(num:Object) Crea un oggetto Number con il valore specificato.	Number
		hasOwnProperty(name:String):Boolean Indica se per un oggetto è definita una proprietà specifica.	Object
		isPrototypeOf(theClass:Object):Boolean Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.	Object
		propertyIsEnumerable(name:String):Boolean Indica se la proprietà specificata esiste ed è enumerabile.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.	Object
		toExponential(fractionDigits:uint):String Restituisce una rappresentazione in formato stringa del numero utilizzando la notazione esponenziale.	Number
		toFixed(fractionDigits:uint):String Restituisce una rappresentazione in formato stringa del numero utilizzando la notazione a virgola fissa.	Number
		toPrecision(precision:uint):String Restituisce una rappresentazione in formato stringa del numero utilizzando la notazione esponenziale o la notazione a virgola fissa.	Number
		toString(radix:Number = 10):String Restituisce la rappresentazione in formato stringa dell'oggetto Number specificato (myNumber).	Number
		valueOf():Number Restituisce il tipo di valore di base dell'oggetto Number specificato.	Number

	Costante	Definito da
		MAX_VALUE: Number [statico] Il più grande numero rappresentabile (IEEE-754 a precisione doppia).	Number
		MIN_VALUE: Number [statico] Il più piccolo numero non negativo e diverso da zero rappresentabile (IEEE-754 a precisione doppia).	Number
		NaN: Number [statico] Il valore IEEE-754 che rappresenta Not A Number (NaN).	Number
		NEGATIVE_INFINITY: Number [statico] Indica il valore IEEE-754 che rappresenta l'infinito negativo.	Number
		POSITIVE_INFINITY: Number [statico] Indica il valore IEEE-754 che rappresenta l'infinito positivo.	Number

Descrizione della funzione di costruzione

Number

()

Funzione di costruzione

public function Number(num:Object)

Versione linguaggio:

ActionScript 3.0

Versione lettore:

Flash Player 9

Crea un oggetto Number con il valore specificato. Questa funzione di costruzione ha lo stesso effetto della funzione nativa pubblica Number() che converte un oggetto di tipo diverso in un valore numerico di base.

Parametri

num:Object — Il valore numerico dell'istanza Number da creare o un valore da convertire in un numero. Il valore predefinito è 0, se non viene specificato num. L'utilizzo della funzione di costruzione senza specificare un parametro num non equivale a dichiarare una variabile di tipo Number senza alcun valore assegnato (come var myNumber:Number), che ha come valore predefinito NaN. Un numero senza valore assegnato è undefined e l'equivalente di new Number(undefined).

Vedere anche

Number.toString()
Number.valueOf()
Descrizione dei tipi di dati
Conversione del tipo di dati

Descrizione dei metodi

toExponential

()

metodo

AS3 function toExponential(fractionDigits:uint):String

Versione linguaggio:

ActionScript 3.0

Versione lettore:

Flash Player 9

Restituisce una rappresentazione in formato stringa del numero utilizzando la notazione esponenziale. La stringa contiene una cifra prima del separatore decimale e fino a 20 cifre dopo di esso, come specificato dal parametro fractionDigits.

Parametri

fractionDigits:uint — Un numero intero compreso tra 0 e 20 (inclusi), che rappresenta il numero desiderato di posizioni decimali.

Restituisce

String

Genera

RangeError — Genera un'eccezione se l'argomento fractionDigits è al di fuori dell'intervallo compreso tra 0 e 20.

Esempio

L'esempio seguente mostra il modo in cui il metodo toExponential(2) restituisce una stringa con la notazione esponenziale.


var num:Number = 315003;
trace(num.toExponential(2)); // 3.15e+5

toFixed

()

metodo

AS3 function toFixed(fractionDigits:uint):String

Versione linguaggio:

ActionScript 3.0

Versione lettore:

Flash Player 9

Restituisce una rappresentazione in formato stringa del numero utilizzando la notazione a virgola fissa. Nella notazione a virgola fissa la stringa contiene un numero specifico di cifre dopo il separatore decimale, come specificato nel parametro fractionDigits. L'intervallo valido per il parametro fractionDigits è compreso tra 0 e 20. Se si specifica un valore al di fuori di questo intervallo, viene generata un'eccezione.

Parametri

fractionDigits:uint — Un numero intero compreso tra 0 e 20 (inclusi), che rappresenta il numero desiderato di posizioni decimali.

Restituisce

String

Genera

RangeError — Genera un'eccezione se l'argomento fractionDigits è al di fuori dell'intervallo compreso tra 0 e 20.

Esempio

L'esempio seguente mostra il modo in cui il metodo toFixed(3) restituisce una stringa che arrotonda a tre decimali.


var num:Number = 7.31343;
trace(num.toFixed(3)); // 7.313

L'esempio seguente mostra il modo in cui il metodo toFixed(2) restituisce una stringa che aggiunge zeri finali.


var num:Number = 4;
trace(num.toFixed(2)); // 4.00

toPrecision

()

metodo

AS3 function toPrecision(precision:uint):String

Versione linguaggio:

ActionScript 3.0

Versione lettore:

Flash Player 9

Restituisce una rappresentazione in formato stringa del numero utilizzando la notazione esponenziale o la notazione a virgola fissa. La stringa contiene il numero di cifre specificato nel parametro precision.

Parametri

precision:uint — Un numero intero compreso tra 1 e 21 (inclusi), che rappresenta il numero desiderato di cifre da rappresentare nella stringa risultante.

Restituisce

String

Genera

RangeError — Genera un'eccezione se l'argomento precision è al di fuori dell'intervallo compreso tra 1 e 21.

Esempio

L'esempio seguente mostra il modo in cui il metodo toPrecision(3) restituisce una stringa con solo tre cifre. La stringa ha notazione a virgola fissa dal momento che non è necessaria la notazione esponenziale.


var num:Number = 31.570;
trace(num.toPrecision(3)); // 31.6

L'esempio seguente mostra il modo in cui il metodo toPrecision(3) restituisce una stringa con solo tre cifre. La stringa ha notazione esponenziale perché il numero risultante non contiene le cifre sufficienti per la notazione a virgola fissa.


var num:Number = 4000;
trace(num.toPrecision(3)); // 4.00e+3

toString

()

metodo

AS3 function toString(radix:Number = 10):String

Versione linguaggio:

ActionScript 3.0

Versione lettore:

Flash Player 9

Restituisce la rappresentazione in formato stringa dell'oggetto Number specificato (myNumber). Se il valore dell'oggetto Number è un numero decimale senza uno zero iniziale (ad esempio, ,4), Number.toString() aggiunge uno zero iniziale (0,4).

Parametri

radix:Number (default = 10) — Specifica la base numerica (da 2 a 36) da utilizzare per la conversione da numero a stringa. Se non si specifica il parametro radix, il valore predefinito è 10.

Restituisce

String — La rappresentazione numerica dell'oggetto Number sotto forma di stringa.

valueOf

()

metodo

AS3 function valueOf():Number

Versione linguaggio:

ActionScript 3.0

Versione lettore:

Flash Player 9

Restituisce il tipo di valore di base dell'oggetto Number specificato.

Restituisce

Number — Il valore del tipo di base dell'oggetto Number.

Descrizione delle costanti

MAX_VALUE

Costante

public static const MAX_VALUE:Number

Versione linguaggio:

ActionScript 3.0

Versione lettore:

Flash Player 9

Il più grande numero rappresentabile (IEEE-754 a precisione doppia). Questo numero corrisponde approssimativamente a 1,79e+308.

MIN_VALUE

Costante

public static const MIN_VALUE:Number

Versione linguaggio:

ActionScript 3.0

Versione lettore:

Flash Player 9

Il più piccolo numero non negativo e diverso da zero rappresentabile (IEEE-754 a precisione doppia). Questo numero corrisponde approssimativamente a 5e-324. Il più piccolo numero rappresentabile globale è in realtà -Number.MAX_VALUE.

NaN

Costante

public static const NaN:Number

Versione linguaggio:

ActionScript 3.0

Versione lettore:

Flash Player 9

Il valore IEEE-754 che rappresenta Not A Number (NaN).

Vedere anche

isNaN()

NEGATIVE_INFINITY

Costante

public static const NEGATIVE_INFINITY:Number

Versione linguaggio:

ActionScript 3.0

Versione lettore:

Flash Player 9

Indica il valore IEEE-754 che rappresenta l'infinito negativo. Il valore di questa proprietà equivale a quello della costante -Infinity.

L'infinito negativo è un valore numerico speciale che viene restituito quando un'operazione o una funzione matematica restituisce un valore negativo superiore a quello che è possibile rappresentare.

POSITIVE_INFINITY

Costante

public static const POSITIVE_INFINITY:Number

Versione linguaggio:

ActionScript 3.0

Versione lettore:

Flash Player 9

Indica il valore IEEE-754 che rappresenta l'infinito positivo. Il valore di questa proprietà equivale a quello della costante Infinity.

L'infinito positivo è un valore numerico speciale che viene restituito quando un'operazione o una funzione matematica restituisce un valore superiore a quello che è possibile rappresentare.

Esempi Come utilizzare gli esempi

NumberExample.as

L'esempio seguente mostra come un numero con sei cifre decimali viene troncato (mediante arrotondamento) in un numero a due cifre dopo la virgola decimale.


package {
    import flash.display.Sprite;

    public class NumberExample extends Sprite {
        public function NumberExample() {
            var num:Number = new Number(10.456345);
            var str:String = num.toFixed(2);
            trace(num); // 10.456345
            trace(str); // 10.46
        }
    }
}

Pagina corrente: http://livedocs.adobe.com/flash/9.0_it/ActionScriptLangRefV3/Number.html

Guida di riferimento del linguaggio e dei componenti ActionScript 3.0		Tutti i pacchetti \| Tutte le classi \| Elementi del linguaggio \| Indice \| Appendici \| Convenzioni \| Con frame Senza frame
Number	Proprietà \| Metodi \| Costanti \| Esempi

Pacchetto	Primo livello
Classe	public final class Number
Ereditarietà	Number Object