svn: /phpdoc/ru/trunk/reference/array/functions/ array-push.xml

From: Date: Sun, 30 Jan 2011 08:55:40 +0000
Subject: svn: /phpdoc/ru/trunk/reference/array/functions/ array-push.xml
Groups: php.doc.ru 
Request: Send a blank email to doc-ru+get-1302@lists.php.net to get a copy of this message
shein Sun, 30 Jan 2011 08:55:40 +0000 Revision: http://svn.php.net/viewvc?view=revision&revision=307847 Log: Updated translation. Changed paths: U phpdoc/ru/trunk/reference/array/functions/array-push.xml Modified: phpdoc/ru/trunk/reference/array/functions/array-push.xml =================================================================== --- phpdoc/ru/trunk/reference/array/functions/array-push.xml 2011-01-30 08:54:53 UTC (rev 307846) +++ phpdoc/ru/trunk/reference/array/functions/array-push.xml 2011-01-30 08:55:40 UTC (rev 307847) @@ -1,44 +1,86 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: n/a Maintainer: sveta Status: ready --> +<!-- EN-Revision: 297028 Maintainer: shein Status: ready --> +<!-- Reviewed: no --> <!-- $Revision$ --> -<!-- splitted from ./en/functions/array.xml, last change in rev 1.2 --> - <refentry xml:id="function.array-push" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>array_push</refname> - <refpurpose> - Добавить один или несколько элеметов в конец массива - </refpurpose> - </refnamediv> - <refsect1> - <title>Описание</title> - <methodsynopsis> - <type>int</type><methodname>array_push</methodname> - <methodparam><type>array</type><parameter>&amp;array</parameter></methodparam> - <methodparam><type>mixed</type><parameter>var</parameter></methodparam> - <methodparam choice="opt"><type>mixed</type><parameter>...</parameter></methodparam> - </methodsynopsis> - <para> - <function>array_push</function> использует - <parameter>array</parameter> как стэк, и добавляет переданные - значения в конец массива <parameter>array</parameter>. - Длина <parameter>array</parameter> увеличивается на количество - переданных значений. Имеет тот же эффект, что и выражение: - <programlisting role="php"> +<refentry xml:id="function.array-push" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>array_push</refname> + <refpurpose>Добавляет один или несколько элеметов в конец массива</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>array_push</methodname> + <methodparam><type>array</type><parameter role="reference">array</parameter></methodparam> + <methodparam><type>mixed</type><parameter>var</parameter></methodparam> + <methodparam choice="opt"><type>mixed</type><parameter>...</parameter></methodparam> + </methodsynopsis> + <para> + <function>array_push</function> использует <parameter>array</parameter> + как стэк, и добавляет переданные значения в конец массива <parameter>array</parameter>. + Длина <parameter>array</parameter> увеличивается на количество + переданных значений. Имеет тот же эффект, что и выражение: + <programlisting role="php"> <![CDATA[ <?php $array[] = $var; ?> ]]> - </programlisting> - повторенное для каждой <parameter>var</parameter>. - </para> - <para> - Возвращает новое количество элементов в массиве. - </para> - <para> - <example> - <title>Пример использования <function>array_push</function></title> - <programlisting role="php"> + </programlisting> + повторенное для каждой <parameter>var</parameter>. + </para> + <note> + <simpara> + Вместо использования <function>array_push</function> + для добавления одного элемента в массив, + лучше использовать <literal>$array[] = </literal>, + потому что в этом случае не происходит затрат на вызов функции. + </simpara> + </note> + <note> + <simpara> + <function>array_push</function> вызовет предупреждение, если + первый аргумент не является массивом. Это отличается от поведения + конструкции <literal>$var[]</literal>, в случае которой будет создан новый + массив. + </simpara> + </note> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>array</parameter></term> + <listitem> + <para> + Входной массив. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>var</parameter></term> + <listitem> + <para> + Записываемое значение. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Возвращает новое количество элементов в массиве. + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Пример использования <function>array_push</function></title> + <programlisting role="php"> <![CDATA[ <?php $stack = array("orange", "banana"); @@ -46,12 +88,9 @@ print_r($stack); ?> ]]> - </programlisting> - <para> - В результате выполнения этого примера, <varname>$stack</varname> - содержит следующие элементы: - </para> - <screen role="php"> + </programlisting> + &example.outputs; + <screen role="php"> <![CDATA[ Array ( @@ -61,23 +100,21 @@ [3] => raspberry ) ]]> - </screen> - </example> - </para> - <note> - <simpara> - Вместо использования <function>array_push</function> для добавления в массив одного элемента, - лучше использовать <literal>$array[] = </literal>, потому что в этом случае - не происходит вызова функции. - </simpara> - </note> - <para> - См. также <function>array_pop</function>, - <function>array_shift</function>, и - <function>array_unshift</function>. - </para> - </refsect1> - </refentry> + </screen> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>array_pop</function></member> + <member><function>array_shift</function></member> + <member><function>array_unshift</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -90,7 +127,7 @@ sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil -sgml-default-dtd-file:"../~/.phpdoc/manual.ced" +sgml-default-dtd-file:"~/.phpdoc/manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil

« previous php.doc.ru (#1302) next »