Skip to content

translate: array_find / array_find_key / array_all / array_any (PHP 8.4) #226

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
msamesch merged 4 commits into from
May 28, 2026
+560 −0
Merged

translate: array_find / array_find_key / array_all / array_any (PHP 8.4) #226

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
b74e792
translate: array_find / array_find_key / array_all / array_any (PHP 8.4)
lacatoire May 28, 2026
b5e1e65
Update reference/array/functions/array-all.xml
lacatoire May 28, 2026
af5c56e
Rewrap array_all description to mirror EN line wrapping
lacatoire May 28, 2026
7b4389d
Drop the obsolete $Revision$ comment
lacatoire May 28, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
136 changes: 136 additions & 0 deletions reference/array/functions/array-all.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,136 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: dfd68fd22aef25658bc9348176b55b504d26ab11 Maintainer: lacatoire Status: ready -->
<refentry xml:id="function.array-all" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>array_all</refname>
<refpurpose>Prüft, ob alle Elemente eines &array;s eine Callback-Funktion erfüllen</refpurpose>
</refnamediv>

<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>array_all</methodname>
<methodparam><type>array</type><parameter>array</parameter></methodparam>
<methodparam><type>callable</type><parameter>callback</parameter></methodparam>
</methodsynopsis>
<simpara>
<function>array_all</function> gibt &true; zurück, wenn die übergebene
<parameter>callback</parameter>-Funktion für alle Elemente &true; zurückgibt.
Andernfalls gibt die Funktion &false; zurück.
</simpara>
</refsect1>

<refsect1 role="parameters">
&reftitle.parameters;
<variablelist>
<varlistentry>
<term><parameter>array</parameter></term>
<listitem>
<simpara>
Das zu durchsuchende &array;.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>callback</parameter></term>
<listitem>
<para>
Die Callback-Funktion, die zur Prüfung jedes Elements aufgerufen wird
und die folgende Signatur haben muss:
<methodsynopsis>
<type>bool</type><methodname><replaceable>callback</replaceable></methodname>
<methodparam><type>mixed</type><parameter>value</parameter></methodparam>
<methodparam><type>mixed</type><parameter>key</parameter></methodparam>
</methodsynopsis>
Wenn diese Funktion &false; zurückgibt, gibt <function>array_all</function>
ebenfalls &false; zurück, und die Callback-Funktion wird für keine weiteren
Elemente mehr aufgerufen.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>

<refsect1 role="returnvalues">
&reftitle.returnvalues;
<simpara>
Die Funktion gibt &true; zurück, wenn <parameter>callback</parameter> für
alle Elemente &true; zurückgibt. Andernfalls gibt die Funktion &false;
zurück.
</simpara>
</refsect1>

<refsect1 role="examples">
&reftitle.examples;
<example>
<title><function>array_all</function>-Beispiel</title>
<programlisting role="php">
<![CDATA[
<?php
$array = [
'a' => 'dog',
'b' => 'cat',
'c' => 'cow',
'd' => 'duck',
'e' => 'goose',
'f' => 'elephant'
];

// Prüft, ob alle Tiernamen kürzer als 12 Buchstaben sind.
var_dump(array_all($array, function (string $value) {
return strlen($value) < 12;
}));

// Prüft, ob alle Tiernamen länger als 5 Buchstaben sind.
var_dump(array_all($array, function (string $value) {
return strlen($value) > 5;
}));

// Prüft, ob alle Array-Schlüssel Zeichenketten sind.
var_dump(array_all($array, function (string $value, $key) {
return is_string($key);
}));
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
bool(true)
bool(false)
bool(true)
]]>
</screen>
</example>
</refsect1>

<refsect1 role="seealso">
&reftitle.seealso;
<simplelist>
<member><function>array_any</function></member>
<member><function>array_filter</function></member>
<member><function>array_find</function></member>
<member><function>array_find_key</function></member>
</simplelist>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
136 changes: 136 additions & 0 deletions reference/array/functions/array-any.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,136 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: dfd68fd22aef25658bc9348176b55b504d26ab11 Maintainer: lacatoire Status: ready -->
<refentry xml:id="function.array-any" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>array_any</refname>
<refpurpose>Prüft, ob mindestens ein Element eines &array;s eine Callback-Funktion erfüllt</refpurpose>
</refnamediv>

<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>array_any</methodname>
<methodparam><type>array</type><parameter>array</parameter></methodparam>
<methodparam><type>callable</type><parameter>callback</parameter></methodparam>
</methodsynopsis>
<simpara>
<function>array_any</function> gibt &true; zurück, wenn die übergebene
<parameter>callback</parameter>-Funktion für mindestens ein Element &true;
zurückgibt. Andernfalls gibt die Funktion &false; zurück.
</simpara>
</refsect1>

<refsect1 role="parameters">
&reftitle.parameters;
<variablelist>
<varlistentry>
<term><parameter>array</parameter></term>
<listitem>
<simpara>
Das zu durchsuchende &array;.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>callback</parameter></term>
<listitem>
<para>
Die Callback-Funktion, die zur Prüfung jedes Elements aufgerufen wird
und die folgende Signatur haben muss:
<methodsynopsis>
<type>bool</type><methodname><replaceable>callback</replaceable></methodname>
<methodparam><type>mixed</type><parameter>value</parameter></methodparam>
<methodparam><type>mixed</type><parameter>key</parameter></methodparam>
</methodsynopsis>
Wenn diese Funktion &true; zurückgibt, wird &true; von
<function>array_any</function> zurückgegeben und die Callback-Funktion
wird für weitere Elemente nicht mehr aufgerufen.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>

<refsect1 role="returnvalues">
&reftitle.returnvalues;
<simpara>
Die Funktion gibt &true; zurück, wenn es mindestens ein Element gibt, für
das <parameter>callback</parameter> &true; zurückgibt. Andernfalls gibt
die Funktion &false; zurück.
</simpara>
</refsect1>

<refsect1 role="examples">
&reftitle.examples;
<example>
<title><function>array_any</function>-Beispiel</title>
<programlisting role="php">
<![CDATA[
<?php
$array = [
'a' => 'dog',
'b' => 'cat',
'c' => 'cow',
'd' => 'duck',
'e' => 'goose',
'f' => 'elephant'
];

// Prüft, ob irgendein Tiername länger als 5 Buchstaben ist.
var_dump(array_any($array, function (string $value) {
return strlen($value) > 5;
}));

// Prüft, ob irgendein Tiername kürzer als 3 Buchstaben ist.
var_dump(array_any($array, function (string $value) {
return strlen($value) < 3;
}));

// Prüft, ob irgendein Array-Schlüssel keine Zeichenkette ist.
var_dump(array_any($array, function (string $value, $key) {
return !is_string($key);
}));
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
bool(true)
bool(false)
bool(false)
]]>
</screen>
</example>
</refsect1>

<refsect1 role="seealso">
&reftitle.seealso;
<simplelist>
<member><function>array_all</function></member>
<member><function>array_filter</function></member>
<member><function>array_find</function></member>
<member><function>array_find_key</function></member>
</simplelist>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
Loading
Loading