doc-uk/reference/array/functions/array-any.xml at 169c43ee2681e2c3a5b394595b2b32426a81a99c · php/doc-uk · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 679cf93fa1e54cde82fc9cf545966eb13bcb0638 Maintainer: pmlkvch Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.array-any" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>array_any</refname>
  <refpurpose>Перевіряє, чи задовольняє хоча б один елемент &array; умову, задану callback-функцією</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> повертає &true;, якщо
   <parameter>callback</parameter>-функція повертає &true; хоча б для одного елемента вхідного масиву.
   В іншому випадку функція повертає &false;.
  </simpara>
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <variablelist>
   <varlistentry>
    <term><parameter>array</parameter></term>
    <listitem>
     <simpara>
      Масив &array;, в якому здійснюється пошук.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry>
    <term><parameter>callback</parameter></term>
    <listitem>
     <para>
      Callback-функція, яка викликається для перевірки кожного елемента вхідного масиву. Вона повинна мати наступну сигнатуру:
      <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>
      Функція <function>array_any</function> поверне &true; та не
      буде викликати callback-функцію для інших елементів вхідного масиву, якщо callback-функція поверне &true;.
     </para>
    </listitem>
   </varlistentry>
  </variablelist>
 </refsect1>

 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <simpara>
   Функція повертає &true;, якщо існує хоча б один елемент вхідного масиву, для якого
   <parameter>callback</parameter>-функція повертає &true;. В іншому випадку функція
   повертає &false;.
  </simpara>
 </refsect1>

 <refsect1 role="examples">
  &reftitle.examples;
  <example>
   <title>Приклад використання <function>array_any</function></title>
   <programlisting role="php">
<![CDATA[
<?php
$array = [
    'a' => '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);
}));
?>
]]>
   </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
-->