Las funciones de nivel superior o globales están disponibles en cualquier parte de un archivo SWF en el que se utiliza ActionScript o en cualquier clase definida por el usuario. La mayoría de las funciones globales de ActionScript 2.0 han sido migradas a clases.
Funciones globales
| | Función | Definido por |
| | |
Crea una nueva matriz.
| Top Level |
| | |
Convierte el parámetro expression en un valor booleano y devuelve el valor.
| Top Level |
| | |
Devuelve una representación de cadena (String) del día, la fecha, la hora y la zona horaria actuales.
| Top Level |
| | |
Descodifica un URI codificado para convertirlo en una cadena.
| Top Level |
| | |
Descodifica un componente URI codificado para convertirlo en una cadena.
| Top Level |
| | |
Codifica una cadena en un identificador de recurso uniforme (URI) válido.
| Top Level |
| | |
Codifica una cadena en un componente URI válido.
| Top Level |
| | |
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 %.
| Top Level |
| | |
Convierte un determinado valor numérico en un valor de entero.
| Top Level |
| | |
Devuelve true si el valor es un número finito, o false si el valor es Infinity o -Infinity.
| Top Level |
| | |
Devuelve true si el valor es NaN (no es un número).
| Top Level |
| | |
Determina si la cadena especificada es un nombre válido para un elemento o atributo XML.
| Top Level |
| | |
Convierte un determinado valor en un valor de tipo Number.
| Top Level |
| | |
En ActionScript 3.0, todos los valores son objetos, lo que significa que, al llamar a Object() en un valor, se devuelve dicho valor.
| Top Level |
| | |
Convierte una cadena en un número de coma flotante.
| Top Level |
| | |
Convierte una cadena en un entero.
| Top Level |
| | |
Devuelve una representación de cadena del parámetro especificado.
| Top Level |
| | |
Muestra expresiones o escribe en archivos de registro durante la depuración.
| Top Level |
| | |
Convierte un determinado valor numérico en un valor de entero sin signo.
| Top Level |
| | |
Evalúa el parámetro str como una cadena, descodifica la cadena con formato URL codificado (convirtiendo todas las secuencias hexadecimales en caracteres ASCII) y devuelve la cadena.
| Top Level |
| | |
Convierte un objeto en un objeto XML.
| Top Level |
| | |
Convierte un objeto en un objeto XMLList.
| Top Level |
El nivel superior o las constantes globales están disponibles en cada script y son visibles en todas las líneas de tiempo y ámbitos del documento.
Constantes globales
| | Constante | Definido por |
| | | Infinity : Number
Valor especial que representa Infinity (infinito) positivo.
| Top Level |
| | | -Infinity : Number
Valor especial que representa Infinity (infinito) negativo.
| Top Level |
| | | NaN : Number
Miembro especial del tipo de datos Number que representa un valor que "no es un número" (NaN).
| Top Level |
| | | undefined : *
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.
| Top Level |
public const Infinity:Number
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Valor especial que representa Infinity (infinito) positivo. El valor de esta constante es igual que Number.POSITIVE_INFINITY.
Véase también
Ejemplo
El resultado de la división entre 0 es
Infinity, pero sólo si el divisor es un número positivo.
trace(0 / 0); // NaN
trace(7 / 0); // Infinity
trace(-7 / 0); // -Infinity
public const -Infinity:Number
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Valor especial que representa Infinity (infinito) negativo. El valor de esta constante es igual que Number.NEGATIVE_INFINITY.
Véase también
Ejemplo
El resultado de la división entre 0 es
-Infinity, pero sólo si el divisor es un número negativo.
trace(0 / 0); // NaN
trace(7 / 0); // Infinity
trace(-7 / 0); // -Infinity
public const NaN:Number
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
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().
Véase también
public const undefined:*
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
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:
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.
Véase también
Ejemplo
En el siguiente ejemplo, se declara una variable sin tipo
myVar pero no se inicializa. El valor de
myVar es
undefined porque la variable no tiene tipo asignado. Esto se cumple si la variable no tiene ninguna anotación de tipo o si utiliza anotación especial sin tipo asignado
var myVar:*;).
// trace value of untyped and uninitialized variable
var myVar;
trace(myVar); // undefined
Se aplica la misma regla a las propiedades no inicializadas de un objeto dinámico. Por ejemplo, si tenemos una instancia,
obj, de la clase dinámica
A, el valor de
obj.propName, que es una propiedad no inicializada de la instancia
obj, será
undefined.
dynamic class A {}
var obj:A = new A()
// trace undefined property of obj
trace(obj.propName); // undefined
public function Array(... args):Array
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Crea una nueva matriz. La matriz puede tener longitud cero o superior, o una matriz con una lista de elementos especificados, posiblemente de distintos tipos de datos. El número y el tipo de datos de los argumentos que utilice determinarán el contenido de la matriz devuelta.
- Al llamar a
Array() sin argumentos, se devuelve una matriz vacía.
- Al llamar a
Array() con un solo argumento de número entero, se devuelve una matriz con la longitud especificada, pero con elementos con valores undefined.
- Al llamar a
Array() con una lista de valores específicos, se devuelve una matriz con elementos que contienen cada uno de los valores especificados.
El uso de la función
Array() es similar a la creación de una matriz con el constructor de la clase Array.
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.
Parámetros
| ... args — Puede no pasar ningún argumento para una matriz vacía, pasar un solo argumento de número entero para un matriz de una longitud específica o pasar una serie de valores separados por comas de diversos tipos para una matriz que se llena con dichos valores.
|
Valor devuelto
| Array — Una matriz de longitud cero o superior.
|
Véase también
Ejemplo
El siguiente ejemplo muestra el comportamiento de la función
Array() cuando un argumento no es un valor simple. Una situación típica en la que se convierte una matriz es la conversión de una instancia de Object que guarda sus valores en formato matricial. Si se llama a
Array() con un argumento de tipo
Object, o cualquier otro tipo de datos no simples, se guarda una referencia al objeto en un elemento de la nueva matriz. Dicho de otro modo, si el único argumento transferido es un objeto, una referencia a dicho objeto pasa a ser el primer elemento de la nueva matriz.
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
Para convertir
obj en una matriz, utilice el operador
as, que devuelve cualquier referencia de la matriz si
obj es una matriz válida y que devuelve
null en cualquier otro caso:
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
public function Boolean(expression:Object):Boolean
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
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:
| Valor de entrada | Ejemplo | Valor devuelto |
0 | Boolean(0) | false |
NaN | Boolean(NaN) | false |
Number (no 0 ni NaN) | Boolean(4) | true |
| Cadena vacía | Boolean("") | false |
| Cadena no vacía | Boolean("6") | true |
null | Boolean(null) | false |
undefined | Boolean(undefined) | false |
| Instancia de la clase Object | Boolean(new Object()) | true |
| Sin argumentos | Boolean() | false |
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
| expression:Object — Una expresión u objeto para convertir a Boolean.
|
Valor devuelto
| Boolean — El resultado de la conversión a Boolean.
|
Véase también
public function Date():String
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Devuelve una representación de cadena (String) del día, la fecha, la hora y la zona horaria actuales. El formato de fecha para la salida es:
Día Mes Fecha HH:MM:SS TZD AAAA
Por ejemplo:
Miércoles Abril 12 15:30:17 GMT-0700 2006
Para convertir un valor al tipo Date, utilice x as Date en lugar de Date(x).
Valor devuelto
| String — La fecha actual como un tipo de datos String. El valor devuelto para Date() es el mismo que el devuelto para Date.toString().
|
Véase también
public function decodeURI(uri:String):String
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
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.
| Secuencias de escape no descodificadas | Caracteres equivalentes |
%23 | # |
%24 | $ |
%26 | & |
%2B | + |
%2C | , |
%2F | / |
%3A | : |
%3B | ; |
%3D | = |
%3F | ? |
%40 | @ |
Parámetros
| uri:String — Una cadena codificada con la función encodeURI.
|
Valor devuelto
| String — Una cadena en la que todos los caracteres que previamente se han interpretado literalmente mediante la función encodeURI recuperan su representación sin interpretación literal.
|
Véase también
Ejemplo
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>
}
}
}
public function decodeURIComponent(uri:String):String
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
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
| uri:String — Una cadena codificada con la función encodeURIComponent.
|
Valor devuelto
| String — Una cadena en la que todos los caracteres que previamente se han interpretado literalmente mediante la función encodeURIComponent recuperan su representación sin interpretación literal.
|
Véase también
public function encodeURI(uri:String):String
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
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.
| Caracteres no codificados |
0 1 2 3 4 5 6 7 8 9 |
a b c d e f g h i j k l m n o p q r s t u v w x y z |
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z |
; / ? : @ & = + $, # |
- _. ! ~ * ' ( ) |
Parámetros
| uri:String — Una cadena que representa un URI completo.
|
Valor devuelto
| String — Una cadena que tiene determinados caracteres codificados como secuencias de escape UTF-8.
|
Véase también
Ejemplo
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>
}
}
}
public function encodeURIComponent(uri:String):String
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
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.
| Caracteres no codificados |
0 1 2 3 4 5 6 7 8 9 |
a b c d e f g h i j k l m n o p q r s t u v w x y z |
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z |
- _. ! ~ * ' ( ) |
Parámetros
| uri:String — Una cadena que representa un URI completo.
|
Valor devuelto
| String — Una cadena que tiene determinados caracteres codificados como secuencias de escape UTF-8.
|
Véase también
public function escape(str:String):String
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
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().
| Caracteres no codificados |
0 1 2 3 4 5 6 7 8 9 |
a b c d e f g h i j k l m n o p q r s t u v w x y z |
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z |
@ - _. * + / |
Parámetros
| str:String — Expresión que se va a convertir en una cadena y codificar en un formato de codificación URL.
|
Valor devuelto
| String — Una cadena con codificación URL.
|
Véase también
public function int(value:Number):int
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Convierte un determinado valor numérico en un valor de entero. Las cifras decimales se truncan en la coma decimal.
Parámetros
| value:Number — Un valor que se va a convertir en un entero.
|
Valor devuelto
| int — El valor de entero convertido.
|
Véase también
public function isFinite(num:Number):Boolean
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
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
| num:Number — Número que se va evaluar como finito o infinito.
|
Valor devuelto
| Boolean — Devuelve true si es un número finito o false si es infinito o infinito negativo.
|
public function isNaN(num:Number):Boolean
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
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 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.
| Tipo/valor de entrada | Ejemplo | Valor devuelto |
| 0 dividido por 0 | isNaN(0/0) | true |
Número distinto de cero dividido por 0 | isNaN(5/0) | false |
| Raíz cuadrada de un número negativo | isNaN(Math.sqrt(-1)) | true |
| Arcoseno de un número mayor que 1 o menor que 0 | isNaN(Math.asin(2)) | true |
| Cadena que puede convertirse a Number | isNaN("5") | false |
| Cadena que no puede convertirse a Number | isNaN("5a") | true |
Parámetros
| num:Number — Valor numérico o expresión matemática que se va a evaluar.
|
Valor devuelto
| Boolean — Devuelve true si el valor es NaN (no es un número) y false en caso contrario.
|
public function isXMLName(str:String):Boolean
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Determina si la cadena especificada es un nombre válido para un elemento o atributo XML.
Parámetros
| str:String — Cadena que se va a evaluar.
|
Valor devuelto
| Boolean — Devuelve true si el argumento str es un nombre XML válido; en caso contrario, devuelve false.
|
public function Number(expression:Object):Number
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Convierte un determinado valor en un valor de tipo Number. En la siguiente tabla se muestra el resultado de diversos tipos de entrada:
| Tipo/valor de entrada | Ejemplo | Valor devuelto |
undefined | Number(undefined) | NaN |
null | Number(null) | 0 |
true | Number(true) | 1 |
false | Number(false) | 0 |
NaN | Number(NaN) | NaN |
| Cadena vacía | Number("") | 0 |
| Cadena que se convierte a Number | Number("5") | El número (por ejemplo, 5) |
| Cadena que no se convierte a Number | Number("5a") | NaN |
Parámetros
| expression:Object — Un valor que se va a convertir en un número.
|
Valor devuelto
| Number — El valor de número convertido.
|
Véase también
public function Object(value:Object):Object
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
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
| value:Object — Objeto o número, cadena o valor booleano que se va a convertir.
|
Valor devuelto
| Object — El valor especificado por el parámetro value.
|
Véase también
public function parseFloat(str:String):Number
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
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
| str:String — Cadena que se va a leer y convertir en un número de coma flotante.
|
Valor devuelto
| Number — Un número o NaN (no es un número).
|
public function parseInt(str:String, radix:uint = 0):Number
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
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
| str:String — Cadena que se va a convertir en un entero.
|
| |
| radix:uint (default = 0) — Entero que representa la base (radix) del número que se va a analizar. Los valores válidos van de 2 a 36.
|
Valor devuelto
| Number — Un número o NaN (no es un número).
|
public function String(expression:Object):String
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Devuelve una representación de cadena del parámetro especificado.
En la siguiente tabla se muestra el resultado de diversos tipos de entrada:
| Tipo/valor de entrada | Valor devuelto |
undefined | undefined |
null | "null" |
true | "true" |
false | "false" |
NaN | "NaN" |
| String | String |
| Object | Object.toString() |
| Number | Representación de cadena del número |
Parámetros
| expression:Object — Expresión para convertir en una cadena.
|
Valor devuelto
| String — Una representación de cadena del valor pasado para el parámetro expression.
|
Véase también
public function trace(... arguments):void
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
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
| ... arguments — Una o varias expresiones (separadas por comas) que se van a evaluar. En el caso de que haya varias expresiones, en la salida se introduce un espacio entre las expresiones.
|
Ejemplo
El siguiente ejemplo utiliza la clase
TraceExample para mostrar cómo se puede utilizar el método
trace() para imprimir una cadena sencilla. Por norma general, el mensaje se imprimirá en una consola "de depuración".
package {
import flash.display.Sprite;
public class TraceExample extends Sprite {
public function TraceExample() {
trace("Hello World");
}
}
}
public function uint(value:Number):uint
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
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.
| Tipo/valor de entrada | Ejemplo | Valor devuelto |
undefined | uint(undefined) | 0 |
null | uint(null) | 0 |
0 | uint(0) | 0 |
NaN | uint(NaN) | 0 |
| Número positivo de coma flotante | uint(5,31) | Entero truncado sin signo (por ejemplo, 5) |
| Número negativo de coma flotante | uint(-5,78) | Se trunca para dejar sólo un entero y luego se le aplica la regla para enteros negativos |
| Entero negativo | uint(-5) | Suma de uint.MAX_VALUE y el entero negativo (por ejemplo, uint.MAX_VALUE + (-5)) |
true | uint(true) | 1 |
false | uint(false) | 0 |
| Cadena vacía | uint("") | 0 |
| Cadena que se convierte a Number | uint("5") | El número |
| Cadena que no se convierte a Number | uint("5a") | 0 |
Parámetros
| value:Number — Un valor que se va a convertir en un entero.
|
Valor devuelto
| uint — El valor de entero convertido.
|
Véase también
public function unescape(str:String):String
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
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
| str:String — Cadena con secuencias hexadecimales que se van a interpretar literalmente.
|
Valor devuelto
| String — Cadena descodificada de un parámetro URL codificado.
|
public function XML(expression:Object):XML
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Convierte un objeto en un objeto XML.
En la siguiente tabla se describen los valores devueltos para diversos tipos de entrada.
| Tipo de parámetro | Valor devuelto |
| Boolean | El valor se convierte primero en una cadena y luego se convierte en un objeto XML. |
| Null | Se produce un error de tiempo de ejecución (excepción TypeError). |
| Number | El valor se convierte primero en una cadena y luego se convierte en un objeto XML. |
| Object | Convierte a XML sólo si el valor es de tipo String, Number o Boolean. En caso contrario, se produce un error de tiempo de ejecución (excepción TypeError). |
| String | El valor se convierte a XML. |
| Undefined | Se produce un error de tiempo de ejecución (excepción TypeError). |
| XML | El valor de entrada se devuelve sin cambios. |
| XMLList | Devuelve un objeto XML sólo si el objeto XMLList contiene exclusivamente una propiedad de tipo XML. En caso contrario, se produce un error de tiempo de ejecución (excepción TypeError). |
Parámetros
| expression:Object — Objeto que se va a convertir a XML.
|
Valor devuelto
| XML — Un objeto XML que contiene valores almacenados en el objeto convertido.
|
Véase también
public function XMLList(expression:Object):XMLList
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Convierte un objeto en un objeto XMLList.
En la siguiente tabla se describen los valores devueltos para diversos tipos de entrada.
| Tipo de parámetro | Valor devuelto |
| Boolean | El valor se convierte primero en una cadena y luego se convierte en un objeto XMLList. |
| Null | Se produce un error de tiempo de ejecución (excepción TypeError). |
| Number | El valor se convierte primero en una cadena y luego se convierte en un objeto XMLList. |
| Object | Convierte a XMLList sólo si el valor es de tipo String, Number o Boolean. En caso contrario, se produce un error de tiempo de ejecución (excepción TypeError). |
| String | El valor se convierte en un objeto XMLList. |
| Undefined | Se produce un error de tiempo de ejecución (excepción TypeError). |
| XML | El valor se convierte en un objeto XMLList. |
| XMLList | El valor de entrada se devuelve sin cambios. |
Parámetros
| expression:Object — Objeto que se va a convertir en un objeto XMLList.
|
Valor devuelto
| XMLList — Un objeto XMLList que contiene valores almacenados en el objeto convertido.
|
Véase también
© 2004-2007 Adobe Systems Incorporated. Todos los derechos reservados.
Fri Oct 12 2007, 2:49 AM GMT-07:00
Página actual: http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/package.html