concat, méthode (Array)
Retourne un nouveau tableau formé de la combinaison du tableau en cours et de tout autre élément.
function concat([item1 : { Object | Array } [, ... [, itemN : { Object | Array }]]]]) : Array
Arguments
- item1, item2, ..., itemN
Facultatif. Autres éléments à ajouter à la fin du tableau en cours*.*
Notes
La méthode concat retourne un objet Array contenant la concaténation du tableau en cours et des éventuels autres éléments spécifiés.
Les éléments à ajouter (item1 ... itemN) au tableau sont insérés dans l'ordre, de gauche à droite. Si l'un de ces éléments est un tableau, son contenu est ajouté à la fin du tableau en cours. Si l'élément n'est pas un tableau, il est ajouté à la fin du tableau en tant qu'élément de tableau unique.
Les éléments des tableaux sources sont copiés dans le nouveau tableau de la manière suivante :
Lorsqu'une référence d'objet copiée dans le nouveau tableau provient de l'un des tableaux en cours de concaténation, la référence continue à pointer vers le même objet. Tout changement apporté au nouveau tableau ou au tableau d'origine est répercuté dans l'autre tableau.
Lorsqu'une valeur numérique ou de chaîne est concaténée dans le nouveau tableau, seule la valeur est copiée. Le changement d'une valeur dans un tableau n'a aucune répercussion sur la valeur contenue dans l'autre tableau.
Exemple
L'exemple ci-dessous illustre l'utilisation de la méthode concat avec un tableau :
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);
}