concat (Método, Array)
Devuelve una matriz nueva compuesta por una combinación de la matriz actual y otros elementos adicionales.
function concat([item1 : { Object | Array } [, ... [, itemN : { Object | Array }]]]]) : Array
Argumentos
- item1, item2, ..., itemN
Opcional. Elementos adicionales que se agregarán al final de la matriz actual.
Comentarios
El método concat devuelve un objeto Array que contiene la concatenación del argumento actual y cualquier otro elemento proporcionado.
Los elementos que se van a agregar a la matriz (item1 ... itemN) se agregan por orden de izquierda a derecha. Si uno de los elementos es una matriz, su contenido se agregará al final de la matriz actual. Si el elemento no es una matriz, se agregará al final de la matriz como un elemento de matriz simple.
Los elementos de las matrices de origen se copiarán en la matriz resultante de la siguiente manera:
Para una referencia de objeto copiada desde cualquiera de las matrices que se están concatenando con la nueva matriz, la referencia de objeto continúa apuntando al mismo objeto. Un cambio en la nueva matriz o en la matriz original producirá un cambio en la otra.
Para un valor numérico o de cadena que se esté concatenando con la nueva matriz, sólo se copia el valor. Los cambios de un valor en una matriz no afectan al valor de la otra matriz.
Ejemplo
El siguiente ejemplo muestra el uso del método concat cuando se utiliza con una 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);
}