34.2 Das Array-Objekt  
JS 1.1
Ab JavaScript 1.1
In einem Array werden mehrere Daten abgespeichert und über einen numerischen Index verwaltet.
34.2.1 Allgemeines  
| Syntax
|
| new Array();
new Array(Größe);
new Array(Element1, Element2, ..., ElementN);
|
| Parameter
|
Bedeutung
|
| Größe
|
(anfängliche) Anzahl der Elemente im Array. Diese Methode funktioniert ab JavaScript 1.2 nicht mehr, dort wird jeder Parameter als Array-Element behandelt.
|
| Element1, Element2, ..., ElementN
|
anfängliche Elemente im Array
Auf die einzelnen Elemente des Arrays wird über den entsprechenden Index (er beginnt bei 0) zugegriffen: arrayname[3] greift auf das vierte Element zu.
|
34.2.2 Methoden  
concat
| Erklärung
|
| Verbindet zwei oder mehr Arrays; ab JavaScript 1.2.
|
| Syntax
|
| concat(Array1, Array2, ..., ArrayN)
|
| Parameter
|
Bedeutung
|
| Array1, Array2, ..., ArrayN
|
ein oder mehrere Arrays
Die Methode liefert ein neues Array zurück, das aus den Elementen des aufrufenden Arrays und den als Parameter übergebenen Arrays besteht.
|
| Beispiel
|
| var arr1 = new Array(1, 2, 3);
var conc = arr1.concat(new Array("4", "5", "6"));
//conc enthält nun die Elemente 1, 2, 3, "4", "5", "6")
|
join
| Erklärung
|
| Wandelt die Array-Elemente in eine Zeichenkette um; der Separator kann als Parameter übergeben werden.
|
| Syntax
|
| join(Separator)
|
| Parameter
|
Bedeutung
|
| Separator
|
Trennzeichen
|
| Beispiel
|
| var arr = new Array(1, 2, 3);
var joinarr = arr.join("-");
//joinarr hat nun den Wert "1 – 2 – 3"
|
pop
| Erklärung
|
| Das letzte Element des Arrays wird entfernt und zurückgegeben; ab JavaScript 1.2.
|
| Syntax
|
| pop()
var arr = new Array(1, 2, 3);
var elem = arr.pop();
//arr hat nun die Elemente 1 und 2; elem den Wert 3
|
push
JS 1.2/1.3
| Erklärung
|
| Fügt ein oder mehrere Zeichen hinten an das Array an. Die Anzahl der Elemente nach dieser Operation (JavaScript 1.3) bzw. das zuletzt hinzugefügte Element (JavaScript 1.2) wird zurückgegeben.
|
| Syntax
|
| push(Element1, Element2, ..., ElementN)
|
| Parameter
|
Bedeutung
|
| Element1, Element2, ..., ElementN
|
neue Array-Elemente
|
| Beispiel
|
| var arr = new Array(1, 2, 3);
var newlen = arr.push(2, 1);
//arr hat nun die Elemente 1, 2, 3, 2, 1;
//newlen hat den Wert 5 (JS1.3) bzw. 1 (JS1.2)
|
reverse
| Erklärung
|
| Kehrt die Reihenfolge der Elemente im Array um.
|
| Syntax
|
| reverse()
var arr = new Array(1, 2, 3);
var revarr = arr.reverse();
//revarr hat nun die Elemente 3, 2, 1
|
shift
JS 1.2
| Erklärung
|
| Das erste Element des Arrays wird entfernt und zurückgegeben; ab JavaScript 1.2.
|
| Beispiel
|
| shift()
var arr = new Array(1, 2, 3);
var elem = arr.shift();
//arr hat nun die Elemente 2, 3; elem hat den Wert 1
|
slice
JS 1.2
| Erklärung
|
| Entfernt Elemente aus einem Array und liefert die restlichen Elemente als Array zurück. Das ursprüngliche Array wird nicht geändert; ab JavaScript 1.2.
|
| Syntax
|
| slice(Start[, Ende])
|
| Parameter
|
Bedeutung
|
| Start
|
Index des ersten Elements, das entfernt werden soll
|
| Ende
|
Index des ersten Elements, das nicht mehr entfernt werden soll. Fehlt diese Angabe, so werden alle Elemente ab Start entfernt; ist der Parameter negativ, so wird von hinten gezählt
|
| Beispiel
|
| var arr1 = new Array(1, 2, 3, 4, 5);
var arr1_1 = arr1.slice(1, 3);
//arr1_1 hat nun die Elemente 1, 4, 5
var arr2 = new Array(1, 2, 3, 4, 5);
var arr2_1 = arr2.slice(3);
//arr2_1 hat nun die Elemente 1, 2, 3
var arr3 = new Array(1, 2, 3, 4, 5);
var arr3_1 = arr3.slice(0, –2);
//arr3_1 hat nun die Elemente 1, 2
|
sort
JS 1.2
| Erklärung
|
| Sortiert die Elemente des Arrays alphanumerisch. Ab JavaScript 1.2 kann eine Sortierfunktion angegeben werden (siehe Kapitel 13).
|
| Syntax
|
| sort([Sortierfunktion])
|
| Parameter
|
Bedeutung
|
| Sortierfunktion
|
Funktion, über die man die Reihenfolge der Elemente bestimmen kann, indem bei je zwei Werten zurückgegeben wird, welches Element größer ist
|
| Beispiel
|
| var arr1 = new Array(5, 3, 11);
arr1.sort();
//arr1 hat nun die Elemente 11, 3, 5 (alphanumerisch)
function numsort(a, b){return a-b;}
var arr2 = new Array(5, 3, 11);
arr2.sort(numsort);
//arr2 hat nun die Elemente 3, 5, 11
|
splice
JS 1.2
| Erklärung
|
| Entfernt Elemente aus einem Array und fügt neue Elemente an (optional); ab JavaScript 1.2; der Rückgabewert sind ab JavaScript 1.3 die entfernten Elemente.
|
| Syntax
|
| splice(Start, Wie viele[Element1, Element2, ...,
ElementN])
|
| Parameter
|
Bedeutung
|
| Start
|
Index des ersten Elements, das entfernt werden soll
|
| Wie viele
|
Anzahl der Elemente, die ab Start entfernt werden sollen
|
| Element1, Element2, ..., ElementN
|
(optionale) Elemente, die hinten an das Array angefügt werden sollen
|
| Beispiel
|
| var arr1 = new Array(1, 2, 3, 4, 5);
var splicearr = arr1.splice(1, 2, 3, 4, 5);
//splicearr hat nun die Elemente 1, 4, 5, 3, 4, 5
|
unshift
JS 1.2
| Erklärung
|
| Fügt ein oder mehrere Elemente vorne an das Array an und gibt die neue Länge des Arrays zurück; ab JavaScript 1.2.
|
| Syntax
|
| unshift(Element1, Element2, ..., ElementN)
|
| Parameter
|
Bedeutung
|
| Element1, Element2, ..., ElementN
|
Elemente, die vorne an das Array angefügt werden sollen
|
| Beispiel
|
| var arr = new Array(1, 2, 3);
var unsh = arr.unshift(4, 5);
//arr hat nun die Elemente 4, 5, 1, 2, 3; unsh hat den Wert 5
|
34.2.3 Eigenschaften  
length
| Erklärung
|
| Anzahl der Elemente im Array, wird automatisch angepasst.
|
| Beispiel
|
| var arr = new Aray(1, 2, 3, 4, 5);
//arr.length hat nun den Wert 5
|
|