Функция Array.remove

Удаляет первое вхождение заданного элемента из объекта Array. Эта функция является статической, и ее можно вызывать, не создавая экземпляр объекта.

var isRemoved = Array.remove(array, item);

Аргументы

  • array
    Массив, из которого удаляется item.

  • item
    Объект, удаляемый из массива при первом вхождении.

Возвращаемое значение

true, если указанный элемент существует в массиве и был удален, в противном случае — false.

Заметки

Функция remove используется для удаления из массива первого вхождения заданного элемента. Значение индексов элементов, остающихся в массиве, уменьшается на единицу.

В Mozilla Firefox при вызове функции remove с параметром item, имеющим значение undefined, из массива удаляется первый элемент, имеющий это значение. В других обозревателях вызов функции с параметром item, имеющим значение undefined, не оказывает никакого воздействия.

Пример

В следующем примере показано, как использовать функцию remove для удаления из массива первого вхождения элемента.

var a = ['a', 'b', 'c', 'd', 'e'];
Array.remove(a, 'c');
// View the results: "a,b,d,e"
alert(a);
Array.removeAt(a, 2);
 // View the results: "a,b,e"
alert(a);

См. также

Ссылки

Функция Array.dequeue

Объект Array

Оснастки расширений типов "массив"

Другие ресурсы

Справочник по языку