Number

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

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Un tipo di dati che rappresenta un numero a virgola mobile e a precisione doppia IEEE-754. Potete manipolare i valori numerici di base utilizzando i metodi e le proprietà associati alla classe Number. Questa classe è identica alla classe Number del codice JavaScript.

Le proprietà della classe sono statiche; questo significa che non vi occorre un oggetto per utilizzarle e pertanto non dovete utilizzare la funzione di costruzione.

Il tipo di dati Number è conforme allo standard IEEE-754 a precisione doppia.

Il tipo di dati Number è utile quando è necessario utilizzare dei valori a virgola mobile. I runtime Flash gestiscono i tipi di dati int e uint in modo più efficiente rispetto a Number, ma Number è utile nelle situazioni in cui l'intervallo dei valori richiesti supera l'intervallo valido dei tipi di dati int e uint. La classe Number può essere utilizzata per rappresentare i valori interi oltre l'intervallo valido dei tipi di dati int e uint. Il tipo di dati Number può utilizzare fino a 53 bit per rappresentare i valori interi, contro i 32 bit disponibili per int e uint. Il valore predefinito di una variabile assegnata come Number è NaN (Not a Number, Non un numero).

Vedere gli esempi

Elementi API correlati

int
uint

Proprietà pubbliche

Nascondi proprietà pubbliche ereditate

Mostra proprietà pubbliche ereditate

	Proprietà		Definito da
		constructor : Object Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto.	Object

Metodi pubblici

Nascondi metodi pubblici ereditati

Mostra metodi pubblici ereditati

	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
		toLocaleString():String Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate.	Object
		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

Costanti pubbliche

	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 (il più vicino a zero, non il più negativo) numero IEEE-754 rappresentabile che non risulta uguale a zero.	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

()

Funzione di costruzione

public function Number(num:Object)

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

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).

Elementi API correlati

Number.toString()
Number.valueOf()

Descrizione dei metodi

toExponential

()

metodo

AS3 function toExponential(fractionDigits:uint):String

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 9, AIR 1.0, Flash Lite 4

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 ( Come utilizzare questo 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

Versioni runtime:

Flash Player 9, AIR 1.0, Flash Lite 4

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 specificate 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 ( Come utilizzare questo 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

Versioni runtime:

Flash Player 9, AIR 1.0, Flash Lite 4

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 ( Come utilizzare questo 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

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

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 specificate 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

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

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

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

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

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Il più piccolo (il più vicino a zero, non il più negativo) numero IEEE-754 rappresentabile che non risulta uguale a zero. In quasi tutte le piattaforme questo numero è approssimativamente 5e-324, ma può essere superiore nei sistemi che non supportano i numeri denormalizzati. Ad esempio, in iOS il valore di questa costante è 2.225e-308.

Nota: il numero assoluto più piccolo rappresentabile globalmente è Number.MAX_VALUE.

NaN

Costante

public static const NaN:Number

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

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

Elementi API correlati

isNaN() funzione globale

NEGATIVE_INFINITY

Costante

public static const NEGATIVE_INFINITY:Number

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

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

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

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 questo esempio

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
        }
    }
}

Note legali | Informativa sulla privacy online

Number - AS3

Classi x

Number

toExponential

toFixed

toPrecision

toString

valueOf

MAX_VALUE

MIN_VALUE

NaN

NEGATIVE_INFINITY

POSITIVE_INFINITY