JavaScript/Objekte/Array/join

Die Methode join verbindet alle Elemente eines Arrays zu einer Zeichenkette.

Syntax

join([Trennungstext])

Sie erwartet einen Trennungstext als Parameter:

• eine Zeichenfolge, die beim Verbinden der Elemente zu einer Zeichenkette immer zwischen zwei Elemente geschrieben wird
• Wenn der Trennungstext keine Zeichenfolge ist, dann wird der Parameter durch die toString-Methode in eine Zeichenfolge konvertiert.

Rückgabewert ist eine Zeichenkette mit allen Elementen aus dem Array, die mit dem Trennungstext verbunden wurden.

Beachten Sie: Wird kein Trennungstext übergeben, werden die Elemente mit einem Komma (",") ohne weiteres Leerzeichen verbunden.

Anwendungsbeispiel

Leerzeichen

Beispiel

var zahlen       = new Array(1, 2, 4, 8, 16, 32, 64, 128, 256);
var zeichenkette = zahlen.join(' ');

ausgabe(zeichenkette); // "1 2 4 8 16 32 64 128 256"

Das Beispiel definiert ein Array mit neun Zahlen. Dann wird die join-Methode aufgerufen, um alle Elemente im Array miteinander zu verbinden. Als Trennungstext fungiert eine Zeichenfolge mit einem Leerzeichen. Der Rückgabewert wird in der Variable zeichenkette gespeichert. Der Effekt ist, dass in zeichenkette alle definierten Zahlen stehen, und zwar durch ein Leerzeichen anstelle des standardmäßigen Kommas voneinander getrennt. Zur Kontrolle wird das Ergebnis als Meldungsfenster ausgegeben.

Zeichenketten

Beispiel ansehen …

var Essen = ['Pizza', 'Spaghetti', 'Schäufele', 'Haxe'];

function verbindeEinträge() {
  var text = Essen.join(' + ');
	
  var ausgabe = document.getElementById('ausgabe');
  ausgabe.innerHTML = text;
}

Alle Elemente aus dem Array werden durch die eigene toString-Methode in Zeichenketten konvertiert und der Reihenfolge im Array nach miteinander verbunden. Beim Verbinden zweier Elemente wird jeweils der Trennungstext dazwischen geschrieben. Er verbindet sozusagen zwei Elemente, trennt sie aber innerhalb der resultierenden Zeichenkette rein durch seine Präsenz.

Weblinks

• ECMAScript 2015 (6th Edition, ECMA-262): Array.prototype.join()
• MDN: Array.prototype.join()