Flash Lite 2

Flash Lite 2.x ActionScript-Referenzhandbuch > ActionScript-Klassen > Array > concat (Array.concat-Methode)

concat (Array.concat-Methode)

Verkettet die in den Parametern angegebenen Elemente mit den Elementen in einem Array und erstellt ein neues Array. Wenn die value-Parameter ein Array angeben, werden die Elemente dieses Arrays - und nicht das Array selbst - verkettet. Das Array my_array bleibt unverändert.

Verfügbarkeit: ActionScript 1.0, Flash Lite 2.0

Parameter

value:Object [optional] - Zahlen, Elemente oder Strings, die in einem neuen Array verkettet werden sollen. Wenn Sie keine Werte übergeben, wird eine Kopie von my_array erstellt.

Rückgabewerte

Array - Ein Array mit den Elementen dieses Arrays und den Elementen aus den Parametern.

Beispiel

Mit dem folgenden Code werden zwei Arrays verkettet:

var alpha_array:Array = new Array("a","b","c");
var numeric_array:Array = new Array(1,2,3);
var alphaNumeric_array:Array =alpha_array.concat(numeric_array);
trace(alphaNumeric_array);
// Array [a,b,c,1,2,3] wird erstellt

Mit dem folgenden Code werden drei Arrays verkettet:

var num1_array:Array = [1,3,5];
var num2_array:Array = [2,4,6];
var num3_array:Array = [7,8,9];
var nums_array:Array=num1_array.concat(num2_array,num3_array)
trace(nums_array);
// Array [1,3,5,2,4,6,7,8,9] wird erstellt

Verschachtelte Arrays werden nicht wie normale Arrays zusammengeführt. Wie das folgende Beispiel zeigt, werden die Elemente in einem verschachtelten Array nicht in separate Elemente im Array x_array getrennt:

var a_array:Array = new Array ("a","b","c");

// 2 und 3 sind Elemente in einem verschachtelten Array.
var n_array:Array = new Array(1, [2, 3], 4);

var x_array:Array = a_array.concat(n_array);
trace(x_array[0]); // a
trace(x_array[1]); // b
trace(x_array[2]); // c
trace(x_array[3]); // 1
trace(x_array[4]); // 2, 3
trace(x_array[5]); // 4