Files
php-doc-ru/reference/array/functions/array-merge.xml
Ivan Kovalenko d80d4f4151 Encoding fixed.
git-svn-id: https://svn.php.net/repository/phpdoc/ru/trunk@95052 c90b9560-bf6c-de11-be94-00142212c4b1
2002-09-07 22:50:34 +00:00

136 lines
3.7 KiB
XML

<?xml version="1.0" encoding="windows-1251"?>
<!-- EN-Revision: 1.6 Maintainer: tronic Status: ready -->
<!-- $Revision: 1.3 $ -->
<!-- splitted from ./en/functions/array.xml, last change in rev 1.2 -->
<refentry id="function.array-merge">
<refnamediv>
<refname>array_merge</refname>
<refpurpose>Ñëèòü äâà èëè áîëüøåå êîëè÷åñòâî ìàññèâîâ</refpurpose>
</refnamediv>
<refsect1>
<title>Îïèñàíèå</title>
<methodsynopsis>
<type>ìàññèâ</type><methodname>array_merge</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_merge</function> ñëèâàåò ýëåìåíòû
äâóõ èëè áîëüøåãî êîëè÷åñòâà ìàññèâîâ òàêèì îáðàçîì, ÷òî
çíà÷åíèÿ îäíîãî ìàññèâà ïðèñîåäèíÿþòñÿ ê çíà÷åíèÿì ïðåäûäóùåãî.
Ðåçóëüòàòîì ðàáîòû ôóíêöèè ÿâëÿåòñÿ íîâûé ìàññèâ.
</para>
<para>
Åñëè âõîäíûå ìàññèâû èìåþò îäèíàêîâûå ñòðîêîâûå êëþ÷è, òîãäà
çíà÷åíèÿ, ñîîòâåòñòâóþùèå ýòèì êëþ÷àì, ðåêóðñèâíî ñëèâàþòñÿ
â îäèí ìàññèâ, òàêèì îáðàçîì, åñëè îäíî èç çíà÷åíèé ÿâëÿåòñÿ
ìàññèâîì, ôóíêöèÿ ñëèâàåò åãî ñ ñîîòâåòñòâóþùèì çíà÷åíèåì
â äðóãîì ìàññèâå. Îäíàêî, åñëè ìàññèâû èìåþò îäèíàêîâûå
÷èñëîâûå êëþ÷è, çíà÷åíèå, óïîìÿíóòîå ïîñëåäíèì, <emphasis
role="strong">íå çàìåíèò</emphasis> èñõîäíîå çíà÷åíèå, à áóäåò ñëèòî ñ íèì.
</para>
<para>
<example>
<title>Ïðèìåð èñïîëüçîâàíèÿ <function>array_merge</function></title>
<programlisting role="php">
<![CDATA[
$array1 = array ("color" => "red", 2, 4);
$array2 = array ("a", "b", "color" => "green", "shape" => "trapezoid", 4);
$result = array_merge ($array1, $array2);
]]>
</programlisting>
<para>
Ïåðåìåííàÿ <literal>$result</literal> áóäåò ñîäåðæàòü:
<screen role="php">
<![CDATA[
Array
(
[color] => green
[0] => 2
[1] => 4
[2] => a
[3] => b
[shape] => trapezoid
[4] => 4
)
]]>
</screen>
</para>
</example>
</para>
<para>
<example>
<title>Ïðèìåð ïðîñòîãî èñïîëüçîâàíèÿ <function>array_merge</function></title>
<programlisting role="php">
<![CDATA[
$array1 = array();
$array2 = array(1 => "data");
$result = array_merge($array1, $array2);
]]>
</programlisting>
<para>
Íå çàáûâàéòå, ÷òî ÷èñëîâûå êëþ÷è áóäóò ïåðåíóìåðîâàíû!
<screen role="php">
<![CDATA[
Array
(
[0] => data
)
]]>
</screen>
</para>
<para>
Åñëè âû õîòèòå ïîëíîñòüþ ñîõðàíèòü ìàññèâû è ïðîñòî ñëèòü
èõ âìåñòå, èñïîëüçóéòå îïåðàòîð <literal>+</literal>:
<programlisting role="php">
<![CDATA[
$array1 = array();
$array2 = array(1 => "data");
$result = $array1 + $array2;
]]>
</programlisting>
×èñëîâîé êëþ÷ áóäåò ñîõðàíåí, ïîýòîìó àññîöèàöèÿ òàêæå ñîõðàíÿåòñÿ.
<screen role="php">
<![CDATA[
Array
(
[1] => data
)
]]>
</screen>
</para>
</example>
</para>
<note>
<para>
Îáùèå êëþ÷è áóäóò ïåðåçàïèñàíû ïî ïðèíöèïó "ïåðâûé ïðèøåë - ïåðâûé îáðàáîòàí".
</para>
</note>
<para>
Ñì.òàêæå <function>array_merge_recursive</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
-->