/documentation/es/designers/language-builtin-functions/language-function-foreach.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- $Revision: 2972 $ -->
		<sect1 id="language.function.foreach">
   <title>{foreach},{foreachelse}</title>
            <informaltable frame="all">
                <tgroup cols="5">
                <colspec colname="param" align="center" />
                <colspec colname="type" align="center" />
                <colspec colname="required" align="center" />
                <colspec colname="default" align="center" />
                <colspec colname="desc" />
                <thead>
                    <row>
                        <entry>Nombre del Atributo</entry>
                        <entry>Tipo</entry>
                        <entry>Requerido</entry>
                        <entry>Default</entry>
                        <entry>Descripción</entry>
                    </row>
                </thead>
                <tbody>
                    <row>
                        <entry>from</entry>
                        <entry>array</entry>
                        <entry>Si</entry>
                        <entry><emphasis>n/a</emphasis></entry>
                        <entry>El nombre de la matriz a la que usted estara pegando los elementos</entry>
                    </row>
                    <row>
                        <entry>item</entry>
                        <entry>string</entry>
                        <entry>Si</entry>
                        <entry><emphasis>n/a</emphasis></entry>
                        <entry>El nombre de la variable que es el elemento
                        actual</entry>
                    </row>
                    <row>
                        <entry>key</entry>
                        <entry>string</entry>
                        <entry>No</entry>
						<entry><emphasis>n/a</emphasis></entry>
						<entry>El nombre de la variable que es la llave actual</entry>
                    </row>
                    <row>
                        <entry>name</entry>
                        <entry>string</entry>
                        <entry>No</entry>
                        <entry><emphasis>n/a</emphasis></entry>
						<entry>El nombre del ciclo foreach para acessar a las propiedades del foreach</entry>
                    </row>
                </tbody>
                </tgroup>
            </informaltable>
			<para>
    Los ciclos(loop) <emphasis>foreach</emphasis> son una alternativa para loop 
    <link linkend="language.function.section"><emphasis>{section}</emphasis></link>. 
    <emphasis>foreach</emphasis> es usado para pegar cada elemento de una  
    <emphasis role="bold">matriz asociativa simple</emphasis>.
    La sintaxis para <emphasis>foreach</emphasis> es mucho mas simple que 
    <emphasis>section</emphasis>, pero tiene una desventaja de que solo puede ser 
    usada en una única matriz.
    La etiqueta  <emphasis>foreach</emphasis> debe tener su par 
    <emphasis>/foreach</emphasis>.
    Los parámetros requeridos son <emphasis>from</emphasis> e 
    <emphasis>item</emphasis>. El nombre del ciclo(loop) foreach puede ser 
    cualquier cosa que usted quiera, hecho de letras, números y subrayados. 
    Los ciclos(loop) <emphasis>foreach</emphasis> pueden ser anidados, 
    y el nombre de los ciclos(loop) anidados debe ser diferente uno de
    otro. La variable <emphasis>from</emphasis> (normalmente una matriz de valores) 
    determina el número de veces del ciclo(loop) <emphasis>foreach</emphasis>.
    <emphasis>foreachelse</emphasis> y ejecutando cuando no hubieren mas valores 
    en la variable <emphasis>from</emphasis>.
			</para>
<example>
<title>foreach</title>
<programlisting role="php">
   <![CDATA[
   <?php
   $arr = array( 1001,1002,1003);
   $smarty->assign('custid', $arr);
   ?>
   ]]>
</programlisting>

  <programlisting>
<![CDATA[
{* este ejemplo muestra todos los valores de la matriz $custid *}
{foreach from=$custid item=curr_id}
  id: {$curr_id}<br />
{/foreach}
]]>
  </programlisting>
  <para>
   Esta es la salida del ejemplo de arriba:
  </para>
  <screen>
<![CDATA[
id: 1000<br />
id: 1001<br />
id: 1002<br />
]]>
  </screen>
</example>

<example>
<title>foreach key</title>
  <programlisting role="php">
<![CDATA[
// La llave contiene la llave para cada valor del ciclo(loop)
//asignacion fisica de esta manera:
<?php
 $smarty->assign('contacts', array(
                             array('phone' => '1',
                                   'fax' => '2',
                                   'cell' => '3'),
                             array('phone' => '555-4444',
                                   'fax' => '555-3333',
                                   'cell' => '760-1234')
                             ));
?>
]]>
  </programlisting>
  <programlisting>
<![CDATA[
{foreach name=outer item=contact from=$contacts}
  <hr />
  {foreach key=key item=item from=$contact}
    {$key}: {$item}<br />
  {/foreach}
{/foreach}
]]>
  </programlisting>
  <para>
   Esta es la salida del ejemplo de arriba:
  </para>
  <screen>
<![CDATA[
<hr />
  phone: 1<br />
  fax: 2<br />
  cell: 3<br />
<hr />
  phone: 555-4444<br />
  fax: 555-3333<br />
  cell: 760-1234<br />
]]>
  </screen>
 </example>
 <example>
  <title>Ejemplo de {foreach} - con base de datos (eg PEAR o ADODB)</title>
<programlisting role="php">
<![CDATA[
<?php
  $sql = 'select contact_id, name, nick from contacts order by contact';
  $smarty->assign("contacts", $db->getAssoc($sql));
?>
]]>
  </programlisting>
  <programlisting>
<![CDATA[
{foreach key=cid item=con from=$contacts}
  <a href="contact.php?contact_id={$cid}">{$con.name} - {$con.nick}</a><br />
{/foreach}
]]>
  </programlisting>
 </example>

		<para>
   El ciclo(Loop) foreach también tiene sus propias variables para
   manipular las propiedades del foreach.
   Estas son indicadas así: 
   <link linkend="language.variables.smarty.loops">{$smarty.foreach.foreachname.varname}</link> 
   con foreachname siendo el nombre especificado del atributo
   <emphasis>name</emphasis> del foreach.
		</para>
  <para>Ver <link linkend="section.property.index">{section}</link>
  para ejemplos ide las propiedades bajo las cuales son identicos.
  </para>

			<sect2 id="foreach.property.iteration">
			<title>iteration</title>
			<para>
    iteration es usado para mostrar la interación actual del ciclo(loop).
    iteration siempre comienza en 1 incrementado en uno cada interación.
			</para>
			</sect2>

			<sect2 id="foreach.property.first">
			<title>first</title>
			<para>
    <emphasis>first</emphasis> Toma el valor true si la interación actual del 
     foreach es la primera.
			</para>
			</sect2>

			<sect2 id="foreach.property.last">
			<title>last</title>
			<para>
      <emphasis>last</emphasis> Toma el valor de true si la interación actual 
       del foreach es la ultima.
			</para>
			</sect2>

			<sect2 id="foreach.property.show">
			<title>show</title>
			<para>
         <emphasis>show</emphasis> Es usado como parámetro para el foreach.
         <emphasis>show</emphasis> Es un valor booleano, true o false.
         Si es false, el foreach no será mostrado.  Si tuviera un
         foreachelse presente, este será alternativamente mostrado.
			</para>

			</sect2>
			<sect2 id="foreach.property.total">
			<title>total</title>
			<para>
      <emphasis>total</emphasis> Es usado para mostrar el número de interaciones 
      del foreach. Este puede ser usado dentro o después de el.
			</para>
  <para>
   Ver tambien <link linkend="language.function.section">{section}</link> y
   <link linkend="language.variables.smarty.loops">$smarty.foreach</link>.
  </para>
			</sect2>

</sect1>

<!-- 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
-->