cvs: phpdoc-ru /reference/array/functions array-change-key-case.xml array-chunk.xml array-count-values.xml array-diff.xml array-fill.xml
array-filter.xml array-flip.xml array-intersect.xml array-key-exists.xml array-keys.xml
| From: | Ivan Kovalenko | Date: | Thu, 29 Aug 2002 17:25:19 +0000 |
| Subject: | cvs: phpdoc-ru /reference/array/functions array-change-key-case.xml array-chunk.xml array-count-values.xml array-diff.xml array-fill.xml array-filter.xml array-flip.xml array-intersect.xml array-key-exists.xml array-keys.xml |
||
| Groups: | php.doc.ru | ||
| Request: | Send a blank email to doc-ru+get-20@lists.php.net to get a copy of this message | ||
tronic Thu Aug 29 13:25:19 2002 EDT
Added files:
/phpdoc-ru/reference/array/functions array-change-key-case.xml
array-chunk.xml
array-count-values.xml
array-diff.xml array-fill.xml
array-filter.xml
array-flip.xml
array-intersect.xml
array-key-exists.xml
array-keys.xml
Log:
Translation done.
Index: phpdoc-ru/reference/array/functions/array-change-key-case.xml +++ phpdoc-ru/reference/array/functions/array-change-key-case.xml <?xml version="1.0" encoding="windows-1251"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/array.xml, last change in rev 1.113 --> <refentry id="function.array-change-key-case"> <refnamediv> <refname>array_change_key_case</refname> <refpurpose>Âîçâðàùàåò ìàññèâ, ñèìâîëüíûå êëþ÷è êîòîðîãî ïðåîáðàçîâàíû â âåðõíèé èëè íèæíèé ðåãèñòð ñèìâîëîâ</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>ìàññèâ</type><methodname>array_change_key_case</methodname> <methodparam><type>ìàññèâ</type><parameter>èñõîäíûé_ìàññèâ</parameter></methodparam> <methodparam choice="opt"><type>öåëîå</type><parameter>ðåãèñòð_ñèìâîëîâ</parameter></methodparam> </methodsynopsis> <para> Ôóíêöèÿ <function>array_change_key_case</function> ïðåîáðàçóåò êëþ÷è ìàññèâà <parameter>èñõîäíûé_ìàññèâ</parameter> â âåðõíèé èëè íèæíèé ðåãèñòð ñèìâîëîâ. Òèï ïðåîáðàçîâàíèÿ çàâèñèò îò ïîñëåäíåãî îïöèîíàëüíîãî ïàðàìåòðà <parameter>ðåãèñòð_ñèìâîëîâ</parameter>.  êà÷åñòâå ýòîãî ïàðàìåòðà âû ìîæåòå ïåðåäàòü îäíó èç äâóõ êîíñòàíò: <constant>CASE_UPPER</constant> è <constant>CASE_LOWER</constant>. Ïî óìîë÷àíèþ èñïîëüçóåòñÿ <constant>CASE_LOWER</constant>. Ýòà ôóíêöèÿ íå èçìåíÿåò êëþ÷è, ñîñòîÿùèå èç ÷èñåë. </para> <example> <title>Ïðèìåð èñïîëüçîâàíèÿ <function>array_change_key_case</function></title> <programlisting role="php"> <![CDATA[ $input_array = array("FirSt" => 1, "SecOnd" => 4); print_r(array_change_key_case($input_array, CASE_UPPER)); ]]> </programlisting> <para> Ðåçóëüòàòîì âûïîëíåíèÿ âûøåïðèâåäåííîé ïðîãðàììû áóäåò: <screen> <![CDATA[ Array ( [FIRST] => 1 [SECOND] => 2 ) ]]> </screen> </para> </example> </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:"../../../../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 --> Index: phpdoc-ru/reference/array/functions/array-chunk.xml +++ phpdoc-ru/reference/array/functions/array-chunk.xml <?xml version="1.0" encoding="windows-1251"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/array.xml, last change in rev 1.2 --> <refentry id="function.array-chunk"> <refnamediv> <refname>array_chunk</refname> <refpurpose>Ðàçáèòü ìàññèâ íà ÷àñòè</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>ìàññèâ</type><methodname>array_chunk</methodname> <methodparam><type>ìàññèâ</type><parameter>èñõîäíûé_ìàññèâ</parameter></methodparam> <methodparam><type>öåëîå</type><parameter>ðàçìåð</parameter></methodparam> <methodparam choice="opt"><type>ëîãè÷åñêîå</type><parameter>ñîõðàíÿòü_êëþ÷è</parameter></methodparam> </methodsynopsis> <para> Ôóíêöèÿ <function>array_chunk</function> ðàçáèâàåò ìàññèâ íà íåñêîëüêî ìàññèâîâ ðàçìåðîì <parameter>ðàçìåð</parameter> çíà÷åíèé. Ïîñëåäíèé ìàññèâ èç ïîëó÷åííûõ ìîæåò ñîäåðæàòü ìåíüøåå êîëè÷åñòâî çíà÷åíèé, ÷åì óêàçàíî.  êà÷åñòâå ðåçóëüòàòà ôóíêöèÿ âîçâðàùàåò ìíîãîðàçìåðíûé ìàññèâ ñ èíäåêñàìè, íà÷èíàþùèìèñÿ ñ íóëÿ è ýëåìåíòàìè, êîòîðûìè ÿâëÿþòñÿ ìàññèâû, ïîëó÷åííûå â ðåçóëüòàòå ðàçáèâêè. </para> <para> Åñëè âû ïåðåäàäèòå çíà÷åíèå &true; â êà÷åñòâå íåîáÿçàòåëüíîãî ïàðàìåòðà <parameter>preserve_keys</parameter>, PHP ñîõðàíèò êëþ÷è èç èñõîäíîãî ìàññèâà. Åñëè çíà÷åíèå ýòîãî ïàðàìåòðà ðàâíî &false;, ýëåìåíòû ðåçóëüòèðóþùèõ ìàññèâîâ áóäóò ïðîèíäåêñèðîâàíû ÷èñëàìè, íà÷èíàÿ ñ íóëÿ. Ïî óìîë÷àíèþ èñïîëüçóåòñÿ çíà÷åíèå &false;. </para> <example> <title>Ïðèìåð èñïîëüçîâàíèÿ <function>array_chunk</function></title> <programlisting role="php"> <![CDATA[ $input_array = array('a', 'b', 'c', 'd', 'e'); print_r(array_chunk($input_array, 2)); print_r(array_chunk($input_array, 2, TRUE)); ]]> </programlisting> <para> Ðåçóëüòàòîì âûïîëíåíèÿ âûøåïðèâåäåííîé ïðîãðàììû áóäåò: <screen> <![CDATA[ Array ( [0] => Array ( [0] => a [1] => b ) [1] => Array ( [0] => c [1] => d ) [2] => Array ( [0] => e ) ) Array ( [0] => Array ( [0] => a [1] => b ) [1] => Array ( [2] => c [3] => d ) [2] => Array ( [4] => e ) ) ]]> </screen> </para> </example> </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:"../../../../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 --> Index: phpdoc-ru/reference/array/functions/array-count-values.xml +++ phpdoc-ru/reference/array/functions/array-count-values.xml <?xml version="1.0" encoding="windows-1251"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/array.xml, last change in rev 1.2 --> <refentry id="function.array-count-values"> <refnamediv> <refname>array_count_values</refname> <refpurpose>Ïîäñ÷èòàòü êîëè÷åñòâî âñåõ çíà÷åíèé ìàññèâà</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>ìàññèâ</type><methodname>array_count_values</methodname> <methodparam><type>ìàññèâ</type><parameter>èñõîäíûé_ìàññèâ</parameter></methodparam> </methodsynopsis> <para> Ôóíêöèÿ <function>array_count_values</function> âîçâðàùàåò ìàññèâ, êëþ÷àìè êîòîðîãî ÿâëÿþòñÿ çíà÷åíèÿ ìàññèâà <parameter>èñõîäíûé_ìàññèâ</parameter>, à çíà÷åíèÿìè - ÷àñòîòà ïîâòîðåíèÿ ýòèõ çíà÷åíèé. </para> <para> <example> <title>Ïðèìåð èñïîëüçîâàíèÿ <function>array_count_values</function></title> <programlisting role="php"> <![CDATA[ $array = array (1, "hello", 1, "world", "hello"); print_r(array_count_values ($array)); ]]> </programlisting> <para> Ðåçóëüòàòîì âûøåïðèâåäåííîé ïðîãðàììû áóäåò: <screen> <![CDATA[ Array ( [1] => 2 [hello] => 2 [world] => 1 ) ]]> </screen> </para> </example> </para> </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:"../../../../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 --> Index: phpdoc-ru/reference/array/functions/array-diff.xml +++ phpdoc-ru/reference/array/functions/array-diff.xml <?xml version="1.0" encoding="windows-1251"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/array.xml, last change in rev 1.14 --> <refentry id="function.array-diff"> <refnamediv> <refname>array_diff</refname> <refpurpose>Âû÷èñëèòü ðàñõîæäåíèå â ìàññèâàõ</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>ìàññèâ</type><methodname>array_diff</methodname> <methodparam><type>ìàññèâ</type><parameter>ìàññèâ_1</parameter></methodparam> <methodparam><type>ìàññèâ</type><parameter>ìàññèâ_2</parameter></methodparam> <methodparam choice="opt"><type>ìàññèâ</type><parameter> ...</parameter></methodparam> </methodsynopsis> <para> Ôóíêöèÿ <function>array_diff</function> âîçâðàùàåò ìàññèâ, ñîñòîÿùèé èç çíà÷åíèé ìàññèâà <parameter>ìàññèâ_1</parameter>, êîòîðûå îòñóòñòâóþò â ëþáîì äðóãîì ìàññèâå, ïåðå÷èñëåííîì â ïîñëåäóþùèõ àðãóìåíòàõ. Îáðàòèòå âíèìàíèå, ÷òî êëþ÷è ìàññèâîâ ñîõðàíÿþòñÿ. </para> <para> <example> <title>Ïðèìåð èñïîëüçîâàíèÿ <function>array_diff</function></title> <programlisting role="php"> <![CDATA[ $array1 = array ("a" => "green", "red", "blue", "red"); $array2 = array ("b" => "green", "yellow", "red"); $result = array_diff ($array1, $array2); ]]> </programlisting> </example> </para> <para>  ðåçóëüòàòå âûïîëíåíèÿ ýòîé ïðîãðàììû ïåðåìåííàÿ <varname>$result</varname> áóäåò ñîäåðæàòü <literal>array ("blue");</literal>. Ïîâòîðåíèÿ îäíîãî è òîãî æå çíà÷åíèÿ â $array1 îáðàáàòûâàþòñÿ êàê îäíî çíà÷åíèå. </para> <note> <simpara> Äâà ýëåìåíòà ñ÷èòàþòñÿ îäèíàêîâûìè åñëè è òîëüêî åñëè <literal>(string) $elem1 === (string) $elem2</literal>. Äðóãèìè ñëîâàìè, êîãäà èõ ñòðîêîâîå ïðåäñòàâëåíèå èäåíòè÷íî. <!-- TODO: example of it... --> </simpara> </note> <note> <simpara> Îáðàòèòå âíèìàíèå, ÷òî ýòà ôóíêöèÿ îáðàáàòûâàåò òîëüêî îäíî èçìåðåíèå n-ðàçìåðíîãî ìàññèâà. Åñòåñòâåííî, âû ìîæåòå îáðàáàòûâàòü è áîëåå ãëóáîêèå óðîâíè âëîæåííîñòè, íàïðèìåð, èñïîëüçóÿ <literal>array_diff($array1[0], $array2[0]);</literal>. </simpara> </note> <warning> <simpara> <!-- This was broken in PHP 4.0.4! NOTE: do not uncomment this until context of above sentence is clear enough to translate. --> <!-- TODO: when exactly was this broken?... --> </simpara> </warning> <para> Ñì.òàêæå <function>array_intersect</function>. </para> </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:"../../../../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 --> Index: phpdoc-ru/reference/array/functions/array-fill.xml +++ phpdoc-ru/reference/array/functions/array-fill.xml <?xml version="1.0" encoding="windows-1251"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/array.xml, last change in rev 1.2 --> <refentry id="function.array-fill"> <refnamediv> <refname>array_fill</refname> <refpurpose>Çàïîëíèòü ìàññèâ îïðåäåëåííûì çíà÷åíèåì</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>ìàññèâ</type><methodname>array_fill</methodname> <methodparam><type>öåëîå</type><parameter>íà÷àëüíûé_èíäåêñ</parameter></methodparam> <methodparam><type>öåëîå</type><parameter>êîëè÷åñòâî</parameter></methodparam> <methodparam><type>ñìåøàííîå</type><parameter>çíà÷åíèå</parameter></methodparam> </methodsynopsis> <para> Ôóíêöèÿ <function>array_fill</function> âîçâðàùàåò ìàññèâ, ñîäåðæàùèé <parameter>êîëè÷åñòâî</parameter> ýëåìåíòîâ, èìåþùèõ çíà÷åíèå ïàðàìåòðà <parameter>çíà÷åíèå</parameter>. Íóìåðàöèÿ êëþ÷åé ýëåìåíòîâ ìàññèâà íà÷èíàþòñÿ ñî çíà÷åíèÿ ïàðàìåòðà <parameter>íà÷àëüíûé_èíäåêñ</parameter> parameter. </para> <para> <example> <title>Ïðèìåð èñïîëüçîâàíèÿ <function>array_fill</function></title> <programlisting role="php"> <![CDATA[ $a = array_fill(5, 6, 'banana'); ]]> </programlisting> <para> Ïåðåìåííàÿ $a òåïåðü ñîäåðæèò ñëåäóþùèå çíà÷åíèÿ (âûâîä ôóíêöèè <function>print_r</function>): <screen> <![CDATA[ Array ( [5] => banana [6] => banana [7] => banana [8] => banana [9] => banana [10] => banana ) ]]> </screen> </para> </example> </para> </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:"../../../../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 --> Index: phpdoc-ru/reference/array/functions/array-filter.xml +++ phpdoc-ru/reference/array/functions/array-filter.xml <?xml version="1.0" encoding="windows-1251"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/array.xml, last change in rev 1.62 --> <refentry id="function.array-filter"> <refnamediv> <refname>array_filter</refname> <refpurpose> Ïðèìåíÿåò ôèëüòð ê ìàññèâó, èñïîëüçóÿ ôóíêöèþ îáðàòíîãî âûçîâà </refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>ìàññèâ</type><methodname>array_filter</methodname> <methodparam><type>ìàññèâ</type><parameter>èñõîäíûé_ìàññèâ</parameter></methodparam> <methodparam choice="opt"><type>ñìåøàííîå</type><parameter>ôóíêöèÿ</parameter></methodparam> </methodsynopsis> <para> Ôóíêöèÿ <function>array_filter</function> âîçâðàùàåò ìàññèâ, ñîäåðæàùèé çíà÷åíèÿ ìàññèâà <parameter>èñõîäíûé_ìàññèâ</parameter>, îòôèëüòðîâàííûå â ñîîòâåòñòâèè ñ ðåçóëüòàòîì ôóíêöèè îáðàòíîãî âûçîâà. Åñëè <parameter>èñõîäíûé_ìàññèâ</parameter> ÿâëÿåòñÿ àññîöèàòèâíûì ìàññèâîì, åãî êëþ÷è ñîõðàíÿþòñÿ. </para> <para> <example> <title>Ïðèìåð èñïîëüçîâàíèÿ <function>array_filter</function></title> <programlisting role="php"> <![CDATA[ function odd($var) { return ($var % 2 == 1); } function even($var) { return ($var % 2 == 0); } $array1 = array ("a"=>1, "b"=>2, "c"=>3, "d"=>4, "e"=>5); $array2 = array (6, 7, 8, 9, 10, 11, 12); echo "Íå÷åòíûå :\n"; print_r(array_filter($array1, "odd")); echo "×åòíûå :\n"; print_r(array_filter($array2, "even")); ]]> </programlisting> <para> Ðåçóëüòàòîì âûïîëíåíèÿ âûøåïðèâåäåííîé ïðîãðàììû áóäåò: <screen role="php"> <![CDATA[ Íå÷åòíûå : Array ( [a] => 1 [c] => 3 [e] => 5 ) ×åòíûå : Array ( [0] => 6 [2] => 8 [4] => 10 [6] => 12 ) ]]> </screen> </para> </example> </para> ¬e.func-callback; <para> Ïîëüçîâàòåëè íå äîëæíû èçìåíÿòü ìàññèâ â ðåçóëüòàòå åãî îáðàáîòêè ôóíêöèåé îáðàòíîãî âûçîâà, íàïðèìåð, äîáàâëÿòü èëè óäàëÿòü ýëåìåíò èëè îáíóëÿòü ìàññèâ, îáðàáàòûâàåìûé ôóíêöèåé <function>array_filter</function>. Åñëè ìàññèâ ïîäâåðãàåòñÿ èçìåíåíèÿì, ïîâåäåíèå ýòîé ôóíêöèè ñòàíîâèòñÿ íåîïðåäåëåííûì. </para> <para> Ñì.òàêæå <function>array_map</function> è <function>array_reduce</function>. </para> </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:"../../../../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 --> Index: phpdoc-ru/reference/array/functions/array-flip.xml +++ phpdoc-ru/reference/array/functions/array-flip.xml <?xml version="1.0" encoding="windows-1251"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/array.xml, last change in rev 1.107 --> <refentry id="function.array-flip"> <refnamediv> <refname>array_flip</refname> <refpurpose>Ïîìåíÿòü ìåñòàìè çíà÷åíèÿ ìàññèâà</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>ìàññèâ</type><methodname>array_flip</methodname> <methodparam><type>ìàññèâ</type><parameter>èñõîäíûé_ìàññèâ</parameter></methodparam> </methodsynopsis> <para> Ôóíêöèÿ <function>array_flip</function> âîçâðàùàåò <type>ìàññèâ</type> â îáðàòíîì ïîðÿäêå, òî åñòü êëþ÷è ìàññèâà <parameter>èñõîäíûé_ìàññèâ</parameter> ñòàíîâÿòñÿ çíà÷åíèÿìè, à çíà÷åíèÿ ìàññèâà <parameter>èñõîäíûé_ìàññèê</parameter> ñòàíîâÿòñÿ êëþ÷àìè. </para> <para> Îáðàòèòå âíèìàíèå, ÷òî çíà÷åíèÿ ìàññèâà <parameter>èñõîäíûé_ìàññèâ</parameter> äîëæíû áûòü êîððåêòíûìè êëþ÷àìè, òî åñòü îíè äîëæíû èìåòü òèï <type>öåëîå</type> èëè <type>ñòðîêà</type>. Åñëè çíà÷åíèå èìååò íåâåðíûé òèï, áóäåò âûäàíî ïðåäóïðåæäåíèå è ïàðà êëþ÷/çíà÷åíèå <emphasis>íå áóäåò îáðàáîòàíà</emphasis>. </para> <para> Åñëè çíà÷åíèå âñòðå÷àåòñÿ íåñêîëüêî ðàç, äëÿ îáðàáîòêè áóäåò èñïîëüçîâàòüñÿ ïîñëåäíèé âñòðå÷åííûé êëþ÷, à âñå îñòàëüíûå áóäóò ïîòåðÿíû. </para> <para> Ôóíêöèÿ <function>array_flip</function> âîçâðàùàåò &false;, åñëè îáðàáîòêà ìàññèâà âûçâàëà îøèáêó. </para> <para> <example> <title>Ïðèìåð èñïîëüçîâàíèÿ <function>array_flip</function></title> <programlisting role="php"> <![CDATA[ $trans = array_flip ($trans); $original = strtr ($str, $trans); ]]> </programlisting> </example> </para> <para> <example> <title>Ïðèìåð èñïîëüçîâàíèÿ <function>array_flip</function>: ìíîãîêðàòíîå ïîâòîðåíèå çíà÷åíèÿ</title> <programlisting role="php"> <![CDATA[ $trans = array ("a" => 1, "b" => 1, "c" => 2); $trans = array_flip ($trans); print_r($trans); ]]> </programlisting> <para> òåïåðü $trans ñîäåðæèò: <screen> <![CDATA[ Array ( [1] => b [2] => c ) ]]> </screen> </para> </example> </para> </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:"../../../../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 --> Index: phpdoc-ru/reference/array/functions/array-intersect.xml +++ phpdoc-ru/reference/array/functions/array-intersect.xml <?xml version="1.0" encoding="windows-1251"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/array.xml, last change in rev 1.14 --> <refentry id="function.array-intersect"> <refnamediv> <refname>array_intersect</refname> <refpurpose>Âû÷èñëèòü ñõîæäåíèå ìàññèâîâ</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>ìàññèâ</type><methodname>array_intersect</methodname> <methodparam><type>ìàññèâ</type><parameter>ìàññèâ_1</parameter></methodparam> <methodparam><type>ìàññèâ</type><parameter>ìàññèâ_2</parameter></methodparam> <methodparam choice="opt"><type>array</type><parameter> ...</parameter></methodparam> </methodsynopsis> <para> Ôóíêöèÿ <function>array_intersect</function> âîçâðàùàåò ìàññèâ, ñîäåðæàùèé çíà÷åíèÿ ìàññèâà <parameter>ìàññèâ_1</parameter>, êîòîðûå ñîäåðæàò âñå ïåðå÷èñëåííûå â àðãóìåíòàõ ìàññèâû. Îáðàòèòå âíèìàíèå, ÷òî êëþ÷è ñîõðàíÿþòñÿ. </para> <para> <example> <title>Ïðèìåð èñïîëüçîâàíèÿ <function>array_intersect</function></title> <programlisting role="php"> <![CDATA[ $array1 = array ("a" => "green", "red", "blue"); $array2 = array ("b" => "green", "yellow", "red"); $result = array_intersect ($array1, $array2); ]]> </programlisting> <para>  ðåçóëüòàòå âûïîëíåíèÿ ïåðåìåííàÿ <varname>$result</varname> áóäåò ñîäåðæàòü <screen role="php"> <![CDATA[ Array ( [a] => green [0] => red ) ]]> </screen> </para> </example> </para> <note> <simpara> Äâà ýëåìåíòà ñ÷èòàþòñÿ îäèíàêîâûìè òîãäà è òîëüêî òîãäà, êîãäà <literal>(string) $elem1 === (string) $elem2</literal>. Äðóãèìè ñëîâàìè, êîãäà èõ ñòðîêîâûå ïðåäñòàâëåíèÿ èäåíòè÷íû. <!-- TODO: example of it... --> </simpara> </note> <warning> <simpara> <!-- This was broken in PHP 4.0.4! NOTE: do not uncomment this until context of above sentence is clear enough to translate. --> <!-- TODO: when exactly was this broken?... --> </simpara> </warning> <para> Ñì.òàêæå <function>array_diff</function>. </para> </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:"../../../../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 --> Index: phpdoc-ru/reference/array/functions/array-key-exists.xml +++ phpdoc-ru/reference/array/functions/array-key-exists.xml <?xml version="1.0" encoding="windows-1251"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/array.xml, last change in rev 1.119 --> <refentry id="function.array-key-exists"> <refnamediv> <refname>array_key_exists</refname> <refpurpose>Ïðîâåðèòü, ïðèñóòñòâóåò ëè â ìàññèâå óêàçàííûé êëþ÷ èëè èíäåêñ</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>ëîãè÷åñêîå</type><methodname>array_key_exists</methodname> <methodparam><type>ñìåøàííîå</type><parameter>êëþ÷</parameter></methodparam> <methodparam><type>ìàññèâ</type><parameter>èñõîäíûé_ìàññèâ</parameter></methodparam> </methodsynopsis> <para> Ôóíêöèÿ <function>array_key_exists</function> âîçâðàùàåò &true;, åñëè â ìàññèâå ïðèñóòñòâóåò óêàçàííîå çíà÷åíèå <parameter>êëþ÷</parameter>. Ïàðàìåòð <parameter>êëþ÷</parameter> ìîæåò áûòü ëþáûì çíà÷åíèåì, êîòîðîå ïîäõîäèò äëÿ îïèñàíèÿ èíäåêñà ìàññèâà. </para> <para> <example> <title>Ïðèìåð èñïîëüçîâàíèÿ <function>array_key_exists</function></title> <programlisting role="php"> <![CDATA[ $search_array = array("first" => 1, "second" => 4); if (array_key_exists("first", $search_array)) { echo "The 'first' element is in the array"; } ]]> </programlisting> </example> </para> <note> <simpara>  PHP âåðñèè 4.0.6 íàçâàíèå ýòîé ôóíêöèè - <function>key_exists</function>. </simpara> </note> <para> Ñì.òàêæå <function>isset</function>. </para> </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:"../../../../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 --> Index: phpdoc-ru/reference/array/functions/array-keys.xml +++ phpdoc-ru/reference/array/functions/array-keys.xml <?xml version="1.0" encoding="windows-1251"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/array.xml, last change in rev 1.2 --> <refentry id="function.array-keys"> <refnamediv> <refname>array_keys</refname> <refpurpose>Âûáðàòü âñå êëþ÷è ìàññèâà</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>ìàññèâ</type><methodname>array_keys</methodname> <methodparam><type>ìàññèâ</type><parameter>èñõîäíûé_ìàññèâ</parameter></methodparam> <methodparam choice="opt"><type>ñìåøàííîå</type><parameter> çíà÷åíèå_äëÿ_ïîèñêà </parameter></methodparam> </methodsynopsis> <para> Ôóíêöèÿ <function>array_keys</function> âîçâðàùàåò ÷èñëîâûå è ñòðîêîâûå êëþ÷è, ñîäåðæàùèåñÿ â ìàññèâå <parameter>èñõîäíûé_ìàññèâ</parameter>. </para> <para> Åñëè óêàçàí íåîáÿçàòåëüíûé ïàðàìåòð <parameter>çíà÷åíèå_äëÿ_ïîèñêà</parameter>, ôóíêöèÿ âîçâðàùàåò òîëüêî êëþ÷è, ñîâïàäàþùèå ñ ýòèì ïàðàìåòðîì.  îáðàòíîì ñëó÷àå, ôóíêöèÿ âîçâðàùàåò âñå êëþ÷è ìàññèâà <parameter>èñõîäíûé_ìàññèâ</parameter>. </para> <para> <example> <title>Ïðèìåð èñïîëüçîâàíèÿ <function>array_keys</function></title> <programlisting role="php"> <![CDATA[ $array = array (0 => 100, "color" => "red"); print_r(array_keys ($array)); $array = array ("blue", "red", "green", "blue", "blue"); print_r(array_keys ($array, "blue")); $array = array ("color" => array("blue", "red", "green"), "size" => array("small", "medium", "large")); print_r(array_keys ($array)); ]]> </programlisting> <para> Ðåçóëüòàòîì âûïîëíåíèÿ âûøåïðèâåäåííîé ïðîãðàììû áóäåò: <screen> <![CDATA[ Array ( [0] => 0 [1] => color ) Array ( [0] => 0 [1] => 3 [2] => 4 ) Array ( [0] => color [1] => size ) ]]> </screen> </para> </example> </para> <note> <para> Ýòà ôóíêöèÿ ïîÿâèëàñü â PHP 4. Íèæå ïðèâåäåí åå ýêâèâàëåíò äëÿ PHP 3. <example> <title> Ýêâèâàëåíò ôóíêöèè <function>array_keys</function> â PHP 3 </title> <programlisting role="php"> <![CDATA[ function array_keys ($arr, $term="") { $t = array(); while (list($k,$v) = each($arr)) { if ($term && $v != $term) { continue; } $t[] = $k; } return $t; } ]]> </programlisting> </example> </para> </note> <para> Ñì.òàêæå <function>array_values</function>. </para> </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:"../../../../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 -->
Index: phpdoc-ru/reference/array/functions/array-change-key-case.xml +++ phpdoc-ru/reference/array/functions/array-change-key-case.xml <?xml version="1.0" encoding="windows-1251"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/array.xml, last change in rev 1.113 --> <refentry id="function.array-change-key-case"> <refnamediv> <refname>array_change_key_case</refname> <refpurpose>Âîçâðàùàåò ìàññèâ, ñèìâîëüíûå êëþ÷è êîòîðîãî ïðåîáðàçîâàíû â âåðõíèé èëè íèæíèé ðåãèñòð ñèìâîëîâ</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>ìàññèâ</type><methodname>array_change_key_case</methodname> <methodparam><type>ìàññèâ</type><parameter>èñõîäíûé_ìàññèâ</parameter></methodparam> <methodparam choice="opt"><type>öåëîå</type><parameter>ðåãèñòð_ñèìâîëîâ</parameter></methodparam> </methodsynopsis> <para> Ôóíêöèÿ <function>array_change_key_case</function> ïðåîáðàçóåò êëþ÷è ìàññèâà <parameter>èñõîäíûé_ìàññèâ</parameter> â âåðõíèé èëè íèæíèé ðåãèñòð ñèìâîëîâ. Òèï ïðåîáðàçîâàíèÿ çàâèñèò îò ïîñëåäíåãî îïöèîíàëüíîãî ïàðàìåòðà <parameter>ðåãèñòð_ñèìâîëîâ</parameter>.  êà÷åñòâå ýòîãî ïàðàìåòðà âû ìîæåòå ïåðåäàòü îäíó èç äâóõ êîíñòàíò: <constant>CASE_UPPER</constant> è <constant>CASE_LOWER</constant>. Ïî óìîë÷àíèþ èñïîëüçóåòñÿ <constant>CASE_LOWER</constant>. Ýòà ôóíêöèÿ íå èçìåíÿåò êëþ÷è, ñîñòîÿùèå èç ÷èñåë. </para> <example> <title>Ïðèìåð èñïîëüçîâàíèÿ <function>array_change_key_case</function></title> <programlisting role="php"> <![CDATA[ $input_array = array("FirSt" => 1, "SecOnd" => 4); print_r(array_change_key_case($input_array, CASE_UPPER)); ]]> </programlisting> <para> Ðåçóëüòàòîì âûïîëíåíèÿ âûøåïðèâåäåííîé ïðîãðàììû áóäåò: <screen> <![CDATA[ Array ( [FIRST] => 1 [SECOND] => 2 ) ]]> </screen> </para> </example> </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:"../../../../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 --> Index: phpdoc-ru/reference/array/functions/array-chunk.xml +++ phpdoc-ru/reference/array/functions/array-chunk.xml <?xml version="1.0" encoding="windows-1251"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/array.xml, last change in rev 1.2 --> <refentry id="function.array-chunk"> <refnamediv> <refname>array_chunk</refname> <refpurpose>Ðàçáèòü ìàññèâ íà ÷àñòè</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>ìàññèâ</type><methodname>array_chunk</methodname> <methodparam><type>ìàññèâ</type><parameter>èñõîäíûé_ìàññèâ</parameter></methodparam> <methodparam><type>öåëîå</type><parameter>ðàçìåð</parameter></methodparam> <methodparam choice="opt"><type>ëîãè÷åñêîå</type><parameter>ñîõðàíÿòü_êëþ÷è</parameter></methodparam> </methodsynopsis> <para> Ôóíêöèÿ <function>array_chunk</function> ðàçáèâàåò ìàññèâ íà íåñêîëüêî ìàññèâîâ ðàçìåðîì <parameter>ðàçìåð</parameter> çíà÷åíèé. Ïîñëåäíèé ìàññèâ èç ïîëó÷åííûõ ìîæåò ñîäåðæàòü ìåíüøåå êîëè÷åñòâî çíà÷åíèé, ÷åì óêàçàíî.  êà÷åñòâå ðåçóëüòàòà ôóíêöèÿ âîçâðàùàåò ìíîãîðàçìåðíûé ìàññèâ ñ èíäåêñàìè, íà÷èíàþùèìèñÿ ñ íóëÿ è ýëåìåíòàìè, êîòîðûìè ÿâëÿþòñÿ ìàññèâû, ïîëó÷åííûå â ðåçóëüòàòå ðàçáèâêè. </para> <para> Åñëè âû ïåðåäàäèòå çíà÷åíèå &true; â êà÷åñòâå íåîáÿçàòåëüíîãî ïàðàìåòðà <parameter>preserve_keys</parameter>, PHP ñîõðàíèò êëþ÷è èç èñõîäíîãî ìàññèâà. Åñëè çíà÷åíèå ýòîãî ïàðàìåòðà ðàâíî &false;, ýëåìåíòû ðåçóëüòèðóþùèõ ìàññèâîâ áóäóò ïðîèíäåêñèðîâàíû ÷èñëàìè, íà÷èíàÿ ñ íóëÿ. Ïî óìîë÷àíèþ èñïîëüçóåòñÿ çíà÷åíèå &false;. </para> <example> <title>Ïðèìåð èñïîëüçîâàíèÿ <function>array_chunk</function></title> <programlisting role="php"> <![CDATA[ $input_array = array('a', 'b', 'c', 'd', 'e'); print_r(array_chunk($input_array, 2)); print_r(array_chunk($input_array, 2, TRUE)); ]]> </programlisting> <para> Ðåçóëüòàòîì âûïîëíåíèÿ âûøåïðèâåäåííîé ïðîãðàììû áóäåò: <screen> <![CDATA[ Array ( [0] => Array ( [0] => a [1] => b ) [1] => Array ( [0] => c [1] => d ) [2] => Array ( [0] => e ) ) Array ( [0] => Array ( [0] => a [1] => b ) [1] => Array ( [2] => c [3] => d ) [2] => Array ( [4] => e ) ) ]]> </screen> </para> </example> </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:"../../../../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 --> Index: phpdoc-ru/reference/array/functions/array-count-values.xml +++ phpdoc-ru/reference/array/functions/array-count-values.xml <?xml version="1.0" encoding="windows-1251"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/array.xml, last change in rev 1.2 --> <refentry id="function.array-count-values"> <refnamediv> <refname>array_count_values</refname> <refpurpose>Ïîäñ÷èòàòü êîëè÷åñòâî âñåõ çíà÷åíèé ìàññèâà</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>ìàññèâ</type><methodname>array_count_values</methodname> <methodparam><type>ìàññèâ</type><parameter>èñõîäíûé_ìàññèâ</parameter></methodparam> </methodsynopsis> <para> Ôóíêöèÿ <function>array_count_values</function> âîçâðàùàåò ìàññèâ, êëþ÷àìè êîòîðîãî ÿâëÿþòñÿ çíà÷åíèÿ ìàññèâà <parameter>èñõîäíûé_ìàññèâ</parameter>, à çíà÷åíèÿìè - ÷àñòîòà ïîâòîðåíèÿ ýòèõ çíà÷åíèé. </para> <para> <example> <title>Ïðèìåð èñïîëüçîâàíèÿ <function>array_count_values</function></title> <programlisting role="php"> <![CDATA[ $array = array (1, "hello", 1, "world", "hello"); print_r(array_count_values ($array)); ]]> </programlisting> <para> Ðåçóëüòàòîì âûøåïðèâåäåííîé ïðîãðàììû áóäåò: <screen> <![CDATA[ Array ( [1] => 2 [hello] => 2 [world] => 1 ) ]]> </screen> </para> </example> </para> </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:"../../../../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 --> Index: phpdoc-ru/reference/array/functions/array-diff.xml +++ phpdoc-ru/reference/array/functions/array-diff.xml <?xml version="1.0" encoding="windows-1251"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/array.xml, last change in rev 1.14 --> <refentry id="function.array-diff"> <refnamediv> <refname>array_diff</refname> <refpurpose>Âû÷èñëèòü ðàñõîæäåíèå â ìàññèâàõ</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>ìàññèâ</type><methodname>array_diff</methodname> <methodparam><type>ìàññèâ</type><parameter>ìàññèâ_1</parameter></methodparam> <methodparam><type>ìàññèâ</type><parameter>ìàññèâ_2</parameter></methodparam> <methodparam choice="opt"><type>ìàññèâ</type><parameter> ...</parameter></methodparam> </methodsynopsis> <para> Ôóíêöèÿ <function>array_diff</function> âîçâðàùàåò ìàññèâ, ñîñòîÿùèé èç çíà÷åíèé ìàññèâà <parameter>ìàññèâ_1</parameter>, êîòîðûå îòñóòñòâóþò â ëþáîì äðóãîì ìàññèâå, ïåðå÷èñëåííîì â ïîñëåäóþùèõ àðãóìåíòàõ. Îáðàòèòå âíèìàíèå, ÷òî êëþ÷è ìàññèâîâ ñîõðàíÿþòñÿ. </para> <para> <example> <title>Ïðèìåð èñïîëüçîâàíèÿ <function>array_diff</function></title> <programlisting role="php"> <![CDATA[ $array1 = array ("a" => "green", "red", "blue", "red"); $array2 = array ("b" => "green", "yellow", "red"); $result = array_diff ($array1, $array2); ]]> </programlisting> </example> </para> <para>  ðåçóëüòàòå âûïîëíåíèÿ ýòîé ïðîãðàììû ïåðåìåííàÿ <varname>$result</varname> áóäåò ñîäåðæàòü <literal>array ("blue");</literal>. Ïîâòîðåíèÿ îäíîãî è òîãî æå çíà÷åíèÿ â $array1 îáðàáàòûâàþòñÿ êàê îäíî çíà÷åíèå. </para> <note> <simpara> Äâà ýëåìåíòà ñ÷èòàþòñÿ îäèíàêîâûìè åñëè è òîëüêî åñëè <literal>(string) $elem1 === (string) $elem2</literal>. Äðóãèìè ñëîâàìè, êîãäà èõ ñòðîêîâîå ïðåäñòàâëåíèå èäåíòè÷íî. <!-- TODO: example of it... --> </simpara> </note> <note> <simpara> Îáðàòèòå âíèìàíèå, ÷òî ýòà ôóíêöèÿ îáðàáàòûâàåò òîëüêî îäíî èçìåðåíèå n-ðàçìåðíîãî ìàññèâà. Åñòåñòâåííî, âû ìîæåòå îáðàáàòûâàòü è áîëåå ãëóáîêèå óðîâíè âëîæåííîñòè, íàïðèìåð, èñïîëüçóÿ <literal>array_diff($array1[0], $array2[0]);</literal>. </simpara> </note> <warning> <simpara> <!-- This was broken in PHP 4.0.4! NOTE: do not uncomment this until context of above sentence is clear enough to translate. --> <!-- TODO: when exactly was this broken?... --> </simpara> </warning> <para> Ñì.òàêæå <function>array_intersect</function>. </para> </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:"../../../../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 --> Index: phpdoc-ru/reference/array/functions/array-fill.xml +++ phpdoc-ru/reference/array/functions/array-fill.xml <?xml version="1.0" encoding="windows-1251"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/array.xml, last change in rev 1.2 --> <refentry id="function.array-fill"> <refnamediv> <refname>array_fill</refname> <refpurpose>Çàïîëíèòü ìàññèâ îïðåäåëåííûì çíà÷åíèåì</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>ìàññèâ</type><methodname>array_fill</methodname> <methodparam><type>öåëîå</type><parameter>íà÷àëüíûé_èíäåêñ</parameter></methodparam> <methodparam><type>öåëîå</type><parameter>êîëè÷åñòâî</parameter></methodparam> <methodparam><type>ñìåøàííîå</type><parameter>çíà÷åíèå</parameter></methodparam> </methodsynopsis> <para> Ôóíêöèÿ <function>array_fill</function> âîçâðàùàåò ìàññèâ, ñîäåðæàùèé <parameter>êîëè÷åñòâî</parameter> ýëåìåíòîâ, èìåþùèõ çíà÷åíèå ïàðàìåòðà <parameter>çíà÷åíèå</parameter>. Íóìåðàöèÿ êëþ÷åé ýëåìåíòîâ ìàññèâà íà÷èíàþòñÿ ñî çíà÷åíèÿ ïàðàìåòðà <parameter>íà÷àëüíûé_èíäåêñ</parameter> parameter. </para> <para> <example> <title>Ïðèìåð èñïîëüçîâàíèÿ <function>array_fill</function></title> <programlisting role="php"> <![CDATA[ $a = array_fill(5, 6, 'banana'); ]]> </programlisting> <para> Ïåðåìåííàÿ $a òåïåðü ñîäåðæèò ñëåäóþùèå çíà÷åíèÿ (âûâîä ôóíêöèè <function>print_r</function>): <screen> <![CDATA[ Array ( [5] => banana [6] => banana [7] => banana [8] => banana [9] => banana [10] => banana ) ]]> </screen> </para> </example> </para> </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:"../../../../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 --> Index: phpdoc-ru/reference/array/functions/array-filter.xml +++ phpdoc-ru/reference/array/functions/array-filter.xml <?xml version="1.0" encoding="windows-1251"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/array.xml, last change in rev 1.62 --> <refentry id="function.array-filter"> <refnamediv> <refname>array_filter</refname> <refpurpose> Ïðèìåíÿåò ôèëüòð ê ìàññèâó, èñïîëüçóÿ ôóíêöèþ îáðàòíîãî âûçîâà </refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>ìàññèâ</type><methodname>array_filter</methodname> <methodparam><type>ìàññèâ</type><parameter>èñõîäíûé_ìàññèâ</parameter></methodparam> <methodparam choice="opt"><type>ñìåøàííîå</type><parameter>ôóíêöèÿ</parameter></methodparam> </methodsynopsis> <para> Ôóíêöèÿ <function>array_filter</function> âîçâðàùàåò ìàññèâ, ñîäåðæàùèé çíà÷åíèÿ ìàññèâà <parameter>èñõîäíûé_ìàññèâ</parameter>, îòôèëüòðîâàííûå â ñîîòâåòñòâèè ñ ðåçóëüòàòîì ôóíêöèè îáðàòíîãî âûçîâà. Åñëè <parameter>èñõîäíûé_ìàññèâ</parameter> ÿâëÿåòñÿ àññîöèàòèâíûì ìàññèâîì, åãî êëþ÷è ñîõðàíÿþòñÿ. </para> <para> <example> <title>Ïðèìåð èñïîëüçîâàíèÿ <function>array_filter</function></title> <programlisting role="php"> <![CDATA[ function odd($var) { return ($var % 2 == 1); } function even($var) { return ($var % 2 == 0); } $array1 = array ("a"=>1, "b"=>2, "c"=>3, "d"=>4, "e"=>5); $array2 = array (6, 7, 8, 9, 10, 11, 12); echo "Íå÷åòíûå :\n"; print_r(array_filter($array1, "odd")); echo "×åòíûå :\n"; print_r(array_filter($array2, "even")); ]]> </programlisting> <para> Ðåçóëüòàòîì âûïîëíåíèÿ âûøåïðèâåäåííîé ïðîãðàììû áóäåò: <screen role="php"> <![CDATA[ Íå÷åòíûå : Array ( [a] => 1 [c] => 3 [e] => 5 ) ×åòíûå : Array ( [0] => 6 [2] => 8 [4] => 10 [6] => 12 ) ]]> </screen> </para> </example> </para> ¬e.func-callback; <para> Ïîëüçîâàòåëè íå äîëæíû èçìåíÿòü ìàññèâ â ðåçóëüòàòå åãî îáðàáîòêè ôóíêöèåé îáðàòíîãî âûçîâà, íàïðèìåð, äîáàâëÿòü èëè óäàëÿòü ýëåìåíò èëè îáíóëÿòü ìàññèâ, îáðàáàòûâàåìûé ôóíêöèåé <function>array_filter</function>. Åñëè ìàññèâ ïîäâåðãàåòñÿ èçìåíåíèÿì, ïîâåäåíèå ýòîé ôóíêöèè ñòàíîâèòñÿ íåîïðåäåëåííûì. </para> <para> Ñì.òàêæå <function>array_map</function> è <function>array_reduce</function>. </para> </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:"../../../../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 --> Index: phpdoc-ru/reference/array/functions/array-flip.xml +++ phpdoc-ru/reference/array/functions/array-flip.xml <?xml version="1.0" encoding="windows-1251"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/array.xml, last change in rev 1.107 --> <refentry id="function.array-flip"> <refnamediv> <refname>array_flip</refname> <refpurpose>Ïîìåíÿòü ìåñòàìè çíà÷åíèÿ ìàññèâà</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>ìàññèâ</type><methodname>array_flip</methodname> <methodparam><type>ìàññèâ</type><parameter>èñõîäíûé_ìàññèâ</parameter></methodparam> </methodsynopsis> <para> Ôóíêöèÿ <function>array_flip</function> âîçâðàùàåò <type>ìàññèâ</type> â îáðàòíîì ïîðÿäêå, òî åñòü êëþ÷è ìàññèâà <parameter>èñõîäíûé_ìàññèâ</parameter> ñòàíîâÿòñÿ çíà÷åíèÿìè, à çíà÷åíèÿ ìàññèâà <parameter>èñõîäíûé_ìàññèê</parameter> ñòàíîâÿòñÿ êëþ÷àìè. </para> <para> Îáðàòèòå âíèìàíèå, ÷òî çíà÷åíèÿ ìàññèâà <parameter>èñõîäíûé_ìàññèâ</parameter> äîëæíû áûòü êîððåêòíûìè êëþ÷àìè, òî åñòü îíè äîëæíû èìåòü òèï <type>öåëîå</type> èëè <type>ñòðîêà</type>. Åñëè çíà÷åíèå èìååò íåâåðíûé òèï, áóäåò âûäàíî ïðåäóïðåæäåíèå è ïàðà êëþ÷/çíà÷åíèå <emphasis>íå áóäåò îáðàáîòàíà</emphasis>. </para> <para> Åñëè çíà÷åíèå âñòðå÷àåòñÿ íåñêîëüêî ðàç, äëÿ îáðàáîòêè áóäåò èñïîëüçîâàòüñÿ ïîñëåäíèé âñòðå÷åííûé êëþ÷, à âñå îñòàëüíûå áóäóò ïîòåðÿíû. </para> <para> Ôóíêöèÿ <function>array_flip</function> âîçâðàùàåò &false;, åñëè îáðàáîòêà ìàññèâà âûçâàëà îøèáêó. </para> <para> <example> <title>Ïðèìåð èñïîëüçîâàíèÿ <function>array_flip</function></title> <programlisting role="php"> <![CDATA[ $trans = array_flip ($trans); $original = strtr ($str, $trans); ]]> </programlisting> </example> </para> <para> <example> <title>Ïðèìåð èñïîëüçîâàíèÿ <function>array_flip</function>: ìíîãîêðàòíîå ïîâòîðåíèå çíà÷åíèÿ</title> <programlisting role="php"> <![CDATA[ $trans = array ("a" => 1, "b" => 1, "c" => 2); $trans = array_flip ($trans); print_r($trans); ]]> </programlisting> <para> òåïåðü $trans ñîäåðæèò: <screen> <![CDATA[ Array ( [1] => b [2] => c ) ]]> </screen> </para> </example> </para> </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:"../../../../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 --> Index: phpdoc-ru/reference/array/functions/array-intersect.xml +++ phpdoc-ru/reference/array/functions/array-intersect.xml <?xml version="1.0" encoding="windows-1251"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/array.xml, last change in rev 1.14 --> <refentry id="function.array-intersect"> <refnamediv> <refname>array_intersect</refname> <refpurpose>Âû÷èñëèòü ñõîæäåíèå ìàññèâîâ</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>ìàññèâ</type><methodname>array_intersect</methodname> <methodparam><type>ìàññèâ</type><parameter>ìàññèâ_1</parameter></methodparam> <methodparam><type>ìàññèâ</type><parameter>ìàññèâ_2</parameter></methodparam> <methodparam choice="opt"><type>array</type><parameter> ...</parameter></methodparam> </methodsynopsis> <para> Ôóíêöèÿ <function>array_intersect</function> âîçâðàùàåò ìàññèâ, ñîäåðæàùèé çíà÷åíèÿ ìàññèâà <parameter>ìàññèâ_1</parameter>, êîòîðûå ñîäåðæàò âñå ïåðå÷èñëåííûå â àðãóìåíòàõ ìàññèâû. Îáðàòèòå âíèìàíèå, ÷òî êëþ÷è ñîõðàíÿþòñÿ. </para> <para> <example> <title>Ïðèìåð èñïîëüçîâàíèÿ <function>array_intersect</function></title> <programlisting role="php"> <![CDATA[ $array1 = array ("a" => "green", "red", "blue"); $array2 = array ("b" => "green", "yellow", "red"); $result = array_intersect ($array1, $array2); ]]> </programlisting> <para>  ðåçóëüòàòå âûïîëíåíèÿ ïåðåìåííàÿ <varname>$result</varname> áóäåò ñîäåðæàòü <screen role="php"> <![CDATA[ Array ( [a] => green [0] => red ) ]]> </screen> </para> </example> </para> <note> <simpara> Äâà ýëåìåíòà ñ÷èòàþòñÿ îäèíàêîâûìè òîãäà è òîëüêî òîãäà, êîãäà <literal>(string) $elem1 === (string) $elem2</literal>. Äðóãèìè ñëîâàìè, êîãäà èõ ñòðîêîâûå ïðåäñòàâëåíèÿ èäåíòè÷íû. <!-- TODO: example of it... --> </simpara> </note> <warning> <simpara> <!-- This was broken in PHP 4.0.4! NOTE: do not uncomment this until context of above sentence is clear enough to translate. --> <!-- TODO: when exactly was this broken?... --> </simpara> </warning> <para> Ñì.òàêæå <function>array_diff</function>. </para> </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:"../../../../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 --> Index: phpdoc-ru/reference/array/functions/array-key-exists.xml +++ phpdoc-ru/reference/array/functions/array-key-exists.xml <?xml version="1.0" encoding="windows-1251"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/array.xml, last change in rev 1.119 --> <refentry id="function.array-key-exists"> <refnamediv> <refname>array_key_exists</refname> <refpurpose>Ïðîâåðèòü, ïðèñóòñòâóåò ëè â ìàññèâå óêàçàííûé êëþ÷ èëè èíäåêñ</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>ëîãè÷åñêîå</type><methodname>array_key_exists</methodname> <methodparam><type>ñìåøàííîå</type><parameter>êëþ÷</parameter></methodparam> <methodparam><type>ìàññèâ</type><parameter>èñõîäíûé_ìàññèâ</parameter></methodparam> </methodsynopsis> <para> Ôóíêöèÿ <function>array_key_exists</function> âîçâðàùàåò &true;, åñëè â ìàññèâå ïðèñóòñòâóåò óêàçàííîå çíà÷åíèå <parameter>êëþ÷</parameter>. Ïàðàìåòð <parameter>êëþ÷</parameter> ìîæåò áûòü ëþáûì çíà÷åíèåì, êîòîðîå ïîäõîäèò äëÿ îïèñàíèÿ èíäåêñà ìàññèâà. </para> <para> <example> <title>Ïðèìåð èñïîëüçîâàíèÿ <function>array_key_exists</function></title> <programlisting role="php"> <![CDATA[ $search_array = array("first" => 1, "second" => 4); if (array_key_exists("first", $search_array)) { echo "The 'first' element is in the array"; } ]]> </programlisting> </example> </para> <note> <simpara>  PHP âåðñèè 4.0.6 íàçâàíèå ýòîé ôóíêöèè - <function>key_exists</function>. </simpara> </note> <para> Ñì.òàêæå <function>isset</function>. </para> </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:"../../../../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 --> Index: phpdoc-ru/reference/array/functions/array-keys.xml +++ phpdoc-ru/reference/array/functions/array-keys.xml <?xml version="1.0" encoding="windows-1251"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/array.xml, last change in rev 1.2 --> <refentry id="function.array-keys"> <refnamediv> <refname>array_keys</refname> <refpurpose>Âûáðàòü âñå êëþ÷è ìàññèâà</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>ìàññèâ</type><methodname>array_keys</methodname> <methodparam><type>ìàññèâ</type><parameter>èñõîäíûé_ìàññèâ</parameter></methodparam> <methodparam choice="opt"><type>ñìåøàííîå</type><parameter> çíà÷åíèå_äëÿ_ïîèñêà </parameter></methodparam> </methodsynopsis> <para> Ôóíêöèÿ <function>array_keys</function> âîçâðàùàåò ÷èñëîâûå è ñòðîêîâûå êëþ÷è, ñîäåðæàùèåñÿ â ìàññèâå <parameter>èñõîäíûé_ìàññèâ</parameter>. </para> <para> Åñëè óêàçàí íåîáÿçàòåëüíûé ïàðàìåòð <parameter>çíà÷åíèå_äëÿ_ïîèñêà</parameter>, ôóíêöèÿ âîçâðàùàåò òîëüêî êëþ÷è, ñîâïàäàþùèå ñ ýòèì ïàðàìåòðîì.  îáðàòíîì ñëó÷àå, ôóíêöèÿ âîçâðàùàåò âñå êëþ÷è ìàññèâà <parameter>èñõîäíûé_ìàññèâ</parameter>. </para> <para> <example> <title>Ïðèìåð èñïîëüçîâàíèÿ <function>array_keys</function></title> <programlisting role="php"> <![CDATA[ $array = array (0 => 100, "color" => "red"); print_r(array_keys ($array)); $array = array ("blue", "red", "green", "blue", "blue"); print_r(array_keys ($array, "blue")); $array = array ("color" => array("blue", "red", "green"), "size" => array("small", "medium", "large")); print_r(array_keys ($array)); ]]> </programlisting> <para> Ðåçóëüòàòîì âûïîëíåíèÿ âûøåïðèâåäåííîé ïðîãðàììû áóäåò: <screen> <![CDATA[ Array ( [0] => 0 [1] => color ) Array ( [0] => 0 [1] => 3 [2] => 4 ) Array ( [0] => color [1] => size ) ]]> </screen> </para> </example> </para> <note> <para> Ýòà ôóíêöèÿ ïîÿâèëàñü â PHP 4. Íèæå ïðèâåäåí åå ýêâèâàëåíò äëÿ PHP 3. <example> <title> Ýêâèâàëåíò ôóíêöèè <function>array_keys</function> â PHP 3 </title> <programlisting role="php"> <![CDATA[ function array_keys ($arr, $term="") { $t = array(); while (list($k,$v) = each($arr)) { if ($term && $v != $term) { continue; } $t[] = $k; } return $t; } ]]> </programlisting> </example> </para> </note> <para> Ñì.òàêæå <function>array_values</function>. </para> </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:"../../../../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 -->