concat-Methode (Array)
Aktualisiert: November 2007
Gibt ein neues Array zurück, das aus einer Kombination aus dem aktuellen Array und weiteren Elementen besteht.
function concat([item1 : { Object | Array } [, ... [, itemN : { Object | Array }]]]]) : Array
Argumente
- item1, item2, ..., itemN
Optional. Weitere Elemente, die am Ende des aktuellen Arrays angefügt werden können.
Hinweise
Die concat-Methode gibt ein Array-Objekt zurück, das die Verkettung des aktuellen Arrays mit allen weiteren Elementen enthält.
Die Elemente, die dem Array hinzugefügt werden sollen (item1 ... itemN), werden der Reihenfolge nach von links nach rechts angefügt. Wenn eines der Elemente ein Array ist, wird dessen Inhalt am Ende des aktuellen Arrays angefügt. Wenn das Element kein Array ist, wird es am Ende des Arrays als einzelnes Arrayelement angefügt.
Elemente von Quellarrays werden wie nachfolgend erläutert in das resultierende Array kopiert:
Bei einem Objektverweis, der aus einem beliebigen Array kopiert wurde, das mit dem neuen Array verkettet wird, zeigt der Objektverweis weiterhin auf dasselbe Objekt. Eine im neuen oder im ursprünglichen Array vorgenommene Änderung bewirkt, dass eine entsprechende Änderung im jeweils anderen Array vorgenommen wird.
Werden numerische oder Zeichenfolgenwerte mit dem neuen Array verkettet, wird nur der Wert kopiert. Änderungen am Wert eines Arrays haben keine Auswirkungen auf den Wert im anderen Array.
Beispiel
Das folgende Beispiel veranschaulicht die Verwendung der concat-Methode in Kombination mit einem Array:
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);
}