Функция Array.indexOf
Производит поиск указанного элемента объекта Array и возвращает его индекс. Эта функция является статической, и ее можно вызывать, не создавая экземпляр объекта.
var indexVar = Array.indexOf(array, item, start);
Аргументы
Термин |
Определение |
|---|---|
array |
Массив, в котором выполняется поиск. |
item |
Искомый объект в массиве. |
startIndex |
(Необязательно). Номер индекса, который указывает начальный элемент для поиска в массиве. |
Возвращаемые значения
Число, представляющее собой порядковый номер расположения item в массиве (если оно найдено); в противном случае — 1.
В обозревателе Mozilla Firefox при вызове indexOf с параметром item, значение которого не указано или для которого указано значение undefined, возвращает индекс первого элемента, имеющего значение undefined. Во всех остальных обозревателях возвращается значение 1.
Заметки
Используйте функцию indexOf для определения значения индекса первого вхождения элемента в экземпляре массива.
Пример
В следующем примере показано, как искать значение индекса указанного элемента с помощью функции indexOf . Возвращаемый индекс является первым вхождением элемента, указанного в item. Можно найти следующее вхождение item, если вызвать функцию снова и указать, что начальное значение индекса больше, чем значение индекса найденного элемента.
var a = ['red', 'blue', 'green', 'blue'];
var myFirstIndex = Array.indexOf(a, "blue");
// View the results: "1"
alert("myFirstIndex: " + myFirstIndex);
var mySecondIndex = Array.indexOf(a, "blue", (myFirstIndex + 1) );
// View the results: "3"
alert("mySecondIndex: " + mySecondIndex);
См. также
Ссылки
Оснастки расширений типов "массив"