★ wanayoo — archive 1999 https://developer.mozilla.org/de/docs/Web/JavaScript/Reference/Global_Objects/Array/spliceNouvelle recherche | Portail wanayoo
mozilla
Ihre Suchergebnisse

    Array.prototype.splice()

    Zusammenfassung

    Die splice() Methode ändert den Inhalt eines Array durch das Hinzufügen neuer Elemente während alte Elemente enterfernt werden können.

    Syntax

    array.splice(index, howMany[, element1[, ...[, elementN]]])
    array.splice(index) // SpiderMonkey/Firefox Erweiterung, in diesem Fall howMany=array.length-index
    

    Parameter

    index
    Index ab welchem das Array geändert werden soll. Wenn der Index größer als die Länge des Arrays ist. wird der Index auf die Länge des Arrays gesetzt. Falls der Index negativ ist, begint die Änderung entsprechend viele Stellen rückwärts vom Ende des Array..
    howMany
    Anzahl wie viele alte Array Elemente entfernt werden sollen. Falls 0 werden keine Elemente entfernt. In diesem Fall sollte man mindestens ein neues Element übergeben. Falls howMany größer ist als die Anzahl Elemente die in dem Array übrig bleiben, beginndend ab index, dann werden alle Elemente bis zum Ende des Arrays entfernt. Falls kein howMany Parameter spezifieziert wird (SpiderMonkey Erweiterung) werden alle Elemente ab index entfernt.
    elementN
    Die Elemente die dem Array hinzugefügt werden sollen. Falls keine Elemente angegeben werden, entfernt splice einfach elemente von dem Array..

    Rückgabewert

    Ein Array welches die entfernten Elemente beinhalted. Falls nur ein Element entfernt wurde, wird dennoch ein Array mit nur einem Element zurückgegeben. Falls keine Elemente entfernt werden wird ein leeres Array zurückgegeben.

    Beschreibung

    Falls die Anzahl neuer Elemente ungleich der Anzahl entfernter Elemente ist wird die Länge des Arrays geändert.

    Beispiele

    Zur Benutzung von splice

    Das folgende Script zeigt die Benutzung von splice:

    var myFish = ['angel', 'clown', 'mandarin', 'surgeon'];
    
    // removes 0 elements from index 2, and inserts 'drum'
    var removed = myFish.splice(2, 0, 'drum');
    // myFish is ['angel', 'clown', 'drum', 'mandarin', 'surgeon']
    // removed is [], no elements removed
    
    // removes 1 element from index 3
    removed = myFish.splice(3, 1);
    // myFish is ['angel', 'clown', 'drum', 'surgeon']
    // removed is ['mandarin']
    
    // removes 1 element from index 2, and inserts 'trumpet'
    removed = myFish.splice(2, 1, 'trumpet');
    // myFish is ['angel', 'clown', 'trumpet', 'surgeon']
    // removed is ['drum']
    
    // removes 2 elements from index 0, and inserts 'parrot', 'anemone' and 'blue'
    removed = myFish.splice(0, 2, 'parrot', 'anemone', 'blue');
    // myFish is ['parrot', 'anemone', 'blue', 'trumpet', 'surgeon']
    // removed is ['angel', 'clown']
    
    // removes 2 elements from index 3
    removed = myFish.splice(3, Number.MAX_VALUE);
    // myFish is ['parrot', 'anemone', 'blue']
    // removed is ['trumpet', 'surgeon']
    

    Spezifikation

    Spezifikation Status Kommenter
    ECMAScript 3rd Edition Standard Initial definition. Implemented in JavaScript 1.2.
    ECMAScript 5.1 (ECMA-262)
    Die Definition von 'Array.prototype.splice' in dieser Spezifikation.
    Standard  
    ECMAScript 6 (ECMA-262)
    Die Definition von 'Array.prototype.splice' in dieser Spezifikation.
    Entwurf  

    Browser Kompatibilität

    Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
    Basic support 1.0 1.0 (1.7 oder früher) 5.5 (Ja) (Ja)
    Feature Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
    Basic support (Ja) (Ja) (Ja) (Ja) (Ja) (Ja)

    Abwärtskompatibilität

    In JavaScript 1.2 gibt die splice Methode nur das entfernte Element zurück wenn nur ein Element entfernt wurde (howMany Parameter ist 1); Ansonsten gibt die Methode ein Array zurück wie oben beschrieben. Hinweis: Der letzte Browser welcher JavaScript 1.2 nutzte war Netscape Navigator 4, also kann man davon ausgehen, dass splice immer ein Array zurückgibt.

    Siehe auch

    • push / pop — add/remove elements from the end of the array
    • unshift / shift — add/remove elements from the beginning of the array
    • concat — returns a new array comprised of this array joined with other array(s) and/or value(s)

    Schlagwörter des Dokuments und Mitwirkende

    Mitwirkende an dieser Seite: rhulha
    Zuletzt aktualisiert von: rhulha,