archived-doc-es/reference/com/examples.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: a657af6cc4924b8ead92070821ca27d7504593e4 Maintainer: seros Status: ready -->

<chapter xml:id="com.examples" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 &reftitle.examples;

 <section xml:id="com.examples.foreach">
  <title>For Each</title>
  <para>
   Desde PHP 5 se puede usar la sentencia
   &foreach; propia de PHP para iterar
   sobre el contenido de un COM/OLE IEnumVariant estándar. En términos entendibles,
   esto significa que se puede usar foreach en lugares donde se podría usar
   <literal>For Each</literal> en código VB/ASP.
  </para>
  <para>
   <example>
    <title>For Each en ASP</title>
    <programlisting role="asp">
<![CDATA[
<%
Set domainObject = GetObject("WinNT://Domain")
For Each obj in domainObject
  Response.Write obj.Name & "<br />"
Next
%>
]]>
    </programlisting>
   </example>
  </para>
  <para>
   <example>
    <title>while() ... Next() en PHP 4</title>
    <programlisting role="php">
<![CDATA[
<?php 
$domainObject = new COM("WinNT://Domain"); 
while ($obj = $domainObject->Next()) { 
   echo $obj->Name . "<br />"; 
} 
?>
]]>
    </programlisting>
   </example>
  </para>
  <para>
   <example>
    <title>foreach en PHP 5</title>
    <programlisting role="php">
<![CDATA[
<?php 
$domainObject = new COM("WinNT://Domain"); 
foreach ($domainObject as $obj) { 
   echo $obj->Name . "<br />"; 
} 
?>
]]>
    </programlisting>
   </example>
  </para>
 </section>

 <section xml:id="com.examples.arrays">
  <title>Arrays y propiedades estilo array de COM</title>
  <para>
   Muchos objetos COM exponen sus propiedades como arrays, o usan el acceso
   estilo array. En PHP 4 se puede usar la sintaxis de array de PHP para leer/escribir tales
   propiedades, pero únicamente se permite una sola dimensión. Si se quiere leer una
   propiedad multidimensional, en su lugar se podría hacer el acceso a la propiedad
   dentro de una llamada a una función, cada parámetro representando cada dimensión del
   acceso al array, pero no hay forma de escribir tal propiedad.
  </para>
  <para>
   PHP 5 introduce la siguiente característica nueva para hacerle la vida más fácil:
   <itemizedlist>
    <listitem>
     <para>
      Acceder a arrays multidimensionales, o propiedades COM que requieren
      múltiples parámetros usando la sintaxis de array de PHP. También se puede escribir o establecer
      propiedades usando esta técnica.
     </para>
    </listitem>
    <listitem>
     <para>
      Iterar SafeArrays (arrays "verdaderos") usando la estructura de control &foreach;.  
      Esto funciona ya que SafeArrays incluye información sobre su tamaño. Si una
      propiedad estilo array implementa IEnumVariant, también se puede usar
      foreach para esa property; eche un vistazo a <xref
      linkend="com.examples.foreach"/> para más información sobre este tema.
     </para>
    </listitem>
   </itemizedlist>
  </para>
 </section>

</chapter>