Vector  - AS3

Indica se a propriedade length do Vector pode ser alterada. Se o valor for true, a propriedade length não poderá ser alterada. Isso significa que as seguintes operações não serão seguidas quando fixed for true:

• definir a propriedade length diretamente
• atribuir um valor à posição do índice length
• chamar um método que altere a propriedade length, incluindo:
  • pop()
  • push()
  • shift()
  • unshift()
  • splice() (se a chamada splice() alterar o length do Vector).

O intervalo de índices válidos disponíveis no Vector. Uma ocorrência de Vector tem posições de índice até, mas não incluindo, o valor de length.

Todo elemento do Vector sempre tem um valor que é uma ocorrência do tipo base ou null. Quando a propriedade length for definida com um valor maior que o anterior, os elementos adicionais serão criados e preenchidos com o valor padrão apropriado ao tipo base (null para tipos de referência).

Quando a propriedade length for definida com um valor menor que o anterior, todos os elementos nas posições do índice maiores ou iguais ao novo valor de length serão removidos do Vector.

Cria um Vector com o tipo base especificado.

Quando chamar o construtor Vector.<T>(), especifique o tipo base usando a sintaxe de parâmetro de tipo. A sintaxe de parâmetro de tipo é uma sequência que consiste em um ponto (.), sinal de menor que (<), nome da classe e, em seguida, um sinal de maior que (>), como mostra este exemplo:

     var v:Vector.<String> = new Vector.<String>();
     

Para criar uma ocorrência de Vector a partir de uma Matriz ou outro Vector (por exemplo, com um tipo base diferente), use a função global Vector().

Para criar uma instância de Vector pré-preenchida, use a seguinte sintaxe em vez de usar os parâmetros especificados abaixo:

     // var v:Vector.<T> = new <T>[E0, ..., En-1 ,];
     // For example: 
     var v:Vector.<int> = new <int>[0,1,2,];
     

As seguintes informações se aplicam a esta sintaxe:

• É suportado em Flash Professional CS5 e posteriror, Flash Builder 4 e posterior e Flex 4 e posterior.
• A vírgula posterior é opcional.
• Os itens vazios na matriz não são suportados; uma instrução como var v:Vector.<int> = new <int>[0,,2,] emite um erro de compilador.
• Você não pode especificar um comprimento padrão da instância Vector. Em vez disso, o comprimento é o mesmo que o número de elementos na lista de inicialização.
• Você não pode especificar se a instância Vector tem um comprimento fixo. Em vez disso, use a propriedade fixed.
• A perda de dados ou os erros podem ocorrer se os itens passaram como os valores que não correspondem ao tipo especificado. Por exemplo:

     var v:Vector.<int> = new <int>[4.2]; // compiler error when running in strict mode
     trace(v[0]); //returns 4 when not running in strict mode
     

Elementos da API relacionados

Concatena os Vetores especificados na lista de parâmetros com os elementos deste Vetor e cria um novo Vetor. Os Vetores na lista de parâmetros devem ter o mesmo tipo base, ou subtipo, deste Vetor. Se você não transmitir nenhum parâmetro, o Vetor retornado será uma duplicata (clone superficial) do Vetor original.

Parâmetros

Executa uma função de teste em cada item do Vector até que seja alcançado um item que retorne false para a função especificada. Use este método para determinar se todos os itens de um Vector atendem a um critério, como ter valores menores que um determinado número.

Para esse método, o segundo parâmetro, thisObject, deverá ser null se o primeiro parâmetro, callback, for um fechamento de método. É a forma mais comum de usar este método.

No entanto, suponhamos que você crie uma função em um quadro da linha de tempo principal usando o Flash Professional, mas deseja que ela seja chamada em um contexto this diferente:

    function myFunction(item:T, index:int, vector:Vector.<T>):Boolean {
       // your code here
    }
    

Em seguida, suponhamos que você use o método every() em um Vector chamado myVector:

    myVector.every(myFunction, someObject);
    

Como myFunction é um membro da classe principal do arquivo SWF, ele não pode ser executado em um contexto this diferente. O tempo de execução do Flash emite uma exceção quando esse código é executado. Esse erro de tempo de execução pode ser evitado atribuindo a função a uma variável, desta forma:

    var myFunction:Function = function(item:T, index:int, vector:Vector.<T>):Boolean {
        //your code here
    };
    myVector.every(myFunction, someObject);
    

Parâmetros

function callback(item:T, index:int, vector:Vector.<T>):Boolean {
       // your code here
    }
    

Elementos da API relacionados

Executa uma função de teste em cada item do Vector e retorna um novo Vector contendo todos os itens que retornam true para a função especificada. Se um item retornar false, ele não será incluído no Vector resultante. O tipo base do Vector de retorno corresponde ao do Vector no qual o método é chamado.

Para esse método, o segundo parâmetro, thisObject, deverá ser null se o primeiro parâmetro, callback, for um fechamento de método. É a forma mais comum de usar este método.

No entanto, suponhamos que você crie uma função em um quadro da linha de tempo principal usando o Flash Professional, mas deseja que ela seja chamada em um contexto this diferente:

     function myFunction(item:T, index:int, vector:Vector.<T>):Boolean {
        // your code here
     }
     

Em seguida, suponhamos que você use o método filter() em um Vector chamado myVector:

     var result:Vector.<T> = myVector.filter(myFunction, someObject);
     

Como myFunction é um membro da classe principal do arquivo SWF, ele não pode ser executado em um contexto this diferente. O tempo de execução do Flash emite uma exceção quando esse código é executado. Esse erro de tempo de execução pode ser evitado atribuindo a função a uma variável, desta forma:

     var myFunction:Function = function(item:T, index:int, vector:Vector.<T>):Boolean {
         //your code here
     };
     myVector.filter(myFunction, someObject);
     

Parâmetros

function callback(item:T, index:int, vector:Vector.<T>):Boolean;

Elementos da API relacionados

Executa uma função em cada item do Vector.

Para esse método, o segundo parâmetro, thisObject, deverá ser null se o primeiro parâmetro, callback, for um fechamento de método. É a forma mais comum de usar este método.

No entanto, suponhamos que você crie uma função em um quadro da linha de tempo principal usando o Flash Professional, mas deseja que ela seja chamada em um contexto this diferente:

     function myFunction(item:T, index:int, vector:Vector.<T>):void {
        // your code here
     }
     

Em seguida, suponhamos que você use o método forEach() em um Vector chamado myVector:

     myVector.forEach(myFunction, someObject);
     

Como myFunction é um membro da classe principal do arquivo SWF, ele não pode ser executado em um contexto this diferente. O tempo de execução do Flash emite uma exceção quando esse código é executado. Esse erro de tempo de execução pode ser evitado atribuindo a função a uma variável, desta forma:

     var myFunction:Function = function(item:T, index:int, vector:Vector.<T>):void {
         //your code here
     };
     myVector.forEach(myFunction, someObject);
     

Parâmetros

function callback(item:T, index:int, vector:Vector.<T>):void;

Procura um item no Vector e retorna a posição do índice do item. O item é comparado com os elementos do Vector usando a igualdade estrita (===).

Parâmetros

Elementos da API relacionados

Inserir um único elemento no Vector. Este método modifica o Vector sem criar uma cópia.

Parâmetros

Converte em strings os elementos do Vector, insere o separador especificado entre os elementos, faz a sua concatenação e retorna a string resultante. Um Vector aninhado é sempre separado por uma vírgula (,) e não pelo separador transmitido ao método join().

Parâmetros

Elementos da API relacionados

Pesquisa um item no Vector, operando retroativamente a partir da posição especificada do índice, e retorna a posição do índice do item correspondente. O item é comparado com os elementos do Vector usando a igualdade estrita (===).

Parâmetros

Elementos da API relacionados

Executa uma função em cada item do Vector e retorna um novo Vector de itens correspondentes aos resultados da chamada da função em cada item desse Vector. O Vector resultante tem o mesmo tipo base e length do Vector original. O elemento no índice i do Vector resultante é o resultado da chamada no elemento no índice i do Vector original.

Para esse método, o segundo parâmetro, thisObject, deverá ser null se o primeiro parâmetro, callback, for um fechamento de método. É a forma mais comum de usar este método.

No entanto, suponhamos que você crie uma função em um quadro da linha de tempo principal usando o Flash Professional, mas deseja que ela seja chamada em um contexto this diferente:

     function myFunction(item:Object, index:int, vector:Vector.<T>):T {
        // your code here
     }
     

Em seguida, suponhamos que você use o método map() em um Vector chamado myVector:

     myVector.map(myFunction, someObject);
     

Como myFunction é um membro da classe principal do arquivo SWF, ele não pode ser executado em um contexto this diferente. O tempo de execução do Flash emite uma exceção quando esse código é executado. Esse erro de tempo de execução pode ser evitado atribuindo a função a uma variável, desta forma:

     var myFunction:Function = function(item:T, index:int, vector:Vector.<T>):void {
         //your code here
     };
     myVector.map(myFunction, someObject);
     

Parâmetros

function callback(item:T, index:int, vector:Vector.<T>):T;

Elementos da API relacionados

Remove o último elemento do Vector e retorna esse elemento. A propriedade length do Vector diminui um quando esta função é chamada.

Elementos da API relacionados

Adiciona um ou mais elementos ao final do Vector e retorna o novo tamanho do Vector.

Como esta função pode aceitar vários argumentos, o tipo de dados dos argumentos não é verificado durante a compilação, mesmo no modo estrito. No entanto, se for transmitido um argumento que não seja uma ocorrência do tipo base, ocorrerá uma exceção no tempo de execução.

Parâmetros

Elementos da API relacionados

Remover um único elemento do Vector. Este método modifica o Vector sem criar uma cópia.

Parâmetros

Inverte a ordem dos elementos no Vector. Esse método altera o Vector no qual ele é chamado.

Remove o primeiro elemento do Vector e retorna esse elemento. Os elementos restantes do Vector são movidos da posição original, i, a i - 1.

Elementos da API relacionados

Retorna um novo Vector que consiste em um intervalo de elementos do Vector original, sem modificar o Vector original. O Vector retornado inclui o elemento startIndex e todos os elementos até, mas sem incluir, o elemento endIndex.

Se você não transmitir nenhum parâmetro, o novo Vector será uma duplicata (clone superficial) do Vector original. Se você passar um valor de 0 para ambos os parâmetros, é criado um Vector novo e vazio do mesmo tipo que o Vector original.

Parâmetros

Executa uma função de teste em cada item do Vector até que seja alcançado um item que retorne true. Use este método para determinar se todos os itens de um Vector atendem a um critério, como ter um valor menor que um determinado número.

Para esse método, o segundo parâmetro, thisObject, deverá ser null se o primeiro parâmetro, callback, for um fechamento de método. É a forma mais comum de usar este método.

No entanto, suponhamos que você crie uma função em um quadro da linha de tempo principal, mas deseja que ela seja chamada em um contexto this diferente:

     function myFunction(item:Object, index:int, vector:Vector.<T>):Boolean {
        // your code here
     }
     

Em seguida, suponhamos que você use o método some() em um Vector chamado myVector:

     myVector.some(myFunction, someObject);
     

Como myFunction é um membro da classe principal do arquivo SWF, ele não pode ser executado em um contexto this diferente. O tempo de execução do Flash emite uma exceção quando esse código é executado. Esse erro de tempo de execução pode ser evitado atribuindo a função a uma variável, desta forma:

     var myFunction:Function = function(item:T, index:int, vector:Vector.<T>):Boolean {
         //your code here
     };
     myVector.some(myFunction, someObject);
     

Parâmetros

function callback(item:T, index:int, vector:Vector.<T>):Boolean

Elementos da API relacionados

Classifica os elementos no objeto Vector e também retorna um objeto vetor classificado. Este método classifica de acordo com o parâmetro sortBehavior, que é uma função que compara dois valores, ou grupo de opções de classificação.

O método toma um parâmetro. O parâmetro é um dos itens a seguir:

• uma função que toma dois argumentos do tipo de base (T) do Vector e retorna um Number:

  function compare(x:T, y:T):Number {}

  A lógica da função é que, dados os dois elementos x e y, a função retorna um dos seguintes três valores:

  • um número negativo, se x deve aparecer antes de y na sequência classificada
  • 0, se x for igual a y
  • um número positivo, se x deve aparecer depois de y na sequência classificada

• um número que é um bitwise OR dos seguintes valores:
  • 1 ou Array.CASEINSENSITIVE
  • 2 ou Array.DESCENDING
  • 4 ou Array.UNIQUESORT
  • 8 ou Array.RETURNINDEXEDARRAY
  • 16 ou Array.NUMERIC

  Se o valor for 0, a classificação trabalha da seguinte forma:

  • A classificação faz distinção entre maiúsculas e minúsculas (Z precede a).
  • A classificação é ascendente (a precede b).
  • A matriz é modificada para refletir a ordem de classificação; vários elementos que têm campos de classificação idênticos são inseridos consecutivamente na matriz classificada, sem nenhuma ordem em particular.
  • Todos os elementos, independentemente do tipo de dados, são classificados como se fossem strings. Sendo assim, 100 precede 99, já que "1" é um valor de string menor do que "9".

Parâmetros

Elementos da API relacionados

Adiciona e remove elementos do Vector. Este método modifica o Vector sem criar uma cópia.

Observação: Para substituir este método em uma subclasse de Vector, use ...args para os parâmetros, como mostra este exemplo:

     public override function splice(...args) {
       // your statements here
     }
     

Parâmetros

Retorna uma string que representa os elementos no Vector especificado. Cada elemento do Vector, começando com o índice 0 e terminando no índice mais alto, é convertido em uma string concatenada e separado por vírgulas. Na implementação ActionScript 3.0, esse método retorna o mesmo valor que o método Vector.toString().

Elementos da API relacionados

Retorna uma string que representa os elementos no Vector. Cada elemento do Vector, começando com o índice 0 e terminando no índice mais alto, é convertido em uma string concatenada e separado por vírgulas. Para especificar um separador personalizado, use o método Vector.join().

Elementos da API relacionados

Adiciona um ou mais elementos ao início do Vector e retorna o novo tamanho do Vector. Os outros elementos do Vector são movidos da posição original, i, para i + o número de novos elementos.

Como esta função pode aceitar vários argumentos, o tipo de dados dos argumentos não é verificado durante a compilação, mesmo no modo estrito. No entanto, se for transmitido um argumento que não seja uma ocorrência do tipo base, ocorrerá uma exceção no tempo de execução.

Parâmetros

Elementos da API relacionados