Devuelve una matriz nueva que se compone de una combinación de dos o más matrices.

matriz1.concat([elemento1[, elemento2[, . . . [, elementoN]]]]) 

Argumentos

matriz1

Requerido. El objeto Array al que se concatenarán el resto de matrices.

elemento1,. . ., elementoN

Opcional. Elementos adicionales que se agregarán al final de matriz1.

Comentarios

El método concat devuelve un objeto Array que contiene la concatenación de matriz1 y cualquier otro elemento proporcionado.

Los elementos para agregar a la matriz (elemento1 … elementoN) se agregarán en orden de izquierda a derecha. Si uno de los elementos es una matriz, su contenido se agregará al final de matriz1. Si el elemento es de cualquier otro tipo distinto de 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 a la matriz resultado 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 al objeto continúa apuntando al mismo objeto. Un cambio tanto en la nueva matriz como en la original producirá un cambio en la otra.
• Para un valor numérico o cadena que se esté concatenando con la nueva matriz, sólo se copia el valor. Los cambios en un valor en una matriz no afecta el valor en la otra matriz.

Ejemplo

El siguiente ejemplo muestra el uso del método concat cuando se usa con una matriz:

function EjemploDeConcatArray(){
   var a, b, c, d;
   a = new Array(1,2,3);
   b = "JScript";
   c = new Array(42, "VBScript);
   d = a.concat(b, c);
   //Devuelve la matriz [1, 2, 3, "JScript", 42, "VBScript"]
   return(d);
}

Requisitos

Versión 3

Consulte también

Método concat (String) | Método join | Objeto String

Se aplica a: Objeto Array