Функция Array.contains
Определяет, существует ли указанный объект в виде элемента в объекте Array. Эта функция является статической, и ее можно вызывать, не создавая экземпляр объекта.
var itemExists = Array.contains(array, item);
Аргументы
Термин |
Определение |
|---|---|
array |
Массив, в котором выполняется поиск. |
item |
Искомый объект в массиве. |
Возвращаемое значение
Если указанный объект существует в виде элемента в массиве, значение — true, в противном случае — false.
Заметки
Функция contains предназначена для определения того, существует ли указанный объект в виде элемента в объекте Array.
В Mozilla Firefox при вызове функции contains с параметром item, имеющим значение undefined, возвращается значение true, если элементу в массиве задано значение undefined. Во всех остальных обозревателях функция возвращает значение false.
Пример
В следующем примере показано, как использовать функцию contains, чтобы определить, содержит ли массив указанный элемент.
var a = ['red', 'green', 'blue', 'yellow'];
var b = Array.contains(a, "red");
// View the results: "true"
alert(b.toString());
См. также
Ссылки
Оснастки расширений типов "массив"