Condividi tramite


Metodo concat (Array)

Restituisce una nuova matrice risultante dalla combinazione della matrice corrente e di altri elementi aggiuntivi.

function concat([item1 : { Object | Array } [, ... [, itemN : { Object | Array }]]]]) : Array

Argomenti

  • item1, item2, ..., itemN
    Facoltativo. Altri elementi da aggiungere alla fine della matrice corrente.

Note

Mediante il metodo concat viene restituito un oggetto Array contenente la concatenazione della matrice corrente e degli altri elementi specificati.

Gli elementi (item1 ... itemN) da aggiungere alla matrice vengono inseriti da sinistra verso destra. Se uno degli elementi è una matrice, il relativo contenuto verrà aggiunto alla fine della matrice corrente. Se non è una matrice, l'elemento verrà aggiunto alla fine della matrice come elemento singolo.

Elementi di matrici di origine vengono copiati nella matrice risultante nel modo seguente:

  • Se si copia un riferimento a un oggetto da una delle matrici da concatenare alla nuova matrice, il riferimento punterà sempre allo stesso oggetto. Qualsiasi modifica apportata alla nuova matrice o alla matrice originale verrà apportata a entrambe le matrici.

  • Se si concatena un valore numerico o stringa, nella nuova matrice verrà copiato solo il valore. Qualsiasi modifica apportata a un valore in una matrice non influirà sul valore dell'altra.

Esempio

Nell'esempio seguente viene illustrato l'utilizzo del metodo concat con una matrice:

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

Requisiti

Versione 3

Si applica a:

Oggetto Array

Vedere anche

Riferimenti

Metodo concat (String)

Metodo join

Oggetto String