join (Array.join-Methode)

public join([delimiter:String]) : String

Wandelt die Elemente in einem Array in Strings um, fügt zwischen ihnen das angegebene Trennzeichen ein, verkettet die Elemente und gibt den resultierenden String zurück. Ein verschachteltes Array wird immer durch ein Komma getrennt und nicht durch das Trennzeichen, das an die join()-Methode übergeben wurde.

Verfügbarkeit: ActionScript 1.0, Flash Lite 2.0

Parameter

delimiter:String [optional] - Ein Zeichen oder String, mit dem die Array-Elemente im zurückgegebenen String voneinander getrennt werden. Wenn Sie diesen Parameter weglassen, wird als Standardtrennzeichen das Komma verwendet.

Rückgabewerte

String - Ein String.

Beispiel

Im folgenden Beispiel wird ein Array mit drei Elementen erstellt: Earth, Moon und Sun. Dann werden die Elemente dreimal verbunden: zunächst mit dem Standardtrennzeichen (Komma und Leerzeichen), dann mit einem Bindestrich (-) und schließlich mit einem Plus-Zeichen (+).

var a_array:Array = new Array("Earth","Moon","Sun");
trace(a_array.join());
// Anzeige: Earth,Moon,Sun
trace(a_array.join(" - "));
// Anzeige: Earth - Moon - Sun
trace(a_array.join(" + "));
// Anzeige: Earth + Moon + Sun

Im folgenden Beispiel wird ein verschachteltes Array erstellt, das zwei Arrays enthält. Das erste Array besteht aus drei Elementen: Europa, Io und Callisto. Das zweite Array hat zwei Elemente: Titan und Rhea. Das Array wird durch ein Plus-Zeichen (+) verbunden, die in den verschachtelten Arrays enthaltenen Elemente bleiben weiterhin durch Kommata getrennt.

var a_nested_array:Array = new Array(["Europa", "Io", "Callisto"], ["Titan", "Rhea"]);
trace(a_nested_array.join(" + "));
// Rückgabewert: Europa,Io,Callisto + Titan,Rhea

Siehe auch

split (String.split-Methode)