Ds\Set::contains

(PECL ds >= 1.0.0)

Ds\Set::contains — Проверяет, содержится ли в коллекции заданные значения

Описание

public Ds\Set::contains(mixed ...$values): bool

Проверяет, содержится ли в коллекции заданные значения.

Замечание:
Поддерживаются значения типа object. Если объект реализует интерфейс Ds\Hashable, проверка производится путём вызова метода объекта equals. Если объект не реализует интерфейс Ds\Hashable, объекты должны ссылаться на один и тот же экземпляр класса.

Предостережение

Все сравнения строгие, по типу и значению.

Список параметров

values: Значения для проверки.

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

Возвращает false, если хотя бы одно значение из values не найдено в коллекции и true в противном случае.

Примеры

Пример #1 Пример использования Ds\Set::contains()

<?php
$set = new \Ds\Set([1, 2, 3]);

var_dump($set->contains(1));                // true
var_dump($set->contains(1, 2));             // true
var_dump($set->contains(...[1, 2]));        // true

var_dump($set->contains("1"));              // false
var_dump($set->contains(...[1, 2, 3, 4]));  // false

var_dump($set->contains(...[]));            // true
?>

Вывод приведённого примера будет похож на:

bool(true)
bool(true)
bool(true)
bool(false)
bool(false)
bool(true)