archived-doc-es/reference/array/functions/current.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: cd943f94a013b74df8765ab8e1a620a916a64a85 Maintainer: yago Status: ready -->
<!-- Reviewed: yes Maintainer: julionc -->
<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 class="union"><type>array</type><type>object</type></type><parameter>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="changelog">
  &reftitle.changelog;
  <para>
   <informaltable>
    <tgroup cols="2">
     <thead>
      <row>
       <entry>&Version;</entry>
       <entry>&Description;</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>7.0.0</entry>
       <entry>
        <parameter>array</parameter> ahora siempre se pasa por el valor.
        Antes de esta versión, se pasaba por referencia si era posible,
        y por el valor de lo contrario.
       </entry>
      </row>
     </tbody>
    </tgroup>
   </informaltable>
  </para>
 </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>
    The results of calling <function>current</function> on an empty array
    and on an array, whose internal pointer points beyond the end of the elements,
    are indistinguishable from a <type>bool</type> &false; element.
    To properly traverse an array which may contain &false; elements, see the
    <function>foreach</function> function.
   </simpara>
   <simpara>
    Los resultados al llamar <function>current</function> en un array vacío
    y en un array, cuyo puntero interno apunta más allá del final de los elementos,
    son indistinguibles de un elemento de tipo <type>bool</type> &false;.
    Para recorrer adecuadamente un array que puede contener elementos &false;,
    ver la función <function>foreach</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
-->