Ds\Sequence::filter

(PECL ds >= 1.0.0)

Ds\Sequence::filter Creates a new sequence using a callable to determine which values to include

説明

abstract public Ds\Sequence::filter(callable $callback = ?): Ds\Sequence

Creates a new sequence using a callable to determine which values to include.

パラメータ

callback

callback(mixed $value): bool

Optional callable which returns true if the value should be included, false otherwise.

If a callback is not provided, only values which are true (see converting to boolean) will be included.

戻り値

A new sequence containing all the values for which either the callback returned true, or all values that convert to true if a callback was not provided.

例1 Ds\Sequence::filter() example using callback function

<?php
$sequence 
= new \Ds\Vector([12345]);

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

上の例の出力は、 たとえば以下のようになります。

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

例2 Ds\Sequence::filter() example without a callback function

<?php
$sequence 
= new \Ds\Vector([01'a'truefalse]);

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

上の例の出力は、 たとえば以下のようになります。

object(Ds\Vector)#2 (3) {
  [0]=>
  int(1)
  [1]=>
  string(1) "a"
  [2]=>
  bool(true)
}
関連キーワード:  Ds, Sequence, callback, values, which, callable, filter, using, new, sequence