Nível superior 

Um valor especial que representa Infinity negativo. O valor dessa constante é idêntico a Number.NEGATIVE_INFINITY.

Elementos da API relacionados

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

Um valor especial que representa Infinity positivo. O valor dessa constante é idêntico a Number.POSITIVE_INFINITY.

Elementos da API relacionados

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

Um membro especial do tipo de dados Number que representa um valor NaN ("não é um número"). Quando uma expressão matemática resulta em um valor que não pode ser expressado como número, o resultado é NaN. A lista a seguir descreve expressões comuns que resultam em NaN.

• A divisão por 0 resultará em NaN apenas se o divisor também for 0. Se o divisor for maior do que 0, a divisão por 0 resultará em Infinity. Se o divisor for menor do que 0, a divisão por 0 resultará em -Infinity;
• Raiz quadrada de um número negativo;
• O seno de arco de um número fora da faixa válida de 0 a 1;
• Infinity subtraído de Infinity;
• Infinity ou -Infinity dividido por Infinity ou -Infinity;
• Infinity ou -Infinity multiplicado por 0;

O valor NaN não é um membro dos tipos de dados int ou uint.

O valor NaN não é considerado igual a nenhum outro valor, incluindo NaN, o que torna impossível usar o operador de igualdade para testar se uma expressão é NaN. Para determinar se um número é a função NaN, use isNaN().

Elementos da API relacionados

Um valor especial que se aplica a variáveis sem tipo que não foram inicializadas ou a propriedades de objetos dinâmicos que não são inicializadas. No ActionScript 3.0, apenas as variáveis sem tipo podem conter o valor undefined, o que não ocorre no ActionScript 1.0 e no ActionScript 2.0. Por exemplo, ambas as variáveis a seguir são undefined porque não têm tipo e não são inicializadas:

• var foo;
• var bar:*;

O valor undefined também se aplica a propriedades não inicializadas ou indefinidas de objetos dinâmicos. Por exemplo, se um objeto for uma ocorrência da classe Object, o valor de qualquer propriedade dinamicamente adicionada será undefined até que um valor seja atribuído a essa propriedade.

Os resultados variam quando undefined é usado com várias funções:

• O valor retornado por String(undefined) é "undefined" (undefined é convertido em string).
• O valor retornado por Number(undefined) é NaN.
• O valor retornado por int(undefined) e uint(undefined) é 0.
• O valor retornado por Object(undefined) é uma nova ocorrência de Object.
• Quando o valor undefined é atribuído a uma variável com tipo, ele é convertido no valor padrão do tipo de dados.

Não confunda undefined com null. Quando null e undefined são comparados com o operador de igualdade (==), eles são comparados como iguais. Entretanto, quando null e undefined são comparados com o operador de igualdade estrita (===), eles são comparados como não iguais.

Elementos da 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

Cria uma nova matriz. O comprimento da matriz pode ser zero ou mais, ou uma matriz preenchida por um único objeto especificado.

• Chamar Array() sem argumentos retorna uma matriz vazia.
• Chamar Array() com um argumento de inteiro simples retorna uma matriz do comprimento especificado, mas cujos elementos têm valores indefinidos.
• Chamar Array() com um objeto especificado retorna uma matriz com um elemento do objeto especificado.

Nota: se você tenta usar a função Array() para criar uma nova matriz, e passar vários valores como parâmetros para preencher a matriz, receberá um erro de compilador. A função Array() permite apenas um parâmetro. Em vez disso, use o construtor da classe Array para criar e preencher uma matriz com vários valores.

A função Array() não converte o tipo de um objeto em uma matriz. Use o operador as para conversão de tipo explícito, ou transmissão, quando o argumento não for um valor primitivo. Para obter mais informações, consulte a seção Exemplo desta parte. Se você passar um objeto como parâmetro para a função Array(), uma nova matriz será criada contendo o objeto como um elemento.

Parâmetros

Elementos da 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

Converte o parâmetro expression em um valor booliano e retorna o valor.

O valor de retorno depende do tipo de dados e do valor do argumento, conforme descrito na tabela a seguir:

Ao contrário das versões anteriores do ActionScript, a função Boolean() retorna os mesmos resultados que o construtor da classe Boolean.

Parâmetros

Decodifica um URI codificado em uma string. Retorna uma string na qual todos os caracteres previamente codificados pela função encodeURI são restaurados para sua representação sem codificação.

A tabela a seguir mostra o conjunto de sequências de escape que não são decodificadas para caracteres pela função decodeURI. Use decodeURIComponent() para decodificar as sequências de escape nessa tabela.

Parâmetros

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

Decodifica um componente de URI codificado em uma string. Retorna uma string na qual todos os caracteres previamente escapados pela função encodeURIComponent são restaurados para sua representação sem codificação.

Essa função é diferente da função decodeURI() porque serve para uso somente com uma parte de uma string de URI, chamada de componente do URI. Um componente de URI é qualquer texto que aparece entre caracteres especiais, chamados de separadores de componentes (: / ; e ? ). Exemplos comuns de um componente de URI são "http" e "www.adobe.com".

Outra importante diferença entre essa função e decodeURI() é que, como essa função pressupõe estar processando um componente de URI, ela trata as sequências de escape que representam os caracteres separadores especiais (; / ? : @ & = + $ , #) como texto regular que deve ser decodificado.

Parâmetros

Elementos da API relacionados

Codifica uma string em um URI (Identificador uniforme de recursos) válido. Converte um URI completo em uma string na qual todos os caracteres são codificados como sequências de escape UTF-8, a menos que um caractere pertença a um pequeno grupo de caracteres básicos.

A tabela a seguir mostra o conjunto inteiro de caracteres básicos que não são convertidos em sequências de escape UTF-8 pela função encodeURI.

Parâmetros

Elementos da 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 uma string em um componente de URI válido. Converte uma substring de um URI em uma string na qual todos os caracteres são codificados como sequências de escape UTF-8, a menos que um caractere pertença a um grupo bem pequeno de caracteres básicos.

A função encodeURIComponent() é diferente da função encodeURI() porque serve para uso somente com uma parte de uma string de URI, chamada de componente do URI. Um componente de URI é qualquer texto que aparece entre caracteres especiais, chamados de separadores de componentes (: / ; e ? ). Exemplos comuns de um componente de URI são "http" e "www.adobe.com".

Outra importante diferença entre essa função e encodeURI() é que, como essa função pressupõe estar processando um componente de URI, ela trata os caracteres separadores especiais (; / ? : @ & = + $ , #) como texto regular que deve ser codificado.

A tabela a seguir mostra todos os caracteres que não são convertidos em sequências de escape UTF-8 pela função encodeURIComponent.

Parâmetros

Elementos da API relacionados

Converte o parâmetro em uma string e a codifica em formato codificado em URL, no qual a maioria dos caracteres não alfanuméricos é substituída por sequências hexadecimais %. Quando usado em uma string codificada para URL, o símbolo de porcentagem (%) é usado para introduzir caracteres de escape e não é equivalente ao operador de módulo (%).

A tabela a seguir mostra todos os caracteres que não são convertidos em sequências de escape pela função escape().

Nota: use a função encodeURIComponent(), em vez da função escape(), para tratar caracteres de separador especiais (@ + /) como texto comum a ser codificado.

Parâmetros

Elementos da API relacionados

Converte um valor numérico especificado em um valor inteiro. Valores decimais são truncados no ponto decimal.

Parâmetros

Elementos da API relacionados

Retornará true se o valor for um número finito ou false se o valor for Infinity ou -Infinity. A presença de Infinity ou -Infinity indica uma condição de erro matemático, como divisão por 0.

Parâmetros

Retornará true se o valor for NaN (não é um número). A função isNaN() é útil para verificar se uma expressão matemática é avaliada com êxito para um número. O uso mais comum de isNaN() é verificar o valor retornado pelas funções parseInt()e parseFloat(). Um valor NaN é um membro especial do tipo de dados Number que representa um valor que "não é um número".

Nota: o valor NaN não é um membro dos tipos de dados int ou uint.

A tabela a seguir descreve o valor de retorno de isNaN() em vários tipos e valores de entrada. (Se os avisos do compilador forem definidos para o modo estrito, algumas das operações a seguir gerarão avisos.)

Parâmetros

Determina se a string especificada é um nome válido para um elemento ou atributo XML.

Parâmetros

Converte um valor especificado em um valor de Number. A tabela a seguir mostra o resultado de vários tipos de entrada:

Parâmetros

Cada valor no ActionScript 3.0 é um objeto, o que significa que chamar Object() em um valor retorna esse valor.

Parâmetros

Converte uma string em um número de ponto flutuante. A função lê, ou analisa, e retorna os números em uma string até alcançar um caractere que não faça parte do número inicial. Se a string não começar com um número que possa ser analisado, parseFloat() retornará NaN. O espaço em branco que precede inteiros válidos é ignorado, como no caso de caracteres não numéricos à direita.

Parâmetros

Converte uma string em um inteiro. Se a string especificada nos parâmetros não puder ser convertida em número, a função retornará NaN. Strings que começam com 0x são interpretadas como números hexadecimais. Ao contrário de versões anteriores do ActionScript, inteiros que começam com 0 não são interpretados como números de base 8. É necessário especificar uma raiz de 8 para números de base 8. O espaço em branco e os zeros que precedem inteiros válidos são ignorados, como no caso de caracteres não numéricos à direita.

Parâmetros

Retorna uma representação de string do parâmetro especificado.

A tabela a seguir mostra o resultado de vários tipos de entrada:

Parâmetros

Exibe expressões, ou grava em arquivos de log, durante a depuração. Uma instrução de rastreamento simples pode oferecer suporte a vários argumentos. Se qualquer argumento em uma instrução de rastreamento incluir um tipo de dados diferente de String, a função de rastreamento chamará o método toString() associado a esse tipo de dados. Por exemplo, se o argumento for um valor booliano, a função de rastreamento chamará Boolean.toString() e exibirá o valor de retorno.

Parâmetros

package {
    import flash.display.Sprite;

    public class TraceExample extends Sprite {

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

Converte um valor numérico especificado em um valor inteiro não assinado. Valores decimais são truncados no ponto decimal.

A tabela a seguir descreve o valor de retorno de uint() em vários tipos e valores de entrada.

Parâmetros

Elementos da API relacionados

Avalia o parâmetro str como uma string, decodifica a string a partir do formato codificado em URL (convertendo todas as sequências hexadecimais em caracteres ASCII) e retorna essa string.

Parâmetros

Cria uma nova ocorrência do Vector, cujos elementos são ocorrências do tipo de dados especificado. Ao chamar esta função, especifique o tipo de dados dos elementos do Vector resultante (o tipo base do Vector) usando um parâmetro de tipo. Esta função usa a mesma sintaxe usada na declaração de uma ocorrência do Vector ou na chamada do construtor new Vector.<T>():

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

O Vector resultante é preenchido com os valores dos elementos do argumento sourceArray. Se o argumento sourceArray já for uma ocorrência Vector.<T>, em que T é o tipo base, a função retornará esse Vector. Caso contrário, o Vector resultante será preenchido com os elementos da Matriz ou Vector sourceArray.

Em qualquer um dos casos, o tipo de dados de todos os elementos do argumento sourceArray deve corresponder ao tipo base T especificado na chamada de função.

Se o argumento sourceArray tiver length 0, a função retornará um Vector vazio.

Se um Vector for transmitido como o argumento sourceArray e seu tipo base não for T, ou se uma Matriz for transmitida e seus elementos não forem ocorrências de tipo de dados T, será feita uma tentativa de conversão dos valores para o tipo base. Se os valores puderem ser automaticamente convertidos, o Vector resultante conterá os valores convertidos. Se não for possível fazer a conversão, ocorrerá um erro.

Da mesma forma, se um elemento no argumento sourceArray for uma ocorrência de uma subclasse do tipo base T, a chamada será bem-sucedida e o elemento será adicionado ao Vector resultante. Isso funcionará mesmo que o argumento sourceArray seja um Vector cujo tipo base é uma subclasse de T. Na verdade, essa é a única forma de converter um Vector com tipo base T em um Vector com tipo base que seja uma subclasse de T.

Por exemplo, o código a seguir resulta em erro de compilação no modo estrito, ou em TypeError no tempo de execução, porque ele tenta atribuir Vector.<Sprite> a uma variável Vector.<DisplayObject> (Sprite é uma subclasse de DisplayObject):

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

A seguinte versão alternativa do código copia com sucesso os elementos de uma ocorrência Vector.<Sprite> em uma ocorrência Vector.<DisplayObject>:

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

Parâmetros

Elementos da API relacionados

Converte um objeto em um objeto XML.

A tabela a seguir descreve os valores de retorno para vários tipos de entrada.

Parâmetros

Elementos da API relacionados

Converte um objeto em um objeto XMLList.

A tabela a seguir descreve os valores de retorno para vários tipos de entrada.

Parâmetros

Elementos da API relacionados