svn: /phpdoc/ru/trunk/reference/array/functions/ next.xml

shein Fri, 04 Feb 2011 09:58:46 +0000 Revision: http://svn.php.net/viewvc?view=revision&revision=307997 Log: Updated translation. Changed paths: U phpdoc/ru/trunk/reference/array/functions/next.xml Modified: phpdoc/ru/trunk/reference/array/functions/next.xml =================================================================== --- phpdoc/ru/trunk/reference/array/functions/next.xml 2011-02-04 09:51:29 UTC (rev 307996) +++ phpdoc/ru/trunk/reference/array/functions/next.xml 2011-02-04 09:58:46 UTC (rev 307997) @@ -1,47 +1,59 @@ <?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.next" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>next</refname> - <refpurpose> - Передвинуть внутренний указатель массива на одну позицию вперёд - </refpurpose> - </refnamediv> - <refsect1> - <title>Описание</title> - <methodsynopsis> - <type>mixed</type><methodname>next</methodname> - <methodparam><type>array</type><parameter role="reference">array</parameter></methodparam> - </methodsynopsis> - <para> - Возвращает значение элемента массива, находящегося на позиции, следующей - за позицией, в которой находится его внутренний указатель или &false;, - если достигнут конец массива. - </para> - <para> - <function>next</function> ведёт себя подобно - <function>current</function>, но с одним отличием. Перед тем, как - возвратить значение элемента массива, эта функция передвигает его - внутренний указатель на одну позицию вперёд. - Другими словами, она возвращает следующий элемент массива и - сдвигает его внутренний указатель на одну позицию. Если при продвижении - внутренний указатель массива выйдет за предел списка элементов, - <function>next</function> возвратит &false;. - <warning> +<refentry xml:id="function.next" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>next</refname> + <refpurpose>Передвигает внутренний указатель массива на одну позицию вперёд</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>mixed</type><methodname>next</methodname> + <methodparam><type>array</type><parameter role="reference">array</parameter></methodparam> + </methodsynopsis> + <para> + <function>next</function> ведёт себя подобно + <function>current</function>, но с одним отличием. Перед тем, как + возвратить значение элемента массива, эта функция передвигает его + внутренний указатель на одну позицию вперёд. + Другими словами, она возвращает следующий элемент массива и + сдвигает его внутренний указатель на одну позицию. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>array</parameter></term> + <listitem> <para> - Если массив содержит пустые или равные 0 элементы, - функция возвратит &false; для этих элементов. - Для того, чтобы правильно просматривать массивы, содержащие пустые элементы, - используйте функцию <function>each</function>. + Массив <type>array</type> модифицируется данной функцией. </para> - </warning> - </para> - <para> - <example> - <title>Пример использования <function>next</function> и друзей</title> - <programlisting role="php"> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Возвращает значение элемента массива, находящегося на позиции, следующей + за позицией внутренний указателя или &false;, если достигнут конец массива. + </para> + &return.falseproblem; + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Пример использования <function>next</function> и друзей</title> + <programlisting role="php"> <![CDATA[ <?php $transport = array('foot', 'bike', 'car', 'plane'); @@ -52,17 +64,36 @@ $mode = end($transport); // $mode = 'plane'; ?> ]]> - </programlisting> - </example> - </para> - <para> - См. также - <function>current</function>, <function>end</function>, - <function>prev</function> и <function>reset</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="notes"> + &reftitle.notes; + <note> + <simpara> + Вы не сможете отличить конец массива от <type>boolean</type> + элемента &false;. Для корректного обхода массива, который может + содержать &false; элементы, смотрите функцию <function>each</function>. + </simpara> + </note> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>current</function></member> + <member><function>end</function></member> + <member><function>prev</function></member> + <member><function>reset</function></member> + <member><function>each</function></member> + </simplelist> + </para> + </refsect1> +</refentry> + <!-- Keep this comment at the end of the file Local variables: mode: sgml @@ -74,7 +105,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