Ds\Map::filter

(PECL ds >= 1.0.0)

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

Описание

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

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

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

callback

callback ( mixed $key , mixed $value ) : bool

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

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

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

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

Примеры

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


<?php
$map = new \Ds\Map(["a", "b", "c", "d", "e"]);

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

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

object(Ds\Map)#3 (3) {
  [0]=>
  object(Ds\Pair)#2 (2) {
    ["key"]=>
    int(0)
    ["value"]=>
    string(1) "a"
  }
  [1]=>
  object(Ds\Pair)#4 (2) {
    ["key"]=>
    int(2)
    ["value"]=>
    string(1) "c"
  }
  [2]=>
  object(Ds\Pair)#5 (2) {
    ["key"]=>
    int(4)
    ["value"]=>
    string(1) "e"
  }
}

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


<?php
$map = new \Ds\Map(["a" => 0, "b" => 1, "c" => true, "d" => false]);

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

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

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