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

From: Date: Wed, 02 Feb 2011 09:18:58 +0000
Subject: svn: /phpdoc/ru/trunk/reference/array/functions/ current.xml
Groups: php.doc.ru 
Request: Send a blank email to doc-ru+get-1327@lists.php.net to get a copy of this message
shein Wed, 02 Feb 2011 09:18:58 +0000 Revision: http://svn.php.net/viewvc?view=revision&revision=307944 Log: Updated translation. Changed paths: U phpdoc/ru/trunk/reference/array/functions/current.xml Modified: phpdoc/ru/trunk/reference/array/functions/current.xml =================================================================== --- phpdoc/ru/trunk/reference/array/functions/current.xml 2011-02-02 09:10:43 UTC (rev 307943) +++ phpdoc/ru/trunk/reference/array/functions/current.xml 2011-02-02 09:18:58 UTC (rev 307944) @@ -1,44 +1,55 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: n/a Maintainer: sveta Status: ready --> +<!-- EN-Revision: 307359 Maintainer: shein Status: ready --> +<!-- Reviewed: no --> <!-- $Revision$ --> -<!-- splitted from ./en/functions/array.xml, last change in rev 1.2 --> - <refentry xml:id="function.current" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>current</refname> - <refpurpose>Возвратить текущий элемент массива</refpurpose> - </refnamediv> - <refsect1> - <title>Описание</title> - <methodsynopsis> - <type>mixed</type><methodname>current</methodname> - <methodparam><type>array</type><parameter role="reference">array</parameter></methodparam> - </methodsynopsis> - <para> - У каждого массива имеется внутренний указатель на его "текущий" элемент, - который инициализирован первым элементом, добавленным в массив. - </para> - <para> - Функция <function>current</function> просто возвращает значение - элемента массива, на который указывает его внутренний указатель. - Она не перемещает указатель куда бы то ни было. Если - внутренний указатель за пределами списка элементов, - <function>current</function> возвращает &false;. - <warning> +<refentry xml:id="function.current" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>current</refname> + <refpurpose>Возвращает текущий элемент массива</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>mixed</type><methodname>current</methodname> + <methodparam><type>array</type><parameter>array</parameter></methodparam> + </methodsynopsis> + <para> + У каждого массива имеется внутренний указатель на его "текущий" элемент, + который инициализирован первым элементом, добавленным в массив. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>array</parameter></term> + <listitem> <para> - Если массив содержит пустые элементы (0 или "", пустая - строка), эта функция возвратит &false; - для этих элементов. Это делает невозможным установить - в действительности ли достигнут конец списка элементов - массива при помощи функции <function>current</function>. - Для того, чтобы правильно просматривать массивы, содержащие - пустые элементы, используйте функцию <function>each</function>. + Массив. </para> - </warning> - </para> - <para> - <example> - <title>Пример использования <function>current</function> и дружественных функций</title> - <programlisting role="php"> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Функция <function>current</function> просто возвращает значение + элемента массива, на который указывает его внутренний указатель. + Она не перемещает указатель куда бы то ни было. Если + внутренний указатель находится за пределами списка элементов или + массив пуст, <function>current</function> возвращает &false;. + </para> + &return.falseproblem; + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Пример использования <function>current</function> и дружественных функций</title> + <programlisting role="php"> <![CDATA[ <?php $transport = array('foot', 'bike', 'car', 'plane'); @@ -48,18 +59,42 @@ $mode = prev($transport); // $mode = 'foot'; $mode = end($transport); // $mode = 'plane'; $mode = current($transport); // $mode = 'plane'; + +$arr = array(); +var_dump(current($arr)); // bool(false) + +$arr = array(array()); +var_dump(current($arr)); // array(0) { } ?> ]]> - </programlisting> - </example> - </para> - <para> - См. также <function>end</function>, <function>key</function>, - <function>next</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>end</function></member> + <member><function>key</function></member> + <member><function>each</function></member> + <member><function>prev</function></member> + <member><function>reset</function></member> + <member><function>next</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -72,7 +107,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 (#1327) next »