Vector

Pacote	Nível superior
Classe	public dynamic class Vector
Herança	Vector Object

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10, AIR 1.5, Flash Lite 4

A classe Vector permite acessar e manipular um vetor, uma matriz cujos elementos têm o mesmo tipo de dados. O tipo de dados dos elementos de um vetor é conhecido como o tipo base do vetor. O tipo base pode ser qualquer classe, incluindo as classes incorporadas e as personalizadas. O tipo base é especificado na declaração de uma variável de Vector, assim como na criação de uma ocorrência, chamando o construtor da classe.

Da mesma forma que em Array, você pode usar o operador de acesso à matriz ([]) para definir ou recuperar o valor de um elemento de Vector. Vários métodos de Vector também fornecem mecanismos de definição e recuperação de valores de elemento. Eles incluem push(), pop(), shift(), unshift(), entre outros. As propriedades e os métodos de um objeto Vector são semelhantes — na maioria dos casos, idênticos — aos de um Array. Na maioria dos casos em que você usa uma Matriz em que todos os elementos têm o mesmo tipo de dados, uma instância Vector tem preferência. Contudo, as instâncias de Vector são matrizes densas, significando que ele deve ter um valor (ou null) em cada índice. As instâncias de matriz não têm esta mesma restrição.

O tipo base do Vector é especificado usando a sintaxe de parâmetro de tipo sufixo. 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:

Na primeira linha do exemplo, a variável v está declarada como uma ocorrência de Vector.<String>. Em outras palavras, isso representa um Vector (uma matriz) que só pode conter ocorrências de String e a partir do qual somente ocorrências de String podem ser recuperadas. A segunda linha cria uma ocorrência do mesmo tipo de Vector (ou seja, um Vector cujos elementos são todos objetos String) e a atribui à v.

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

Uma variável declarada com o tipo de dados Vector.<T> só pode armazenar uma ocorrência de Vector criada com o mesmo tipo base T. Por exemplo, um Vector que é criado chamando novo Vector.<String>() não pode ser atribuído a uma variável declarada com o tipo de dados Vector.<int>. Os tipos base precisam corresponder exatamente. Por exemplo, o seguinte código não é compilado porque o tipo base do objeto não é o mesmo do tipo declarado da variável (embora Sprite seja uma subclasse de DisplayObject):

 // This code doesn't compile even though Sprite is a DisplayObject subclass
 var v:Vector.<DisplayObject> = new Vector.<Sprite>();

Para converter um Vector com tipo base T em um Vector de superclasse T, use a função global Vector().

Além da restrição de tipo de dados, a classe Vector tem outras restrições que a diferenciam da classe Array:

Um Vector é uma matriz densa. Ao contrário da Matriz, que pode ter valores nos índices 0 e 7, mesmo que não haja nenhum valor nas posições de 1 a 6, o Vector precisa ter um valor (ou null) em cada índice.
Um Vector pode ter, opcionalmente, um tamanho fixo, significando que o número de elementos contidos nele não pode ser alterado.
Os limites de acesso aos elementos de um Vector são verificados. Não é possível ler um valor de um índice maior que o elemento final (length - 1). Você não pode jamais definir um valor com um índice que exceda o índice final atual; em outras palavras, só é possível definir um valor em um índice existente ou no índice [length].

Como resultado das restrições, uma instância Vector tem duas vantagens principais sobre uma instância de Matriz cujos elementos são instâncias de uma única classe:

Desempenho: a iteração e o acesso ao elemento da matriz são muito mais rápidos ao usar uma instância de Vector do que ao usar uma Matriz.
Segurança do tipo: o compilador pode identificar erros de tipo de dados no modo restrito. Exemplos de erros de tipo de dados incluem a atribuição de valor de um tipo de dados incorreto ao um Vector ou a espera do tipo de dados errado na leitura de um valor de um Vector. Observe, entretanto, que ao usar o método push() ou unshift() para adicionar valores a um Vector, os tipos de dados dos argumentos não são verificados durante a compilação. Em vez disso, eles são verificados no tempo de execução.
Confiabilidade: a verificação de intervalo de tempo de execução (ou a verificação de comprimento fixo) aumenta a confiabilidade significativamente nas Matrizes.

Elementos da API relacionados

[] acesso à matriz
Função global Vector()
Classe Array

Propriedades públicas

Ocultar propriedades públicas herdadas

Mostrar propriedades públicas herdadas

	Propriedade		Definido por
		constructor : Object Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto.	Object
		fixed : Boolean Indica se a propriedade de tamanho do Vector pode ser alterada.	Vector
		length : uint O intervalo de índices válidos disponíveis no Vector.	Vector

Métodos públicos

Ocultar métodos públicos herdados

Mostrar métodos públicos herdados

	Método		Definido por
		Vector(length:uint = 0, fixed:Boolean = false) Cria um Vector com o tipo base especificado.	Vector
		concat(... args):Vector.<T> Concatena os Vetores especificados na lista de parâmetros com os elementos deste Vetor e cria um novo Vetor.	Vector
		every(callback:Function, thisObject:Object = null):Boolean Executa uma função de teste em cada item do Vector até que seja atingido um item que retorne false para a função especificada.	Vector
		filter(callback:Function, thisObject:Object = null):Vector.<T> 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.	Vector
		forEach(callback:Function, thisObject:Object = null):void Executa uma função em cada item do Vector.	Vector
		hasOwnProperty(name:String):Boolean Indica se um objeto tem uma propriedade especificada definida.	Object
		indexOf(searchElement:T, fromIndex:int = 0):int Procura um item no Vector e retorna a posição do índice do item.	Vector
		insertAt(index:int, element:T):void Inserir um único elemento no Vector.	Vector
		isPrototypeOf(theClass:Object):Boolean Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro.	Object
		join(sep:String = ","):String Converte em strings os elementos do Vector, insere o separador especificado entre os elementos, faz a sua concatenação e retorna a string resultante.	Vector
		lastIndexOf(searchElement:T, fromIndex:int = 0x7fffffff):int 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.	Vector
		map(callback:Function, thisObject:Object = null):Vector.<T> 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.	Vector
		pop():T Remove o último elemento do Vector e retorna esse elemento.	Vector
		propertyIsEnumerable(name:String):Boolean Indica se a propriedade especificada existe e é enumerável.	Object
		push(... args):uint Adiciona um ou mais elementos ao final do Vector e retorna o novo tamanho do Vector.	Vector
		removeAt(index:int):T Remover um único elemento do Vector.	Vector
		reverse():Vector.<T> Inverte a ordem dos elementos no Vector.	Vector
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Define a disponibilidade de uma propriedade dinâmica para operações de repetição.	Object
		shift():T Remove o primeiro elemento do Vector e retorna esse elemento.	Vector
		slice(startIndex:int = 0, endIndex:int = 16777215):Vector.<T> Retorna um novo Vector que consiste em um intervalo de elementos do Vector original, sem modificar o Vector original.	Vector
		some(callback:Function, thisObject:Object = null):Boolean Executa uma função de teste em cada item do Vector até que seja atingido um item que retorne true.	Vector
		sort(sortBehavior:*):Vector.<T> Classifica os elementos no objeto Vector e também retorna um objeto vetor classificado.	Vector
		splice(startIndex:int, deleteCount:uint = 4294967295, ... items):Vector.<T> Adiciona e remove elementos do Vector.	Vector
		toLocaleString():String Retorna uma string que representa os elementos no Vector especificado.	Vector
		toString():String Retorna uma string que representa os elementos no Vector.	Vector
		unshift(... args):uint Adiciona um ou mais elementos ao início do Vector e retorna o novo tamanho do Vector.	Vector
		valueOf():Object Retorna o valor primitivo do objeto especificado.	Object

Detalhes da propriedade

fixed

propriedade

fixed:Boolean

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10, AIR 1.5, Flash Lite 4

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).

Implementação
public function get fixed():Boolean
public function set fixed(value:Boolean):void

length

propriedade

length:uint

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10, AIR 1.5, Flash Lite 4

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.

Implementação
public function get length():uint
public function set length(value:uint):void

Lança

	`RangeError` — Se essa propriedade for alterada enquanto `fixed` for `true`.

	`RangeError` — Se essa propriedade for definida com um valor maior que o índice máximo permitido (2³²).

Detalhes do construtor

()

Construtor

public function Vector(length:uint = 0, fixed:Boolean = false)

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10, AIR 1.5, Flash Lite 4

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

Parâmetros

	`length:uint` (default = `0`) — O tamanho inicial (número de elementos) do Vector. Se esse parâmetro for maior que zero, o número especificado de elementos do Vector é criado e preenchido com o valor padrão apropriado ao tipo base (`null` para tipos de referência).

	`fixed:Boolean` (default = `false`) — Se o tamanho do Vector é fixo (`true`) ou pode ser alterado (`false`). Esse valor pode também ser definido com a propriedade `fixed`.

Elementos da API relacionados

fixed
Função global Vector()

Detalhes do método

concat

()

método

AS3 function concat(... args):Vector.<T>

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10, AIR 1.5, Flash Lite 4

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

... args — Zero ou mais Vetores do tipo base, ou subtipo, deste Vetor.

Retorna

Vector.<T> — Um Vetor com o mesmo tipo base e com os elementos desse Vetor, seguido de elementos dos Vetores na lista de parâmetros.

Lança

TypeError — Se algum argumento não for um Vetor do tipo base ou não puder ser convertido a um Vetor do tipo base.

every

()

método

AS3 function every(callback:Function, thisObject:Object = null):Boolean

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10, AIR 1.5, Flash Lite 4

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

callback:Function — A função a ser executada em cada item do Vector. Esta função é chamada com três argumentos: o item atual do Vector, o índice do item e o objeto Vector:

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

A função de retorno de chamada deve retornar um valor booliano.

thisObject:Object (default = null) — O objeto que o identificador this da função de retorno de chamada consulta quando a função é chamada.

Retorna

Boolean — Um valor booliano true se a função especificada retornar true quando chamada em todos os itens do Vector; caso contrário, false.

Elementos da API relacionados

Vector.some()

filter

()

método

AS3 function filter(callback:Function, thisObject:Object = null):Vector.<T>

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10, AIR 1.5, Flash Lite 4

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);

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

Parâmetros

	`callback:Function` — A função a ser executada em cada item do Vector. Esta função é chamada com três argumentos: o item atual do Vector, o índice do item e o objeto Vector: function callback(item:T, index:int, vector:Vector.<T>):Boolean;

	`thisObject:Object` (default = `null`) — O objeto que o identificador `this` da função de retorno de chamada consulta quando a função é chamada.

Retorna

Vector.<T> — O novo Vector que contém todos os itens do Vector original para o qual a função callback retornou true.

Elementos da API relacionados

Vector.map()

forEach

()

método

AS3 function forEach(callback:Function, thisObject:Object = null):void

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10, AIR 1.5, Flash Lite 4

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);

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

Parâmetros

callback:Function — A função a ser executada em cada item do Vector. Esta função é chamada com três argumentos: o item atual do Vector, o índice do item e o objeto Vector:

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

O valor retornado pela chamada de função é descartado.

thisObject:Object (default = null) — O objeto que o identificador this da função de retorno de chamada consulta quando a função é chamada.

indexOf

()

método

AS3 function indexOf(searchElement:T, fromIndex:int = 0):int

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10, AIR 1.5, Flash Lite 4

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

	`searchElement:T` — O item a ser localizado no Vector.

	`fromIndex:int` (default = `0`) — A localização no Vector a partir do qual será iniciada a pesquisa do item. Se esse parâmetro for negativo, será tratado como `length + fromIndex`, significando que a pesquisa iniciará nos itens `-fromIndex` do final, e pesquisará dessa posição em diante até o final do Vector.

Retorna

int — Uma posição de índice com base em zero do item do Vector. Se o argumento searchElement não for encontrado, o valor de retorno será -1.

Elementos da API relacionados

Vector.lastIndexOf()
=== (igualdade estrita)

insertAt

()

método

AS3 function insertAt(index:int, element:T):void

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 19, AIR 19

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

Parâmetros

	`index:int` — Um número inteiro que especifica a posição, no Vector, onde o elemento deve ser inserido. Você pode usar um inteiro negativo para especificar uma posição relativa ao final do Vector (por exemplo, -1 é o último elemento do Vector).

	`element:T`

Lança

RangeError — Se esse método for chamado enquanto fixed for true.

join

()

método

AS3 function join(sep:String = ","):String

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10, AIR 1.5, Flash Lite 4

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

sep:String (default = ",") — Um caractere ou string que separa elementos do Vector na string retornada. Se você omitir esse parâmetro, uma vírgula será usada como separador padrão.

Retorna

String — Uma string que consiste nos elementos do Vector convertidos em strings e separados pela string especificada.

Elementos da API relacionados

String.split()

lastIndexOf

()

método

AS3 function lastIndexOf(searchElement:T, fromIndex:int = 0x7fffffff):int

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10, AIR 1.5, Flash Lite 4

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

	`searchElement:T` — O item a ser localizado no Vector.

	`fromIndex:int` (default = `0x7fffffff`) — A localização no Vector a partir do qual será iniciada a pesquisa do item. O padrão é o valor máximo permitido do índice, significando que a pesquisa inicia no último item do Vector. Se esse parâmetro for negativo, será tratado como `length + fromIndex`, significando que a pesquisa iniciará nos itens `-fromIndex` do final, e pesquisará dessa posição para trás até o índice 0.

Retorna

int — Uma posição de índice com base em zero do item do Vector. Se o argumento searchElement não for encontrado, o valor de retorno será -1.

Elementos da API relacionados

Vector.indexOf()
=== (igualdade estrita)

map

()

método

AS3 function map(callback:Function, thisObject:Object = null):Vector.<T>

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10, AIR 1.5, Flash Lite 4

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);

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

Parâmetros

	`callback:Function` — A função a ser executada em cada item do Vector. Esta função é chamada com três argumentos: o item atual do Vector, o índice do item e o objeto Vector: function callback(item:T, index:int, vector:Vector.<T>):T;

	`thisObject:Object` (default = `null`) — O objeto que o identificador `this` da função de retorno de chamada consulta quando a função é chamada.

Retorna

Vector.<T> — Um novo Vector que contém os resultados da chamada da função de cada item desse Vector. O Vector resultante tem o mesmo tipo base e length do original.

Elementos da API relacionados

Vector.filter()

pop

()

método

AS3 function pop():T

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10, AIR 1.5, Flash Lite 4

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

Retorna

T — O valor do último elemento do Vector especificado.

Lança

RangeError — Se esse método for chamado enquanto fixed for true.

Elementos da API relacionados

Vector.push()
Vector.shift()
Vector.unshift()

push

()

método

AS3 function push(... args):uint

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10, AIR 1.5, Flash Lite 4

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

... args — Um ou mais valores a serem acrescentados ao Vector.

Retorna

uint — O tamanho do Vector depois que os novos elementos são adicionados.

Lança

	`TypeError` — Se algum argumento não for uma ocorrência do tipo base `T` do Vector.

	`RangeError` — Se esse método for chamado enquanto `fixed` for `true`.

Elementos da API relacionados

Vector.pop()
Vector.shift()
Vector.unshift()

removeAt

()

método

AS3 function removeAt(index:int):T

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 19, AIR 19

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

Parâmetros

index:int — Um número inteiro que especifica o índice do elemento no Vetor, que será excluído. Você pode usar um inteiro negativo para especificar uma posição relativa ao final do Vector (por exemplo, -1 é o último elemento do Vector).

Retorna

T — O elemento que foi removido do Vector original.

Lança

	`RangeError` — Se o argumento `index` especifica um índice a ser excluído que está fora dos limites do Vector.

	`RangeError` — Se esse método for chamado enquanto `fixed` for `true`.

reverse

()

método

AS3 function reverse():Vector.<T>

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10, AIR 1.5, Flash Lite 4

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

Retorna

Vector.<T> — O Vector com os elementos na ordem inversa.

shift

()

método

AS3 function shift():T

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10, AIR 1.5, Flash Lite 4

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.

Retorna

T — O primeiro elemento do Vector.

Lança

RangeError — Se fixed for true.

Elementos da API relacionados

Vector.pop()
Vector.push()
Vector.unshift()

slice

()

método

AS3 function slice(startIndex:int = 0, endIndex:int = 16777215):Vector.<T>

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10, AIR 1.5, Flash Lite 4

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

	`startIndex:int` (default = `0`) — Um número que especifica o índice do ponto de início da fatia. Se `startIndex` for um número negativo, o ponto de início começará no final do Vector, em que -1 é o último elemento.

	`endIndex:int` (default = `16777215`) — Um número que especifica o índice do ponto de término da fatia. Se você omitir esse parâmetro, a fatia incluirá todos os elementos, desde o ponto de início até o final do Vector. Se `endIndex` for um número negativo, o ponto de término será especificado a partir do final do Vector, em que -1 é o último elemento.

Retorna

Vector.<T> — um Vector que consiste em um intervalo de elementos do Vector original.

some

()

método

AS3 function some(callback:Function, thisObject:Object = null):Boolean

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10, AIR 1.5, Flash Lite 4

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);

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

Parâmetros

callback:Function — A função a ser executada em cada item do Vector. Esta função é chamada com três argumentos: o item atual do Vector, o índice do item e o objeto Vector:

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

A função de retorno de chamada deve retornar um valor booliano.

thisObject:Object (default = null) — O objeto que o identificador this da função de retorno de chamada consulta quando a função é chamada.

Retorna

Boolean — Um valor booliano true se todos os itens do Vector retornarem true para a função especificada; caso contrário, false.

Elementos da API relacionados

every()

sort

()

método

AS3 function sort(sortBehavior:*):Vector.<T>

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10, AIR 1.5, Flash Lite 4

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

sortBehavior:* — Um valor Function ou a Number determina o comportamento da classificação. O parâmetro Function especifica um método de comparação. Um valor Number especifica as opções de classificação.

Retorna

Vector.<T> — Um objeto vetor, com elementos na nova ordem.

Elementos da API relacionados

Array.sort()

splice

()

método

AS3 function splice(startIndex:int, deleteCount:uint = 4294967295, ... items):Vector.<T>

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10, AIR 1.5, Flash Lite 4

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

	`startIndex:int` — Um inteiro que especifica o índice do elemento do Vector em que a inserção ou exclusão é iniciada. Você pode usar um inteiro negativo para especificar uma posição relativa ao final do Vector (por exemplo, -1 é o último elemento do Vector).

	`deleteCount:uint` (default = `4294967295`) — Um inteiro que especifica o número de elementos a serem excluídos. Esse número inclui o elemento especificado no parâmetro `startIndex`. Se o valor for 0, nenhum elemento será excluído.

	`... items` — Uma lista opcional de um ou mais valores separados por vírgula para inserir no Vector na posição especificada pelo parâmetro `startIndex`.

Retorna

Vector.<T> — um Vector contendo os elementos que foram removidos do Vector original.

Lança

	`RangeError` — Se os argumentos `startIndex` e `deleteCount` especificarem um índice a ser excluído que esteja fora dos limites do Vector.

	`RangeError` — Se este método for chamado enquanto `fixed` for `true` e a operação `splice()` alterar o `length` do Vector.

toLocaleString

()

método

public function toLocaleString():String

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10, AIR 1.5, Flash Lite 4

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().

Retorna

String — Uma string de elementos do Vector.

Elementos da API relacionados

Vector.toString()

toString

()

método

public function toString():String

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10, AIR 1.5, Flash Lite 4

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().

Retorna

String — Uma string de elementos do Vector.

Elementos da API relacionados

String.split()
Vector.join()

unshift

()

método

AS3 function unshift(... args):uint

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10, AIR 1.5, Flash Lite 4

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.

Parâmetros

... args — Uma ou mais ocorrências do tipo base do Vector que serão inseridos no início do Vector.

Retorna

uint — Um inteiro representando o novo tamanho do Vector.

Lança

	`TypeError` — Se algum argumento não for uma ocorrência do tipo base `T` do Vector.

	`RangeError` — Se esse método for chamado enquanto `fixed` for `true`.

Elementos da API relacionados

Vector.pop()
Vector.push()
Vector.shift()

Aspectos jurídicos | Política de privacidade on-line

Vector - AS3

Classes x

fixed

length

Vector

concat

every

filter

forEach

indexOf

insertAt

join

lastIndexOf

map

pop

push

removeAt

reverse

shift

slice

some

sort

splice

toLocaleString

toString

unshift