Metodo concat (Array)
Aggiornamento: novembre 2007
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);
}