mirror of
https://github.com/php/doc-ru.git
synced 2025-08-16 18:22:04 +00:00
Updated translation.
git-svn-id: https://svn.php.net/repository/phpdoc/ru/trunk@307997 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Shein Alexey
@ -1,47 +1,59 @@
|
||||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<!-- EN-Revision: n/a Maintainer: sveta Status: ready -->
|
||||
<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 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,16 +64,35 @@ $mode = prev($transport); // $mode = 'bike';
|
||||
$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:
|
||||
@ -74,7 +105,7 @@ sgml-indent-step:1
|
||||
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
|
||||
|
||||
Reference in New Issue
Block a user