Compartilhar via


Objeto Array

Fornece suporte para matrizes de expando de qualquer tipo de dados. Existem três formas do Array construtor.

function Array( [size : int] )
function Array( [... varargs : Object[]] ) 
function Array( [array : System.Array )

Argumentos

  • size
    Opcional. O tamanho da matriz. Como matrizes são baseada em zero, os elementos criados terão índices de zero a size -1.

  • VarArgs
    Opcional. Uma matriz tipificada que contém todos os parâmetros passados para o construtor. Esses parâmetros são usados como os primeiros elementos da matriz.

  • matriz
    Opcional. Uma matriz a ser copiado para o array sendo construído.

Comentários

Se apenas um argumento é passado para o Array construtor e o argumento é um número, ele deve ser um inteiro de 32 bits sem sinal (qualquer número inteiro menor do que aproximadamente quatro bilhões). O valor transmitido é o tamanho da matriz. Se o valor é um número que é menor que zero ou não é um número inteiro, ocorrerá um erro de tempo de execução.

Uma variável do tipo de dados array podem ser passados para o Array construtor. Isso produz uma matriz de JScript é uma cópia da matriz de entrada. O array deve ter apenas uma dimensão.

Se um único valor é passado para o Array construtor e ele não é um número ou uma matriz, o comprimento a propriedade da matriz é definida como 1 e o valor do primeiro elemento da matriz (elemento 0) se torna o argumento único, no passado. Se vários argumentos são passados para o construtor, o comprimento da matriz é definido para o número de argumentos e esses argumentos serão os primeiros elementos da nova matriz.

Observe que JScript matrizes são matrizes esparsas; Isto é, embora você possa alocar uma matriz com muitos elementos, existem apenas os elementos que contenham realmente dados. Isso reduz a quantidade de memória usada pelo array.

O Array objeto interopera com array o tipo de dados. Conseqüentemente, um Array objeto pode chamar os métodos e propriedades da array o tipo de dados e um array o tipo de dados pode chamar os métodos e propriedades da Array objeto. Além disso, Array objetos são aceitos pelas funções que levam array tipos de dados e vice-versa. Para obter mais informações, consulte Membros da matriz.

Quando um Array objeto é passado para uma função que assume um array ou quando array métodos são chamados de um Array objeto, o conteúdo da Array são copiados. Assim, o original Array objeto não pode ser modificado pela array métodos ou passando-a para uma função que aceita um array. Apenas não destrutiva Array métodos podem ser chamados em um array.

Dica

Arrayos objetos são convenientes quando você deseja uma pilha genérica ou uma lista de itens e o desempenho não é a principal preocupação. Em outros contextos, digitado devem ser usados a tipos de dados do array. Uma matriz tipificada, que tem praticamente a mesma funcionalidade como o Array o objeto, também ajuda a fornece segurança de tipos, melhorias de desempenho e uma melhor interação com outros idiomas.

ObservaçãoObservação

O Array objeto interopera com o.NET Framework array o tipo de dados dentro de JScript. No entanto, outros idiomas do Common Language Specification (CLS) não é possível usar o Array porque somente o JScript fornece o objeto; ele não é derivado de um.Tipo do NET Framework. Conseqüentemente, quando o tipo-anotando os parâmetros e tipos de retorno dos métodos compatíveis com CLS, certifique-se de usar o array o tipo de dados em vez da Array objeto. Entretanto, você pode usar o Array objeto digitar anotar identificadores diferente de parâmetros ou tipos de retorno. Para obter mais informações, consulte Escrevendo código compatível com CLS.

Exemplo

Os elementos individuais da matriz podem ser acessados usando a notação de []. Por exemplo:

var my_array = new Array();
for (var i = 0; i < 10; i++) {
   my_array[i] = i;
}
var x = my_array[4];

Como matrizes de JScript da Microsoft são baseada em zero, a declaração final no exemplo anterior acessa o quinto elemento da matriz. Esse elemento contém o valor 4.

Propriedades e métodos

Métodos e propriedades do objeto de matriz

Requisitos

Versão 2

Consulte também

Referência

Operador New

Conceitos

Arrays digitados