1
0
mirror of https://github.com/php/doc-es.git synced 2026-03-24 23:42:11 +01:00
Files
archived-doc-es/reference/array/functions/current.xml
Yago Ferrer 1354248c03 updated to the most recent version.
git-svn-id: https://svn.php.net/repository/phpdoc/es/trunk@310291 c90b9560-bf6c-de11-be94-00142212c4b1
2011-04-17 20:41:04 +00:00

120 lines
3.4 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 89a73e348c5d4bdd0300996566c672035745e2b0 Maintainer: yago Status: ready -->
<refentry xml:id="function.current" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>current</refname>
<refpurpose>Devuelve el elemento actual en un array</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>mixed</type><methodname>current</methodname>
<methodparam><type>array</type><parameter role="reference">array</parameter></methodparam>
</methodsynopsis>
<para>
Cada array tiene un puntero interno a su elemento "actual",
que es iniciado desde el primer elemento insertado en el
array.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>array</parameter></term>
<listitem>
<para>
El array.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
La función <function>current</function> simplemente devuelve el
valor del elemento del array que está siendo apuntado por el
puntero interno. No desplaza el puntero de ninguna manera. Si el
puntero interno apunta más allá del final de la lista de elementos o el array
está vacío, <function>current</function> devolverá &false;.
</para>
&return.falseproblem;
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Ejemplo de uso de <function>current</function> y similares</title>
<programlisting role="php">
<![CDATA[
<?php
$transport = array('pie', 'bici', 'coche', 'avión');
$mode = current($transport); // $mode = 'pie';
$mode = next($transport); // $mode = 'bici';
$mode = current($transport); // $mode = 'bici';
$mode = prev($transport); // $mode = 'pie';
$mode = end($transport); // $mode = 'avión';
$mode = current($transport); // $mode = 'avión';
$arr = array();
var_dump(current($arr)); // bool(false)
$arr = array(array());
var_dump(current($arr)); // array(0) { }
?>
]]>
</programlisting>
</example>
</para>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
<note>
<simpara>
No hay manera de distinguir el inicio de un array de un elemento
de tipo &false; <type>boolean</type>. Para recorrer adecuadamente
que puede contener elementos &false; ver la función
<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:
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:"~/.phpdoc/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
-->