Number

Pacote	Nível superior
Classe	public final class Number
Herança	Number Object

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Um tipo de dados que representa um número de ponto flutuante de precisão dupla IEEE-754. Você pode manipular valores numéricos primitivos usando os métodos e as propriedades associados à classe Number. Essa classe é idêntica à classe Number JavaScript.

As propriedades da classe Number são estáticas; ou seja, elas não exigem um objeto para serem usadas e, portanto, você não precisa usar o construtor.

O tipo de dados Number adere ao padrão de precisão dupla IEEE-754.

O tipo de dados Number é útil quando você precisa usar valores de ponto flutuante. O tempo de execução do Flash manipula os tipos de dados int e uint de forma mais eficiente que Number, mas Number é útil em situações nas quais a faixa de valores necessários excede a faixa válida dos tipos de dados int e uint. A classe Number pode ser usada para representar valores inteiros bem além da faixa válida dos tipos de dados int e uint. O tipo de dados Number pode usar até 53 bits para representar valores inteiros, em comparação aos 32 bits disponíveis para int e uint. O valor padrão de uma variável digitada como número é NaN (Não é um número).

Veja os exemplos

Elementos da API relacionados

int
uint

Propriedades públicas

Ocultar propriedades públicas herdadas

Mostrar propriedades públicas herdadas

	Propriedade		Definido por
		constructor : Object Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto.	Object

Métodos públicos

Ocultar métodos públicos herdados

Mostrar métodos públicos herdados

	Método		Definido por
		Number(num:Object) Cria um objeto Number com o valor especificado.	Number
		hasOwnProperty(name:String):Boolean Indica se um objeto tem uma propriedade especificada definida.	Object
		isPrototypeOf(theClass:Object):Boolean Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro.	Object
		propertyIsEnumerable(name:String):Boolean Indica se a propriedade especificada existe e é enumerável.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Define a disponibilidade de uma propriedade dinâmica para operações de repetição.	Object
		toExponential(fractionDigits:uint):String Retorna uma representação de string do número em notação exponencial.	Number
		toFixed(fractionDigits:uint):String Retorna uma representação de string do número em notação de pontos fixos.	Number
		toLocaleString():String Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade.	Object
		toPrecision(precision:uint):String Retorna uma representação de string do número em notação exponencial ou de pontos fixos.	Number
		toString(radix:Number = 10):String Retorna a representação de string do objeto Number especificado (myNumber).	Number
		valueOf():Number Retorna o tipo de valor primitivo do objeto Number especificado.	Number

Constantes públicas

	Constante		Definido por
		MAX_VALUE : Number [estático] O maior número representável (IEEE-754 de precisão dupla).	Number
		MIN_VALUE : Number [estático] O menor número (mais perto de zero, não o mais negativo) IEEE-754 representável que não se compara a igual a zero.	Number
		NaN : Number [estático] O valor IEEE-754 representando NaN (não é um número).	Number
		NEGATIVE_INFINITY : Number [estático] Especifica o valor IEEE-754 representando o infinito negativo.	Number
		POSITIVE_INFINITY : Number [estático] Especifica o valor IEEE-754 representando o infinito positivo.	Number

Detalhes do construtor

()

Construtor

public function Number(num:Object)

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Cria um objeto Number com o valor especificado. Esse construtor tem o mesmo efeito que a função pública nativa Number(), que converte um objeto de um tipo diferente em um valor numérico primitivo.

Parâmetros

num:Object — O valor numérico da ocorrência de Number que está sendo criada ou um valor a ser convertido em um número. O valor padrão será 0 se num não for especificado. Usar o construtor sem especificar um parâmetro num não é o mesmo que declarar uma variável do tipo Number sem valor atribuído (como var myNumber:Number), que resulta em NaN. Um número sem valor atribuído é indefinido e o equivalente de new Number(undefined).

Elementos da API relacionados

Number.toString()
Number.valueOf()

Detalhes do método

toExponential

()

método

AS3 function toExponential(fractionDigits:uint):String

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 9, AIR 1.0, Flash Lite 4

Retorna uma representação de string do número em notação exponencial. A string contém um dígito antes do ponto decimal e até 20 dígitos depois do ponto decimal, conforme especificado pelo parâmetro fractionDigits.

Parâmetros

fractionDigits:uint — Um inteiro entre 0 e 20, inclusive, que representa o número desejado de casas decimais.

Retorna

String

Lança

RangeError — Lançará uma exceção se o argumento fractionDigits estiver fora da faixa de 0 a 20.

Exemplo ( Como usar este exemplo )

O exemplo a seguir mostra como toExponential(2) retorna uma string em notação exponencial.


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

toFixed

()

método

AS3 function toFixed(fractionDigits:uint):String

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 9, AIR 1.0, Flash Lite 4

Retorna uma representação de string do número em notação de pontos fixos. A notação de pontos fixos significa que a string conterá um número específico de dígitos após o ponto decimal, conforme especificado no parâmetro fractionDigits. A faixa válida do parâmetro fractionDigits é de 0 a 20. Especificar um valor fora dessa faixa lança uma exceção.

Parâmetros

fractionDigits:uint — Um inteiro entre 0 e 20, inclusive, que representa o número desejado de casas decimais.

Retorna

String

Lança

RangeError — Lançará uma exceção se o argumento fractionDigits estiver fora da faixa de 0 a 20.

Exemplo ( Como usar este exemplo )

O exemplo a seguir mostra como toFixed(3) retorna uma string que é arredondada em três casas decimais.


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

O exemplo a seguir mostra como toFixed(2) retorna uma string que adiciona zeros à direita.


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

toPrecision

()

método

AS3 function toPrecision(precision:uint):String

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 9, AIR 1.0, Flash Lite 4

Retorna uma representação de string do número em notação exponencial ou de pontos fixos. A string conterá o número de dígitos especificados no parâmetro precision.

Parâmetros

precision:uint — Um inteiro entre 1 e 21, inclusive, que representa o número desejado de dígitos a serem representados na string resultante.

Retorna

String

Lança

RangeError — Lançará uma exceção se o argumento precision estiver fora da faixa de 1 a 21.

Exemplo ( Como usar este exemplo )

O exemplo a seguir mostra como toPrecision(3) retorna uma string com apenas três dígitos. A string está em notação de pontos fixos porque a notação exponencial não é necessária.


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

O exemplo a seguir mostra como toPrecision(3) retorna uma string com apenas três dígitos. A string está em notação exponencial porque o número resultante não contém dígitos suficientes para a notação de pontos fixos.


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

toString

()

método

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

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Retorna a representação de string do objeto Number especificado (myNumber). Se o valor do objeto Number for um número decimal sem um zero à esquerda (como .4), Number.toString() adicionará um zero à esquerda (0.4).

Parâmetros

radix:Number (default = 10) — Especifica a base numérica (de 2 a 36) a ser usada para a conversão de número em string. Se você não especificar o parâmetro radix, o valor padrão será 10.

Retorna

String — A representação numérica do objeto Number como uma string.

valueOf

()

método

AS3 function valueOf():Number

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Retorna o tipo de valor primitivo do objeto Number especificado.

Retorna

Number — O valor de tipo primitivo do objeto Number.

Detalhes da constante

MAX_VALUE

Constante

public static const MAX_VALUE:Number

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

O maior número representável (IEEE-754 de precisão dupla). Esse número é aproximadamente 1.79e+308.

MIN_VALUE

Constante

public static const MIN_VALUE:Number

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

O menor número (mais perto de zero, não o mais negativo) IEEE-754 representável que não se compara a igual a zero. Na maioria das plataformas, este número é aproximadamente 5e-324, mas ele pode ser maior em sistemas que não oferecem suporte a números desordenados. Por exemplo, no iOS o valor desta constante é 2.225e-308.

Observação: o menor número absoluto representável geral é -Number.MAX_VALUE.

NaN

Constante

public static const NaN:Number

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

O valor IEEE-754 representando NaN (não é um número).

Elementos da API relacionados

função global isNaN()

NEGATIVE_INFINITY

Constante

public static const NEGATIVE_INFINITY:Number

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Especifica o valor IEEE-754 representando o infinito negativo. O valor dessa propriedade é igual ao da constante -Infinity.

O infinito negativo é um valor numérico especial que é retornado quando uma função ou operação matemática retorna um valor negativo maior do que é possível representar.

POSITIVE_INFINITY

Constante

public static const POSITIVE_INFINITY:Number

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Especifica o valor IEEE-754 representando o infinito positivo. O valor dessa propriedade é igual ao da constante Infinity.

O infinito positivo é um valor numérico especial que é retornado quando uma função ou operação matemática retorna um valor maior do que é possível representar.

Exemplos Como usar este exemplo

NumberExample.as

O exemplo a seguir mostra como um número com seis dígitos após a casa decimal é truncado (com arredondamento) para um número com dois dígitos após o ponto decimal.


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

Aspectos jurídicos | Política de privacidade on-line

Number - AS3

Classes x

Number

toExponential

toFixed

toPrecision

toString

valueOf

MAX_VALUE

MIN_VALUE

NaN

NEGATIVE_INFINITY

POSITIVE_INFINITY