PaqueteNivel superior
Clasepublic final class Number
HerenciaNumber Inheritance Object

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Un tipo de datos que representa un número IEEE-754 de coma flotante de doble precisión. Puede manipular valores numéricos simples utilizando los métodos y propiedades asociados a la clase Number. Esta clase es idéntica a la clase Number de JavaScript.

Las propiedades de la clase Number son estáticas, lo que significa que no necesita un objeto para utilizarlas, por lo que no es preciso que utilice el constructor.

El tipo de datos Number cumple la norma de doble precisión IEEE-754.

El tipo de datos Number resulta útil si necesita utilizar valores de coma flotante. Flash Player gestiona los tipos de datos int y uint de manera más eficiente que Number, pero Number es útil en situaciones en las que el rango de valores requerido supere el rango válido de los tipos de datos int y uint. La clase Number puede utilizarse para representar valores enteros muy superiores o inferiores a los del rango válido de los tipos de datos int y uint. El tipo de datos Number puede utilizar hasta 53 bits para representar valores de enteros, mientras que int y uint disponen de 32 bits. El valor predeterminado de una variable que tiene asignado el tipo Number es NaN (no es un número).

Ver los ejemplos

Véase también

int
uint
Descripción de los tipos de datos
Conversiones de tipos

Propiedades públicas
 PropiedadDefinido por
 Inheritedconstructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada.
Object
 Inheritedprototype : Object
[static] Una referencia al objeto prototipo de una clase u objeto de función.
Object
Métodos públicos
 MétodoDefinido por
  
Number(num:Object)
Crea un objeto Number con el valor especificado.
Number
 Inherited
hasOwnProperty(name:String):Boolean
Indica si un objeto tiene definida una propiedad especificada.
Object
 Inherited
isPrototypeOf(theClass:Object):Boolean
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro.
Object
 Inherited
propertyIsEnumerable(name:String):Boolean
Indica si existe la propiedad especificada y si es enumerable.
Object
 Inherited
setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle.
Object
  
toExponential(fractionDigits:uint):String
Devuelve una representación de cadena del número en notación exponencial.
Number
  
toFixed(fractionDigits:uint):String
Devuelve una representación de cadena del número en notación de coma fija.
Number
  
toPrecision(precision:uint):String
Devuelve una representación de cadena del número en notación exponencial o en notación de coma fija.
Number
  
toString(radix:Number = 10):String
Devuelve la representación de cadena del objeto Number especificado (myNumber).
Number
  
valueOf():Number
Devuelve el tipo de valor simple del objeto Number especificado.
Number
Constantes públicas
 ConstanteDefinido por
  MAX_VALUE : Number
[static] El número más grande que puede representarse (doble precisión IEEE-754).
Number
  MIN_VALUE : Number
[static] El número no negativo distinto de cero más pequeño que puede representarse (doble precisión IEEE-754).
Number
  NaN : Number
[static] El valor IEEE-754 que representa a Not a Number (NaN, no es un número).
Number
  NEGATIVE_INFINITY : Number
[static] Especifica el valor IEEE-754 que representa el infinito negativo.
Number
  POSITIVE_INFINITY : Number
[static] Especifica el valor IEEE-754 que representa el infinito positivo.
Number
Información sobre constructores
Number()constructor
public function Number(num:Object)

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Crea un objeto Number con el valor especificado. Este constructor tiene el mismo efecto que la función nativa pública Number() que convierte un objeto de un tipo diferente en un valor numérico simple.

Parámetros
num:Object — El valor numérico de la instancia Number que se crea o un valor que se va a convertir en un valor Number. Si no se especifica num, el valor predeterminado es 0. El uso del constructor sin especificar un parámetro num no es lo mismo que declarar una variable de tipo Number sin valor asignado (como, por ejemplo, var myNumber:Number), que adopta de manera predeterminada el valor NaN. Un número sin valor asignado es un valor undefined y equivale a new Number(undefined).

Véase también

Number.toString()
Number.valueOf()
Descripción de los tipos de datos
Conversiones de tipos
Información sobre métodos
toExponential()método
AS3 function toExponential(fractionDigits:uint):String

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Devuelve una representación de cadena del número en notación exponencial. La cadena contiene un dígito antes de la coma decimal y hasta 20 dígitos después de la coma decimal, conforme a lo especificado por el parámetro fractionDigits.

Parámetros

fractionDigits:uint — Un entero entre 0 y 20, ambos inclusive, que representa el número deseado de cifras decimales.

Valor devuelto
String

Emite
RangeError — Emite una excepción si el argumento fractionDigits queda fuera del rango de 0 a 20.

Ejemplo

El siguiente ejemplo ilustra cómo toExponential(2) devuelve una cadena en notación exponencial. 

var num:Number = 315003;
trace(num.toExponential(2)); // 3.15e+5
toFixed()método 
AS3 function toFixed(fractionDigits:uint):String

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Devuelve una representación de cadena del número en notación de coma fija. La notación de coma fija significa que la cadena contendrá un número concreto de dígitos tras la coma decimal, conforme a lo especificado en el parámetro fractionDigits. El rango válido para el parámetro fractionDigits va de 0 a 20. Al especificar un valor situado fuera de este rango, se emite una excepción.

Parámetros

fractionDigits:uint — Un entero entre 0 y 20, ambos inclusive, que representa el número deseado de cifras decimales.

Valor devuelto
String

Emite
RangeError — Emite una excepción si el argumento fractionDigits queda fuera del rango de 0 a 20.

Ejemplo

El siguiente ejemplo ilustra cómo toFixed(3) devuelve una cadena que se redondea hasta tres decimales. 

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

El siguiente ejemplo ilustra cómo toFixed(2) devuelve una cadena que añade ceros finales. 

var num:Number = 4;
trace(num.toFixed(2)); // 4.00
toPrecision()método 
AS3 function toPrecision(precision:uint):String

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Devuelve una representación de cadena del número en notación exponencial o en notación de coma fija. La cadena contendrá el número de dígitos especificado en el parámetro precision.

Parámetros

precision:uint — Un entero entre 1 y 21, ambos inclusive, que representa el número deseado de dígitos para representar la cadena resultante.

Valor devuelto
String

Emite
RangeError — Emite una excepción si el argumento precision queda fuera del rango de 1 a 21.

Ejemplo

El siguiente ejemplo ilustra cómo toPrecision(3) devuelve una cadena con sólo tres dígitos. La cadena se expresa en notación de coma fija, ya que no se requiere notación exponencial. 

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

El siguiente ejemplo ilustra cómo toPrecision(3) devuelve una cadena con sólo tres dígitos. La cadena se expresa en notación exponencial, ya que el número resultante no contiene dígitos suficientes para la notación de coma fija. 

var num:Number = 4000;
trace(num.toPrecision(3)); // 4.00e+3
toString()método 
AS3 function toString(radix:Number = 10):String

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Devuelve la representación de cadena del objeto Number especificado (myNumber). Si el valor del objeto Number es un número decimal sin un cero a la izquierda (como, por ejemplo, 0,4), Number.toString() añade un cero a la izquierda (0,4).

Parámetros

radix:Number (default = 10) — Especifica la base numérica (de 2 a 36) que debe utilizarse en la conversión de número a cadena. Si no especifica el parámetro radix, el valor predeterminado es 10.

Valor devuelto
String — Representación numérica del objeto Number como una cadena.
valueOf()método 
AS3 function valueOf():Number

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Devuelve el tipo de valor simple del objeto Number especificado.

Valor devuelto
Number — El valor de tipo simple del objeto Number.
Información sobre constantes
MAX_VALUEConstante
public static const MAX_VALUE:Number

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

El número más grande que puede representarse (doble precisión IEEE-754). Este número es aproximadamente 1.79e+308.

MIN_VALUEConstante 
public static const MIN_VALUE:Number

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

El número no negativo distinto de cero más pequeño que puede representarse (doble precisión IEEE-754). Este número es aproximadamente 5e-324. El número total más pequeño que puede representarse es en realidad -Number.MAX_VALUE.

NaNConstante 
public static const NaN:Number

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

El valor IEEE-754 que representa a Not a Number (NaN, no es un número).

Véase también

isNaN()
NEGATIVE_INFINITYConstante 
public static const NEGATIVE_INFINITY:Number

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Especifica el valor IEEE-754 que representa el infinito negativo. El valor de esta propiedad es el mismo que el de la constante -Infinity.

Infinito negativo es un valor numérico especial que se devuelve cuando una operación o función matemática devuelve un valor negativo mayor de lo que es posible representar.

POSITIVE_INFINITYConstante 
public static const POSITIVE_INFINITY:Number

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Especifica el valor IEEE-754 que representa el infinito positivo. El valor de esta propiedad es el mismo que el de la constante Infinity.

Infinito positivo es un valor numérico especial que se devuelve cuando una operación o función matemática devuelve un valor positivo mayor de lo que es posible representar.

Ejemplos Cómo utilizar los ejemplos
NumberExample.as

El siguiente ejemplo ilustra cómo un número con seis dígitos después de la posición decimal se trunca (con redondeo) para obtener un número con dos dígitos después del punto 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
        }
    }
}



© 2004-2007 Adobe Systems Incorporated. Todos los derechos reservados.
Fri Oct 12 2007, 2:30 AM GMT-07:00

 

Enviarme un mensaje de correo electrónico cuando se añadan comentarios a esta página | Informe de comentarios

Página actual: http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/Number.html