2024 年日本 PHP 研討會

Ds\Map::filter

(PECL ds >= 1.0.0)

Ds\Map::filter 建立一個新的 Map,使用 callable 來決定要包含哪些鍵值對

說明

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

建立一個新的 Map,使用 callable 來決定要包含哪些鍵值對。

參數

callback

回呼函式(混合型別 $key, 混合型別 $value): 布林值

可選的 可呼叫 函式,如果鍵值對應被包含則回傳 true,否則回傳 false

如果沒有提供回呼函式,則只有值為 true 的元素會被包含 (參見 轉換為布林值)。

回傳值

一個新的映射,包含所有 回呼函式 返回 true 的鍵值對,或者如果沒有提供 回呼函式,則包含所有轉換為 true 的值。

範例

範例 #1 使用回呼函式的 Ds\Map::filter() 範例

<?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() 範例

<?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)
}
新增註解

使用者貢獻的註解

此頁面尚無使用者提供的註釋。
To Top