diff --git a/reference/array/functions/array-all.xml b/reference/array/functions/array-all.xml index 128751423..c972b9c8b 100644 --- a/reference/array/functions/array-all.xml +++ b/reference/array/functions/array-all.xml @@ -26,7 +26,7 @@ array - 需要被遍历的 &array; + 需要被遍历的 &array;。 diff --git a/reference/array/functions/array-any.xml b/reference/array/functions/array-any.xml new file mode 100644 index 000000000..2f01869e3 --- /dev/null +++ b/reference/array/functions/array-any.xml @@ -0,0 +1,130 @@ + + + + + + array_any + 检查数组中是否至少有一个元素满足回调函数的条件 + + + + &reftitle.description; + + boolarray_any + arrayarray + callablecallback + + + 如果指定的 callback 对任意一个元素返回 &true;,则 array_any 函数返回 &true;;否则该函数返回 &false;。 + + + + + &reftitle.parameters; + + + array + + + 需要被遍历的 &array;。 + + + + + callback + + + 用于检查每个元素的回调函数,该函数必须 + + boolcallback + mixedvalue + mixedkey + + 如果该函数返回 &true;,则 array_any 会立即返回 &true;,并且不会再为后续元素调用该回调函数。 + + + + + + + + &reftitle.returnvalues; + + 如果数组中至少存在一个元素能让 callback 返回 &true;,则该函数返回 &true;;否则返回 &false;。 + + + + + &reftitle.examples; + + <function>array_any</function> 示例 + + 'dog', + 'b' => 'cat', + 'c' => 'cow', + 'd' => 'duck', + 'e' => 'goose', + 'f' => 'elephant' +]; + +// Check, if any animal name is longer than 5 letters. +var_dump(array_any($array, function (string $value) { + return strlen($value) > 5; +})); + +// Check, if any animal name is shorter than 3 letters. +var_dump(array_any($array, function (string $value) { + return strlen($value) < 3; +})); + +// Check, if any array key is not a string. +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-find-key.xml b/reference/array/functions/array-find-key.xml new file mode 100644 index 000000000..043817587 --- /dev/null +++ b/reference/array/functions/array-find-key.xml @@ -0,0 +1,137 @@ + + + + + + array_find_key + 返回满足回调函数条件的第一个元素的键 + + + + &reftitle.description; + + mixedarray_find_key + arrayarray + callablecallback + + + array_find_key 返回 &array; 中第一个使指定 callback 返回 &true; 的元素的键。如果未找到匹配元素,则该函数返回 &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' +]; + +// Find the first animal with a name longer than 4 characters. +var_dump(array_find_key($array, function (string $value) { + return strlen($value) > 4; +})); + +// Find the first animal whose name begins with f. +var_dump(array_find_key($array, function (string $value) { + return str_starts_with($value, 'f'); +})); + +// Find the first animal where the array key is the first symbol of the animal. +var_dump(array_find_key($array, function (string $value, $key) { + return $value[0] === $key; +})); + +// Find the first animal where the array key matching a RegEx. +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 000000000..ccebd6a16 --- /dev/null +++ b/reference/array/functions/array-find.xml @@ -0,0 +1,137 @@ + + + + + + array_find + 返回满足回调函数条件的第一个元素 + + + + &reftitle.description; + + mixedarray_find + arrayarray + callablecallback + + + array_find 返回 &array; 中第一个使指定 callback 返回 &true; 的元素的值。如果未找到匹配的元素,则该函数返回 &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' +]; + +// Find the first animal with a name longer than 4 characters. +var_dump(array_find($array, function (string $value) { + return strlen($value) > 4; +})); + +// Find the first animal whose name begins with f. +var_dump(array_find($array, function (string $value) { + return str_starts_with($value, 'f'); +})); + +// Find the first animal where the array key is the first symbol of the animal. +var_dump(array_find($array, function (string $value, $key) { + return $value[0] === $key; +})); + +// Find the first animal where the array key matching a RegEx. +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 + + + +