<?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 => 'pt_BR',
  ),
  'this' => 
  array (
    0 => 'function.cubrid-fetch.php',
    1 => 'cubrid_fetch',
    2 => 'Busca a pr&oacute;xima linha do conjunto de resultados',
  ),
  'up' => 
  array (
    0 => 'ref.cubrid.php',
    1 => 'Fun&ccedil;&otilde;es 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' => 'pt_BR',
    '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">Busca a próxima linha do conjunto de resultados</span></p>

 </div>

 <div class="refsect1 description" id="refsect1-function.cubrid-fetch-description">
  <h3 class="title">Descrição</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">
   A função <span class="function"><strong>cubrid_fetch()</strong></span> é usada para obter uma única linha do resultado da consulta. O cursor é movido automaticamente para a linha seguinte após a obtenção do 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> vem de uma chamada a <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 do resultado buscado: CUBRID_NUM, CUBRID_ASSOC,
     CUBRID_BOTH ou CUBRID_OBJECT. Se for necessário operar em um objeto LOB, pode-se
     usar CUBRID_LOB.</span></dd>
   
  </dl>
 </div>


 <div class="refsect1 returnvalues" id="refsect1-function.cubrid-fetch-returnvalues">
  <h3 class="title">Valor Retornado</h3>
  <p class="simpara">Array de resultados ou objeto em caso de sucesso.</p>
  <p class="simpara"><strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong>, quando não houver mais linhas; NULL em caso de falha.</p>
  <p class="simpara">O resultado pode ser recebido como um array ou como um objeto e pode-se decidir que tipo de dados será usado configurando-se o parâmetro <code class="parameter">type</code>. O parâmetro <code class="parameter">type</code> pode ser definido para um dos seguintes valores:</p>
   <ul class="simplelist">
    <li>CUBRID_NUM : array numérico (iniciando em 0)</li>
    <li>CUBRID_ASSOC : array associativo</li>
    <li>CUBRID_BOTH : array numérico e associativo (padrão)</li>
    <li>CUBRID_OBJECT : objeto que tem o nome de atributo como o nome da coluna do resultado da consulta</li>
   </ul>
  <p class="simpara">Quando o argumento <code class="parameter">type</code> for omitido, o resultado será recebido usando a opção CUBRID_BOTH como padrão. Quando a intenção for receber o resultado como um objeto, o nome da coluna do resultado precisa seguir as regras de nomes de identificadores do PHP. Por exemplo, um nome de coluna &quot;count(*)&quot; não pode ser recebido como um objeto.</p>
 </div>


 <div class="refsect1 examples" id="refsect1-function.cubrid-fetch-examples">
  <h3 class="title">Exemplos</h3>
  <div class="example" id="example-1">
   <p><strong>Exemplo #1 Exemplo 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">$req </span><span style="color: #007700">= </span><span style="color: #0000BB">cubrid_execute</span><span style="color: #007700">(</span><span style="color: #0000BB">$conn</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 %-9s %-20s\n"</span><span style="color: #007700">, </span><span style="color: #DD0000">"nome"</span><span style="color: #007700">, </span><span style="color: #DD0000">"área"</span><span style="color: #007700">, </span><span style="color: #DD0000">"assentos"</span><span style="color: #007700">, </span><span style="color: #DD0000">"endereço"</span><span style="color: #007700">);<br />while (</span><span style="color: #0000BB">$row </span><span style="color: #007700">= </span><span style="color: #0000BB">cubrid_fetch</span><span style="color: #007700">(</span><span style="color: #0000BB">$req</span><span style="color: #007700">)) {<br />    </span><span style="color: #0000BB">printf</span><span style="color: #007700">(</span><span style="color: #DD0000">"%-40s %-10s %-9s %-20s\n"</span><span style="color: #007700">,<br />        </span><span style="color: #0000BB">$row</span><span style="color: #007700">[</span><span style="color: #DD0000">"name"</span><span style="color: #007700">], </span><span style="color: #0000BB">$row</span><span style="color: #007700">[</span><span style="color: #DD0000">"area"</span><span style="color: #007700">], </span><span style="color: #0000BB">$row</span><span style="color: #007700">[</span><span style="color: #DD0000">"seats"</span><span style="color: #007700">], </span><span style="color: #0000BB">$row</span><span style="color: #007700">[</span><span style="color: #DD0000">"address"</span><span style="color: #007700">]);<br />}<br /><br /></span><span style="color: #FF8000">// se for desejado operar em objeto LOB, pode-se usar cubrid_fetch($req, CUBRID_LOB)<br /><br /></span><span style="color: #0000BB">cubrid_close_request</span><span style="color: #007700">(</span><span style="color: #0000BB">$req</span><span style="color: #007700">);<br /><br /></span><span style="color: #0000BB">cubrid_disconnect</span><span style="color: #007700">(</span><span style="color: #0000BB">$conn</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
   </div>

   <div class="example-contents"><p>O exemplo acima produzirá:</p></div>
   <div class="example-contents screen">
<div class="examplescode"><pre class="examplescode">nome                                     área       assentos  endereço
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">Veja Também</h3>
  <ul class="simplelist">
   <li><span class="function"><a href="function.cubrid-execute.php" class="function" rel="rdfs-seeAlso">cubrid_execute()</a> - Executa uma instru&ccedil;&atilde;o preparada SQL</span></li>
   <li><span class="function"><a href="function.cubrid-fetch-array.php" class="function" rel="rdfs-seeAlso">cubrid_fetch_array()</a> - Busca uma linha de resultado como um array associativo, num&eacute;rico ou ambos</span></li>
   <li><span class="function"><a href="function.cubrid-fetch-row.php" class="function" rel="rdfs-seeAlso">cubrid_fetch_row()</a> - Retorna um array num&eacute;rico com os valores da linha atual</span></li>
   <li><span class="function"><a href="function.cubrid-fetch-assoc.php" class="function" rel="rdfs-seeAlso">cubrid_fetch_assoc()</a> - Retorna o array associativo que corresponde &agrave; linha buscada</span></li>
   <li><span class="function"><a href="function.cubrid-fetch-object.php" class="function" rel="rdfs-seeAlso">cubrid_fetch_object()</a> - Busca a pr&oacute;xima linha e retorna-a como um objeto</span></li>
  </ul>
 </div>


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