array_find
コールバック関数を満たす最初の要素を返す
&reftitle.description;
mixedarray_find
arrayarray
callablecallback
array_find は、指定された
callback が &true; を返す &array; の最初の要素を返します。
見つからない場合 &null; を返します。
&reftitle.parameters;
array
検索する &array;。
callback
各要素を調べるコールバック関数。シグネチャは次の通りです:
boolcallback
mixedvalue
mixedkey
この関数が &true; を返すと、
その要素が array_find から返され、
以降の要素に対してはコールバックは呼び出されません。
&reftitle.returnvalues;
callback が &true; を返す最初の要素を返します。
一致する要素が見つからない場合、
&null; を返します。
&reftitle.examples;
array_find の例
'dog',
'b' => 'cat',
'c' => 'cow',
'd' => 'duck',
'e' => 'goose',
'f' => 'elephant'
];
// 名前が4文字より長い最初の動物を探します。
var_dump(array_find($array, function (string $value) {
return strlen($value) > 4;
}));
// 名前がfで始まる最初の動物を探します。
var_dump(array_find($array, function (string $value) {
return str_starts_with($value, 'f');
}));
// キーが動物の名前の最初の文字と一致する最初の動物を探します。
var_dump(array_find($array, function (string $value, $key) {
return $value[0] === $key;
}));
// キーが正規表現にマッチする最初の動物を探します。
var_dump(array_find($array, function ($value, $key) {
return preg_match('/^([a-f])$/', $key);
}));
?>
]]>
&example.outputs;
&reftitle.seealso;
array_find_key
array_all
array_any
array_filter
array_reduce