<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/ref.cubrid.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'es',
  ),
  'this' => 
  array (
    0 => 'function.cubrid-fetch.php',
    1 => 'cubrid_fetch',
    2 => 'Obtener la siguiente fila de un conjunto de resultados',
  ),
  'up' => 
  array (
    0 => 'ref.cubrid.php',
    1 => 'Funciones de CUBRID',
  ),
  'prev' => 
  array (
    0 => 'function.cubrid-execute.php',
    1 => 'cubrid_execute',
  ),
  'next' => 
  array (
    0 => 'function.cubrid-free-result.php',
    1 => 'cubrid_free_result',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'es',
    'path' => 'reference/cubrid/functions/cubrid-fetch.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="function.cubrid-fetch" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">cubrid_fetch</h1>
  <p class="verinfo">(PECL CUBRID &gt;= 8.3.0)</p><p class="refpurpose"><span class="refname">cubrid_fetch</span> &mdash; <span class="dc-title">Obtener la siguiente fila de un conjunto de resultados</span></p>

 </div>

 <div class="refsect1 description" id="refsect1-function.cubrid-fetch-description">
  <h3 class="title">Descripción</h3>
  <div class="methodsynopsis dc-description">
   <span class="methodname"><strong>cubrid_fetch</strong></span>(<span class="methodparam"><span class="type"><a href="language.types.resource.php" class="type resource">resource</a></span> <code class="parameter">$result</code></span>, <span class="methodparam"><span class="type"><a href="language.types.integer.php" class="type int">int</a></span> <code class="parameter">$type</code><span class="initializer"> = CUBRID_BOTH</span></span>): <span class="type"><a href="language.types.mixed.php" class="type mixed">mixed</a></span></div>

  <p class="simpara">
   La función <span class="function"><strong>cubrid_fetch()</strong></span> se usa para obtener una única fila del resultado de la consulta. El cursor se mueve automáticamente a la siguiente columna después de obtener el resultado.
  </p>
 </div>


 <div class="refsect1 parameters" id="refsect1-function.cubrid-fetch-parameters">
  <h3 class="title">Parámetros</h3>
  <dl>
   
    <dt><code class="parameter">result</code></dt>
    <dd><span class="simpara"><code class="parameter">result</code> proviene de una llamada a la función <span class="function"><a href="function.cubrid-execute.php" class="function">cubrid_execute()</a></span>.</span></dd>
   
   
    <dt><code class="parameter">type</code></dt>
    <dd><span class="simpara">Tipo de array del resultado obtenido: CUBRID_NUM, CUBRID_ASSOC,
     CUBRID_BOTH, CUBRID_OBJECT. Si se operan con objetos lob, se puede
     usar CUBRID_LOB.</span></dd>
   
  </dl>
 </div>


 <div class="refsect1 returnvalues" id="refsect1-function.cubrid-fetch-returnvalues">
  <h3 class="title">Valores devueltos</h3>
  <p class="simpara">Un array de resultados u objeto, cuando el proceso tiene éxito.</p>
  <p class="simpara"><strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong>, cuando no existen más filas; NULL, cuando el proceso no tiene éxito.</p>
  <p class="simpara">El resultado se puede recibir como array o como objeto, por lo que se puede decidir qué tipo de datos usar estableciendo el argumento <code class="parameter">type</code>. La variable <code class="parameter">type</code> se puede establecer a uno de los siguientes valores:</p>
  <ul class="simplelist">
   <li>CUBRID_NUM : Array numérico (basado en 0)</li>
   <li>CUBRID_ASSOC : Array asociativo</li>
   <li>CUBRID_BOTH : Array numérico y asociativo (predeterminado)</li>
   <li>CUBRID_OBJECT : Objeto que tiene el nombre del atributo como el nombre de la columna del resultado de la consulta</li>
  </ul>
  <p class="simpara">Cuando se omite el argumento <code class="parameter">type</code>, el resultado será recibido usando la opción predeterminada CUBRID_BOTH. Cuando se quiere recibir el resultado de la consulta como objeto, el nombre de la columna del resultado debe obedecer las reglas de nombres de los identificadores de PHP. Por ejemplo, un nombre de columna como &quot;count(*)&quot; no puede ser recibido como objeto.</p>
 </div>


 <div class="refsect1 examples" id="refsect1-function.cubrid-fetch-examples">
  <h3 class="title">Ejemplos</h3>
  <div class="example" id="example-1">
   <p><strong>Ejemplo #1 Ejemplo de <span class="function"><strong>cubrid_fetch()</strong></span></strong></p>
   <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br />$conn </span><span style="color: #007700">= </span><span style="color: #0000BB">cubrid_connect</span><span style="color: #007700">(</span><span style="color: #DD0000">"localhost"</span><span style="color: #007700">, </span><span style="color: #0000BB">33000</span><span style="color: #007700">, </span><span style="color: #DD0000">"demodb"</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">$solicitud </span><span style="color: #007700">= </span><span style="color: #0000BB">cubrid_execute</span><span style="color: #007700">(</span><span style="color: #0000BB">$conexión</span><span style="color: #007700">, </span><span style="color: #DD0000">"SELECT * FROM stadium WHERE nation_code='GRE' AND seats &gt; 10000"</span><span style="color: #007700">);<br /><br /></span><span style="color: #0000BB">printf</span><span style="color: #007700">(</span><span style="color: #DD0000">"%-40s %-10s %-6s %-20s\n"</span><span style="color: #007700">, </span><span style="color: #DD0000">"name"</span><span style="color: #007700">, </span><span style="color: #DD0000">"area"</span><span style="color: #007700">, </span><span style="color: #DD0000">"seats"</span><span style="color: #007700">, </span><span style="color: #DD0000">"address"</span><span style="color: #007700">);<br />while (</span><span style="color: #0000BB">$fila </span><span style="color: #007700">= </span><span style="color: #0000BB">cubrid_fetch</span><span style="color: #007700">(</span><span style="color: #0000BB">$solicitud</span><span style="color: #007700">)) {<br />    </span><span style="color: #0000BB">printf</span><span style="color: #007700">(</span><span style="color: #DD0000">"%-40s %-10s %-6s %-20s\n"</span><span style="color: #007700">,<br />        </span><span style="color: #0000BB">$fila</span><span style="color: #007700">[</span><span style="color: #DD0000">"name"</span><span style="color: #007700">], </span><span style="color: #0000BB">$fila</span><span style="color: #007700">[</span><span style="color: #DD0000">"area"</span><span style="color: #007700">], </span><span style="color: #0000BB">$fila</span><span style="color: #007700">[</span><span style="color: #DD0000">"seats"</span><span style="color: #007700">], </span><span style="color: #0000BB">$fila</span><span style="color: #007700">[</span><span style="color: #DD0000">"address"</span><span style="color: #007700">]);<br />}<br /><br /></span><span style="color: #FF8000">// si se operan con objetos lob, se puede usar cubrid_fetch($solicitud, CUBRID_LOB)<br /><br /></span><span style="color: #0000BB">cubrid_close_request</span><span style="color: #007700">(</span><span style="color: #0000BB">$solicitud</span><span style="color: #007700">);<br /><br /></span><span style="color: #0000BB">cubrid_disconnect</span><span style="color: #007700">(</span><span style="color: #0000BB">$conexión</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
   </div>

   <div class="example-contents"><p>El ejemplo anterior mostrará:</p></div>
   <div class="example-contents screen">
<div class="examplescode"><pre class="examplescode">name                                     area       seats  address
Panathinaiko Stadium                     86300.00   50000  Athens, Greece
Olympic Stadium                          54700.00   13000  Athens, Greece
Olympic Indoor Hall                      34100.00   18800  Athens, Greece
Olympic Hall                             52400.00   21000  Athens, Greece
Olympic Aquatic Centre                   42500.00   11500  Athens, Greece
Markopoulo Olympic Equestrian Centre     64000.00   15000  Markopoulo, Athens, Greece
Faliro Coastal Zone Olympic Complex      34650.00   12171  Faliro, Athens, Greece
Athens Olympic Stadium                   120400.00  71030  Maroussi, Athens, Greece
Ano Liossia                              34000.00   12000  Ano Liosia, Athens, Greece</pre>
</div>
   </div>
  </div>
 </div>


 <div class="refsect1 seealso" id="refsect1-function.cubrid-fetch-seealso">
  <h3 class="title">Ver también</h3>
  <ul class="simplelist">
   <li><span class="function"><a href="function.cubrid-execute.php" class="function" rel="rdfs-seeAlso">cubrid_execute()</a> - Ejecutar una sentencia SQL preparada</span></li>
   <li><span class="function"><a href="function.cubrid-fetch-array.php" class="function" rel="rdfs-seeAlso">cubrid_fetch_array()</a> - Recupera una l&iacute;nea de resultado en forma de array asociativo, array num&eacute;rico, o ambos</span></li>
   <li><span class="function"><a href="function.cubrid-fetch-row.php" class="function" rel="rdfs-seeAlso">cubrid_fetch_row()</a> - Devuelve un array num&eacute;rico con los valores de la fila actual</span></li>
   <li><span class="function"><a href="function.cubrid-fetch-assoc.php" class="function" rel="rdfs-seeAlso">cubrid_fetch_assoc()</a> - Devuelve un array asociativo correspondiente a la fila recuperada</span></li>
   <li><span class="function"><a href="function.cubrid-fetch-object.php" class="function" rel="rdfs-seeAlso">cubrid_fetch_object()</a> - Recupera la siguiente l&iacute;nea y la devuelve como un objeto</span></li>
  </ul>
 </div>


</div><?php manual_footer($setup); ?>