concat (matriz) do método
Retorna uma nova matriz consiste em uma combinação de matriz atual e quaisquer itens adicionais.
function concat([item1 : { Object | Array } [, ... [, itemN : { Object | Array }]]]]) : Array
Argumentos
- item1, item2,..., itemN
Opcional. Itens adicionais para adicionar ao final da matriz atual*.*
Comentários
O concat método retorna um Array objeto contendo a concatenação da matriz atual e quaisquer outros fornecido itens.
Os itens a serem adicionados (item1... itemN) na matriz são adicionados, na ordem, da esquerda para a direita. Se um dos itens é uma matriz, o seu conteúdo é adicionado ao final da matriz atual. Se o item for diferente de uma matriz, ele é adicionado ao final da matriz como um elemento de matriz.
Elementos de arrays de origem são copiados para a matriz resultante:
Para uma referência de objeto copiada a partir de qualquer uma das matrizes são concatenadas para o novo array, a referência de objeto continua a apontar para o mesmo objeto. Uma alteração no novo array ou a matriz original resultará em uma alteração para o outro.
Para um valor numérico ou cadeia de caracteres são concatenado para o novo array, somente o valor é copiado. Alterações em um valor em uma matriz não afetam o valor no outro.
Exemplo
O exemplo a seguir ilustra o uso da concat método quando usado com uma matriz:
function ConcatArrayDemo(){
var a, b, c, d;
a = new Array(1,2,3);
b = "JScript";
c = new Array(42, "VBScript");
d = a.concat(b, c);
//Returns the array [1, 2, 3, "JScript", 42, "VBScript"]
return(d);
}