diff --git a/reference/array/functions/array-all.xml b/reference/array/functions/array-all.xml new file mode 100644 index 0000000000..e3329d12cc --- /dev/null +++ b/reference/array/functions/array-all.xml @@ -0,0 +1,136 @@ + + + + + + + array_all + &array; のすべての要素がコールバック関数を満たすかどうかを調べる + + + + &reftitle.description; + + mixedarray_all + arrayarray + callablecallback + + + array_all は、指定された callback が + すべての要素に対して &true; を返す場合 &true; を返します。 + そうでない場合 &false; を返します。 + + + + + &reftitle.parameters; + + + array + + + 検索する &array;。 + + + + + callback + + + 各要素を調べるコールバック関数。シグネチャは次の通りです: + + boolcallback + mixedvalue + mixedkey + + この関数が &false; を返すと、 + array_all から &false; が返され、 + 以降の要素に対してはコールバックは呼び出されません。 + + + + + + + + &reftitle.returnvalues; + + callback がすべての要素に対して &true; を返す場合、 + この関数は &true; を返します。そうでない場合 &false; を返します。 + + + + + &reftitle.examples; + + <function>array_all</function> の例 + + 'dog', + 'b' => 'cat', + 'c' => 'cow', + 'd' => 'duck', + 'e' => 'goose', + 'f' => 'elephant' +]; + +// すべての動物名が12文字未満かどうかをチェックします。 +var_dump(array_all($array, function (string $value) { + return strlen($value) < 12; +})); + +// すべての動物名が5文字より長いかどうかをチェックします。 +var_dump(array_all($array, function (string $value) { + return strlen($value) > 5; +})); + +// すべての配列キーが文字列かどうかをチェックします。 +var_dump(array_all($array, function (string $value, $key) { + return is_string($key); +})); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + array_any + array_filter + array_find + array_find_key + + + + diff --git a/reference/array/functions/array-any.xml b/reference/array/functions/array-any.xml new file mode 100644 index 0000000000..9d9184b52e --- /dev/null +++ b/reference/array/functions/array-any.xml @@ -0,0 +1,137 @@ + + + + + + + array_any + &array; のいずれかの要素がコールバック関数を満たすかどうかを調べる + + + + &reftitle.description; + + mixedarray_any + arrayarray + callablecallback + + + array_any は、指定されたcallback が + いずれかの要素に対して &true; を返す場合 &true; を返します。 + そうでない場合 &false; を返します。 + + + + + &reftitle.parameters; + + + array + + + 検索する &array;。 + + + + + callback + + + 各要素を調べるコールバック関数。シグネチャは次の通りです: + + boolcallback + mixedvalue + mixedkey + + この関数が &true; を返すと、 + array_any から &true; が返され、 + 以降の要素に対してはコールバックは呼び出されません。 + + + + + + + + &reftitle.returnvalues; + + この関数は、callback が &true; を返す要素が + 少なくとも1つある場合、&true; を返します。 + そうでない場合 &false; を返します。 + + + + + &reftitle.examples; + + <function>array_any</function> の例 + + 'dog', + 'b' => 'cat', + 'c' => 'cow', + 'd' => 'duck', + 'e' => 'goose', + 'f' => 'elephant' +]; + +// いずれかの動物名が5文字より長いかどうかをチェックします。 +var_dump(array_any($array, function (string $value) { + return strlen($value) > 5; +})); + +// いずれかの動物名が3文字より短いかどうかをチェックします。 +var_dump(array_any($array, function (string $value) { + return strlen($value) < 3; +})); + +// 配列キーに文字列でないものがあるかどうかをチェックします。 +var_dump(array_any($array, function (string $value, $key) { + return !is_string($key); +})); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + array_all + array_filter + array_find + array_find_key + + + + diff --git a/reference/array/functions/array-filter.xml b/reference/array/functions/array-filter.xml index 1f1a9f8991..a96eb238a9 100644 --- a/reference/array/functions/array-filter.xml +++ b/reference/array/functions/array-filter.xml @@ -9,7 +9,7 @@ コールバック関数を使用して、配列の要素をフィルタリングする - + &reftitle.description; @@ -259,9 +259,10 @@ array(2) { array_intersect + array_find + array_any array_map array_reduce - array_walk diff --git a/reference/array/functions/array-find-key.xml b/reference/array/functions/array-find-key.xml new file mode 100644 index 0000000000..18c25891f3 --- /dev/null +++ b/reference/array/functions/array-find-key.xml @@ -0,0 +1,144 @@ + + + + + + + array_find_key + コールバック関数を満たす最初の要素のキーを返す + + + + &reftitle.description; + + mixedarray_find_key + arrayarray + callablecallback + + + array_find_key は、指定された + callback が &true; を返す &array; の最初の要素のキーを返します。 + 見つからない場合 &null; を返します。 + + + + + &reftitle.parameters; + + + array + + + 検索する &array;。 + + + + + callback + + + 各要素を調べるコールバック関数。シグネチャは次の通りです: + + boolcallback + mixedvalue + mixedkey + + この関数が &true; を返すと、 + その要素のキーが array_find_key から返され、 + 以降の要素に対してはコールバックは呼び出されません。 + + + + + + + + &reftitle.returnvalues; + + callback が &true; を返す最初の要素のキーを返します。 + 一致する要素が見つからない場合、 + &null; を返します。 + + + + + &reftitle.examples; + + <function>array_find_key</function> の例 + + 'dog', + 'b' => 'cat', + 'c' => 'cow', + 'd' => 'duck', + 'e' => 'goose', + 'f' => 'elephant' +]; + +// 名前が4文字より長い最初の動物を探します。 +var_dump(array_find_key($array, function (string $value) { + return strlen($value) > 4; +})); + +// 名前がfで始まる最初の動物を探します。 +var_dump(array_find_key($array, function (string $value) { + return str_starts_with($value, 'f'); +})); + +// 配列キーが動物の最初の文字と一致する最初の動物を探します。 +var_dump(array_find_key($array, function (string $value, $key) { + return $value[0] === $key; +})); + +// 配列キーが正規表現にマッチする最初の動物を探します。 +var_dump(array_find_key($array, function ($value, $key) { + return preg_match('/^([a-f])$/', $key); +})); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + array_find + array_all + array_any + array_filter + array_reduce + + + + diff --git a/reference/array/functions/array-find.xml b/reference/array/functions/array-find.xml new file mode 100644 index 0000000000..edf9d50fe6 --- /dev/null +++ b/reference/array/functions/array-find.xml @@ -0,0 +1,144 @@ + + + + + + + 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; + + <function>array_find</function> の例 + + '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 + + + +