Nivel superior 

Valor especial que representa Infinity (infinito) negativo. El valor de esta constante es igual que Number.NEGATIVE_INFINITY.

Elementos de API relacionados

trace(0 / 0);  // NaN
trace(7 / 0);  // Infinity
trace(-7 / 0); // -Infinity

Valor especial que representa Infinity (infinito) positivo. El valor de esta constante es igual que Number.POSITIVE_INFINITY.

Elementos de API relacionados

trace(0 / 0);  // NaN
trace(7 / 0);  // Infinity
trace(-7 / 0); // -Infinity

Miembro especial del tipo de datos Number que representa un valor que "no es un número" (NaN). Cuando una expresión matemática da como resultado un valor que no puede expresarse en forma de número, el resultado es NaN. En la siguiente lista se describen expresiones comunes que dan como resultado NaN.

• La división entre 0 da como resultado NaN solamente si el divisor también es 0. Si el divisor es menor que 0, la división por 0 da como resultado Infinity. Si el divisor es menor que 0, la división por 0 da como resultado -Infinity;
• Raíz cuadrada de un número negativo;
• El arcoseno de un número situado fuera del rango válido de 0 a 1;
• Infinity restado de Infinity;
• Infinity o -Infinity dividido por Infinity o -Infinity;
• Infinity o -Infinity multiplicado por 0;

El valor NaN no es miembro de los tipos de datos int o uint.

El valor NaN no se considera igual a ningún otro valor, incluido NaN, lo que hace imposible utilizar el operador de igualdad para comprobar si una expresión es NaN (no es un número). Para determinar si un número es la función NaN, utilice isNaN().

Elementos de API relacionados

Valor especial que se aplica a variables sin tipo asignado que no han sido inicializadas o propiedades de objeto no dinámicas que no han sido inicializadas. En ActionScript 3.0, sólo las variables sin tipo asignado pueden contener el valor undefined, lo que no sucedía en ActionScript 1.0 y ActionScript 2.0. Por ejemplo, las dos variables siguientes son undefined porque no tienen tipo asignado y no están inicializadas:

• var foo;
• var bar:*;

El valor undefined también se aplica a propiedades no inicializadas o no definidas (undefined) de objetos dinámicos. Por ejemplo, si un objeto es una instancia de la clase Object, el valor de cualquier propiedad añadida dinámicamente será undefined hasta que se asigne un valor a dicha propiedad.

Los resultados varían cuando undefined se utiliza con diversas funciones:

• El valor devuelto por String(undefined) is "undefined" (undefined se convierte en una cadena).
• El valor devuelto por Number(undefined) es NaN.
• El valor devuelto por int(undefined) y uint(undefined) es 0.
• El valor devuelto por Object(undefined) es una nueva instancia de Object.
• Cuando se asigna el valor undefined a una variable con tipo asignado, el valor se convierte al valor predeterminado del tipo de datos.

No debe confundir undefined con null. Cuando null y undefined se comparan con el operador de igualdad (==) se comparan como iguales. Sin embargo, cuando null y undefined se comparan con el operador de igualdad estricta (===), se comparan como no iguales.

Elementos de API relacionados

// trace value of untyped and uninitialized variable
var myVar;
trace(myVar); // undefined

dynamic class A {}
var obj:A = new A()

// trace undefined property of obj
trace(obj.propName); // undefined

Crea un nuevo conjunto. El conjunto puede tener de longitud cero o más, o un conjunto que se llena con un solo objeto especificado.

• Al llamar a Array() sin argumentos, se devuelve un conjunto vacío.
• Al llamar a Array() con un solo argumento de número entero, se devuelve un conjunto con la longitud especificada, pero con elementos con valores undefined.
• Al llamar a Array() con un objeto especificado devuelve un conjunto con un elemento del objeto especificado.

Nota: Si intenta usar la función Array() para crear un nuevo conjunto y pasar varios valores como parámetros para llenar el conjunto, obtendrá un error del compilador. La función Array() sólo permite un parámetro. Utilice el constructor de la clase Array, en su lugar, para crear y llenar un conjunto de varios valores.

La función Array() no proyecta el tipo de un objeto en un conjunto. Utilice el operador as para conversión explícita de tipos cuando el argumento no sea un valor simple. Para más información, consulte la sección de Ejemplo de esta entrada. Si se pasa un objeto como un parámetro a la función Array(), un nuevo conjunto se crea con el objeto como un elemento.

Parámetros

Elementos de API relacionados

var obj:Object = [ "a", "b", "c" ];
      
var newArray:Array = Array( obj );

trace(newArray == obj);    // false
trace(newArray[0] == obj); // true
trace(newArray[0][0])      // a
trace(newArray[0][1])      // b
trace(newArray[0][2])      // c

var obj:Object = [ "a", "b", "c" ];
      
var newArray:Array = obj as Array;

trace(newArray == obj); // true
trace(newArray[0]);     // a
trace(newArray[1]);     // b
trace(newArray[2]);     // c

Convierte el parámetro expression en un valor booleano y devuelve el valor.

El valor devuelto depende del tipo de datos y el valor del argumento, como se describe en la siguiente tabla:

A diferencia de las versiones anteriores de ActionScript, la función Boolean() devuelve los mismos resultados que el constructor de la clase Boolean.

Parámetros

Descodifica un URI codificado para convertirlo en una cadena. Devuelve una cadena en la que todos los caracteres anteriormente codificados por la función encodeURI recuperan su representación sin codificar.

La siguiente tabla muestra el conjunto de secuencias de escape que no se codifican en caracteres mediante la función decodeURI. Utilice decodeURIComponent() para descodificar las secuencias de escape de esta tabla.

Parámetros

Elementos de API relacionados

package {
    import flash.display.Sprite;

    public class DecodeURIExample extends Sprite {
        public function DecodeURIExample() {
            var uri:String = "http://www.example.com/application.jsp?user=<user name='some user'></user>";
            var encoded:String = encodeURI(uri);
            var decoded:String = decodeURI(encoded);
            trace(uri);        // http://www.example.com/application.jsp?user=<user name='some user'></user>
            trace(encoded);    // http://www.example.com/application.jsp?user=%3Cuser%20name='some%20user'%3E%3C/user%3E
            trace(decoded);    // http://www.example.com/application.jsp?user=<user name='some user'></user>
        }
    }
}

Descodifica un componente URI codificado para convertirlo en una cadena. Devuelve una cadena en la que todos los caracteres previamente interpretados literalmente mediante la función encodeURIComponent recuperan su representación sin codificar.

Esta función difiere de la función decodeURI() en que está pensada para su uso exclusivo con una parte de una cadena URI conocida como componente URI. Un componente URI es cualquier texto que aparece entre los caracteres especiales conocidos como separadores de componente (: / ; y ? ). Ejemplos habituales de componente URI son "http" y "www.adobe.com".

Otra diferencia importante entre esta función y decodeURI() es que, dado que esta función da por hecho que está procesando un componente URI, trata las secuencias de escape que representan caracteres separadores especiales (; / ? : @ & = + $ , #) como texto normal que se debe descodificar.

Parámetros

Elementos de API relacionados

Codifica una cadena en un identificador de recurso uniforme (URI) válido. Convierte un URI completo en una cadena en la que todos los caracteres se codifican como secuencias de escape UTF-8, a no ser que un carácter pertenezca a un pequeño grupo de caracteres básicos.

En la siguiente tabla se muestra el conjunto completo de caracteres básicos que no se convierten en secuencias de escape UTF-8 mediante la función encodeURI.

Parámetros

Elementos de API relacionados

package {
    import flash.display.Sprite;

    public class EncodeURIExample extends Sprite {
        public function EncodeURIExample() {
            var uri:String = "http://www.example.com/application.jsp?user=<user name='some user'></user>";
            var encoded:String = encodeURI(uri);
            var decoded:String = decodeURI(encoded);
            trace(uri);        // http://www.example.com/application.jsp?user=<user name='some user'></user>
            trace(encoded);    // http://www.example.com/application.jsp?user=%3Cuser%20name='some%20user'%3E%3C/user%3E
            trace(decoded);    // http://www.example.com/application.jsp?user=<user name='some user'></user>
        }
    }
}

Codifica una cadena en un componente URI válido. Convierte una subcadena de un URI en una cadena en la que todos los caracteres se codifican como secuencias de escape UTF-8, a no ser que un carácter pertenezca a un grupo muy pequeño de caracteres básicos.

La función encodeURIComponent() difiere de la función encodeURI() en que está pensada para su uso exclusivo con una parte de una cadena URI conocida como componente URI. Un componente URI es cualquier texto que aparece entre los caracteres especiales conocidos como separadores de componente (: / ; y ? ). Ejemplos habituales de componente URI son "http" y "www.adobe.com".

Otra diferencia importante entre esta función y encodeURI() es que, dado que esta función da por hecho que está procesando un componente URI, trata los caracteres separadores especiales (; / ? : @ & = + $ , #) como texto normal que se debe codificar.

En la siguiente tabla se muestran todos los caracteres que no se convierten en secuencias de escape UTF-8 mediante la función encodeURIComponent.

Parámetros

Elementos de API relacionados

Convierte el parámetro en una cadena y la codifica con un formato de codificación URL donde la mayoría de los caracteres no alfanuméricos se sustituyen por secuencias hexadecimales %. Si se utiliza en una cadena con codificación URL, el símbolo de porcentaje (%) introduce caracteres de escape y no equivale al operador de módulo (%).

En la siguiente tabla se muestran todos los caracteres que no se convierten en secuencias de escape mediante la función escape().

Nota: utilice la función encodeURIComponent() en lugar de la función escape() para tratar caracteres de separador especiales (@ + /) como texto normal para codificar.

Parámetros

Elementos de API relacionados

Convierte un determinado valor numérico en un valor de entero. Las cifras decimales se truncan en la coma decimal.

Parámetros

Elementos de API relacionados

Devuelve true si el valor es un número finito, o false si el valor es Infinity o -Infinity. La presencia de Infinity o -Infinity indica un error matemático como, por ejemplo, la división por 0.

Parámetros

Devuelve true si el valor es NaN (no es un número). La función isNaN() es útil para comprobar si una expresión matemática da como resultado un número. El uso más habitual de isNaN() es comprobar el valor devuelto por las funciones parseInt() y parseFloat(). El valor NaN es un miembro especial del tipo de datos Number que representa un valor que "no es un número".

Nota: el valor NaN no es miembro de los tipos de datos int o uint.

En la tabla siguiente se describen el valor de devolución isNaN() en diversos tipos y valores de entrada. (Si las advertencias del compilador están configuradas en modo estricto, algunas de las operaciones siguientes activarán advertencias del compilador.)

Parámetros

Determina si la cadena especificada es un nombre válido para un elemento o atributo XML.

Parámetros

Convierte un determinado valor en un valor de tipo Number. En la siguiente tabla se muestra el resultado de diversos tipos de entrada:

Parámetros

En ActionScript 3.0, todos los valores son objetos, lo que significa que, al llamar a Object() en un valor, se devuelve dicho valor.

Parámetros

Convierte una cadena en un número de coma flotante. La función lee, o analiza, y devuelve los números en una cadena hasta que se alcanza un carácter que no forma parte del número inicial. Si la cadena no empieza por un número que pueda analizarse, parseFloat() devuelve NaN. Se ignoran los espacios en blanco que preceden a los enteros válidos, pues se trata de caracteres no numéricos finales.

Parámetros

Convierte una cadena en un entero. Si la cadena especificada en los parámetros no puede convertirse en un número, la función devuelve NaN. Las cadenas que empiezan con 0x se interpretan como números hexadecimales. A diferencia de las versiones anteriores de ActionScript, los enteros que comienzan por 0 no se interpretan como números octales. Debe especificar una base (radix) de 8 para números octales. Los espacios en blanco y los ceros que preceden a los enteros válidos no se tienen en cuenta, como tampoco se tienen en cuenta los caracteres no numéricos finales.

Parámetros

Devuelve una representación de cadena del parámetro especificado.

En la siguiente tabla se muestra el resultado de diversos tipos de entrada:

Parámetros

Muestra expresiones o escribe en archivos de registro durante la depuración. Una misma sentencia trace admite varios argumentos. Si alguno de los argumentos de una sentencia trace incluye un tipo de datos diferente de String, la función trace invoca el método toString() asociado para dicho tipo de datos. Por ejemplo, si el argumento es un valor booleano, la función trace invocará Boolean.toString() y mostrará el valor de devolución.

Parámetros

package {
    import flash.display.Sprite;

    public class TraceExample extends Sprite {

        public function TraceExample() {
            trace("Hello World");
        }
    }
}

Convierte un determinado valor numérico en un valor de entero sin signo. Las cifras decimales se truncan en la coma decimal.

En la tabla siguiente se describen el valor de devolución uint() en diversos tipos y valores de entrada.

Parámetros

Elementos de API relacionados

Evalúa el parámetro str como una cadena, descodifica la cadena con formato de codificación URL (convirtiendo todas las secuencias hexadecimales en caracteres ASCII) y devuelve la cadena.

Parámetros

Crea una nueva instancia de Vector con elementos que son instancias del tipo de datos especificado. Cuando se llama a esta función, se debe especificar el tipo de datos de los elementos del vector resultante (el tipo base del vector) mediante un parámetro type. Esta función utiliza la misma sintaxis que al declarar una instancia de Vector o al llamar al constructor new Vector.<T>():

var v:Vector.<String> = Vector.<String>(["Hello", "World"]);

El vector resultante se llena con los valores de los elementos del argumento sourceArray. Si el argumento sourceArray ya es una instancia de Vector.<T>, donde T es el tipo base, la función devuelve dicho vector. En caso contrario, el vector resultante se llena con los elementos del conjunto o el vector sourceArray.

En cualquier caso, el tipo de datos de todos los elementos del argumento sourceArray debe coincidir con el tipo base T especificado en la llamada a la función.

Si el argumento sourceArray tiene longitud 0, la función devuelve un vector vacío.

Si se transfiere un vector como argumento sourceArray y su tipo base no es T, o si se transfiere un conjunto y sus elementos no son todos instancias de tipo de datos T, se intenta convertir los valores en el tipo base. Si los valores se pueden convertir automáticamente, el vector resultante los contiene. Si no es posible realizar la conversión, se produce un error.

Del mismo modo, si un elemento del argumento sourceArray es una instancia de una subclase de tipo base T, la llamada se realiza correctamente y el elemento se añade al vector resultante. Este procedimiento es válido incluso si el argumento sourceArray es un vector cuyo tipo base es una subclase de T. De hecho, éste es el único modo de convertir un vector con tipo base T en un vector con un tipo base que sea una superclase de T.

Por ejemplo, el código siguiente genera un error de compilación en modo estricto o un error TypeError en tiempo de ejecución, ya que intenta asignar un Vector.<Sprite> a una variable de Vector.<DisplayObject> (Sprite es una subclase de DisplayObject):

     var v1:Vector.<Sprite> = new Vector.<Sprite>();
     v1[0] = new Sprite();
     var v2:Vector.<DisplayObject> = v1;
     

La siguiente versión alternativa del código consigue copiar los elementos de una instancia de Vector.<Sprite> en una instancia de Vector.<DisplayObject>:

     var v1:Vector.<Sprite> = new Vector.<Sprite>();
     v1[0] = new Sprite();
     var v2:Vector.<DisplayObject> = Vector.<DisplayObject>(v1);
     

Parámetros

Elementos de API relacionados

Convierte un objeto en un objeto XML.

En la siguiente tabla se describen los valores devueltos para diversos tipos de entrada.

Parámetros

Elementos de API relacionados

Convierte un objeto en un objeto XMLList.

En la siguiente tabla se describen los valores devueltos para diversos tipos de entrada.

Parámetros

Elementos de API relacionados