Ds\Deque::filter

(PECL ds >= 1.0.0)

Ds\Deque::filter — Создает новую двухстороннюю очередь из элементов, выбранных с помощью заданной callback-функции

Описание

public Ds\Deque::filter ([ callable $callback ] ) : Ds\Deque

Создает новую двухстороннюю очередь из элементов, выбранных с помощью заданной callback-функции.

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

callback

callback ( mixed $value ) : bool

Опциональный аргумент типа callable, который возвращает TRUE, если значение должно быть включено и FALSE, если нет.

Если callback-функция не задана, то будут включены только элементы, которые приводятся к логическому значению TRUE (см. приведение к boolean).

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

Новая двухсторонняя очередь, содержащая значения, для которых функция callback вернула TRUE, либо все элементы, которые при приведении к логическому типу становятся TRUE, если параметр callback не задан.

Примеры

Пример #1 Пример Ds\Deque::filter() с использованием callback-функции


<?php
$deque = new \Ds\Deque([1, 2, 3, 4, 5]);

var_dump($deque->filter(function($value) {
    return $value % 2 == 0;
}));
?>

Результатом выполнения данного примера будет что-то подобное:

object(Ds\Deque)#3 (2) {
  [0]=>
  int(2)
  [1]=>
  int(4)
}

Пример #2 Пример Ds\Deque::filter() без callback-функции


<?php
$deque = new \Ds\Deque([0, 1, 'a', true, false]);

var_dump($deque->filter());
?>

Результатом выполнения данного примера будет что-то подобное:

object(Ds\Deque)#2 (3) {
  [0]=>
  int(1)
  [1]=>
  string(1) "a"
  [2]=>
  bool(true)
}