JavaScript/Objekte/Array/splice: Unterschied zwischen den Versionen

Version vom 10. Juni 2012, 10:00 Uhr

Die Methode splice entfernt Elemente aus einem Array und fügt neue Elemente ein.

Vorlage:Iconset

Syntax

splice(position [, anzahl [, element0, element1, ..., elementN] ])

Parameter

position

die Position im Array, an der Elemente gelöscht und eingefügt werden sollen

Ist dieser Wert negativ, dann wird vom Ende des Arrays aus gezählt.

anzahl

die Anzahl der zu löschenden Elemente

element0, ..., elementN

die neuen Elemente, die an der Position eingefügt werden sollen

Rückgabe

Ein Array mit den entfernen Elementen.

Beschreibung

Um neue Elemente einzufügen, ist es erforderlich, die Anzahl der zu löschenden Elemente anzugeben. Sollen keine Elemente gelöscht werden, dann sollte hier 0 (Null) stehen. Wenn die Methode nur mit dem ersten Parameter position aufgerufen wird, dann werden alle Elemente ab dieser Position gelöscht, das Element an dieser Position mit einbegriffen.

var a = new Array("a", "b", "c", "d", "e", "f");
alert(a); // "a,b,c,d,e,f"

/* --- 1 --- */
a.splice(2, 0, "X", "Y");
alert(a); // "a,b,X,Y,c,d,e,f"

/* -- 2 --- */
a.splice(4, 3, "Z");
alert(a); // "a,b,X,Y,Z,f"

/* --- 3 --- */
a.splice(-1, 5, "#");
alert(a); // "a,b,X,Y,Z,#"

/* --- 4 --- */
a.splice(-1);
alert(a); // "a,b,X,Y,Z"

/* --- 5 --- */
a.splice(1);
alert(a); // "a"

Der Parameter position bezieht sich auf einen auf 0 (Null) basierenden Index vom Array. Das bedeutet, das erste Element im Array hat die Position 0 (Null). Wird der Index im Array durch eine negative Positionsangabe ermittelt, dann entspricht die Position -1 dem letzten Eintrag im Array und die Position -2 dem vorletzten Eintrag. Es wird einfach vom Ende aus gezählt.