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

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.3 $ -->
<!-- EN-Revision: 1.9 Maintainer: baoengb Status: ready -->
<!-- splitted from ./es/functions/array.xml, last change in rev 1.1 -->
  <refentry id="function.current">
   <refnamediv>
    <refname>current</refname>
    <refpurpose>Devuelve el elemento actual de una matriz</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripci&oacute;n</title>
     <methodsynopsis>
     <type>mixed</type><methodname>current</methodname>
     <methodparam><type>array</type><parameter role="reference">matriz</parameter></methodparam>
     </methodsynopsis>
    <para>
     Cada matriz tiene un puntero interno al elemento "actual", que se
     inicializa al primer elemento insertado en la misma.
    </para>
    <para>
     La funci&oacute;n <function>current</function> simplemente devuelve el
     elemento de la tabla al que apunta el puntero interno. No mueve
     el puntero de ninguna manera. Si el puntero interno apunta fuera
     del final de la lista de elementos, <function>current</function>
     devuelve &false;.
     <warning>
      <para>
       Si la matriz contiene elementos vac&iacute;os (0 o "", la cadena
       vac&iacute;a) esta funci&oacute;n devolver&aacute; &false; tambi&eacute;n 
       para dichos elementos. Esto hace imposible determinar si se est&aacute; 
       realmente al final de la lista en tales matrices usando 
       <function>current</function>. Para recorrer adecuadamente una matriz que 
       pueda contener elementos vac&iacute;os, utilice la funci&oacute;n 
       <function>each</function>.
      </para>
     </warning>
    </para>
    <para>
     <example>
      <title>Ejemplo: uso de <function>current</function> y amigos</title>
      <programlisting role="php">
<![CDATA[
<?php
$transport = array('foot', 'bike', 'car', 'plane');
$mode = current($transport); // $mode = 'foot';
$mode = next($transport);    // $mode = 'bike';
$mode = current($transport); // $mode = 'bike';
$mode = prev($transport);    // $mode = 'foot';
$mode = end($transport);     // $mode = 'plane';
$mode = current($transport); // $mode = 'plane';
?>
]]>
      </programlisting>
     </example>
    </para>
    <para>
     Vea tambi&eacute;n: <function>end</function>, 
     <function>key</function>,
     <function>next</function>,
     <function>prev</function> y 
     <function>reset</function>.
    </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:"../../../../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
-->