<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/cubridmysql.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-array.php',
    1 => 'cubrid_fetch_array',
    2 => 'Busca uma linha de resultado como um array associativo, num&eacute;rico ou ambos',
  ),
  'up' => 
  array (
    0 => 'cubridmysql.cubrid.php',
    1 => 'Fun&ccedil;&otilde;es de compatibilidade CUBRID MySQL',
  ),
  'prev' => 
  array (
    0 => 'function.cubrid-error.php',
    1 => 'cubrid_error',
  ),
  'next' => 
  array (
    0 => 'function.cubrid-fetch-assoc.php',
    1 => 'cubrid_fetch_assoc',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'pt_BR',
    'path' => 'reference/cubrid/cubridmysql/cubrid-fetch-array.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="function.cubrid-fetch-array" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">cubrid_fetch_array</h1>
  <p class="verinfo">(PECL CUBRID &gt;=8.3.0)</p><p class="refpurpose"><span class="refname">cubrid_fetch_array</span> &mdash; <span class="dc-title">Busca uma linha de resultado como um array associativo, numérico ou ambos</span></p>

 </div>

 <div class="refsect1 description" id="refsect1-function.cubrid-fetch-array-description">
  <h3 class="title">Descrição</h3>
  <div class="methodsynopsis dc-description">
   <span class="methodname"><strong>cubrid_fetch_array</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.array.php" class="type array">array</a></span></div>

  <p class="simpara">
   A função <span class="function"><strong>cubrid_fetch_array()</strong></span> é usada para obter uma
   única linha do resultado da consulta e retorna um array. O cursor
   move-se automaticamente para a próxima linha após a obtenção do resultado.
  </p>
 </div>


 <div class="refsect1 parameters" id="refsect1-function.cubrid-fetch-array-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 obtido: CUBRID_NUM, CUBRID_ASSOC,
     CUBRID_BOTH. Se for necessário operar o objeto LOB, pode-se usar CUBRID_LOB.</span></dd>
   
  </dl>
 </div>


 <div class="refsect1 returnvalues" id="refsect1-function.cubrid-fetch-array-returnvalues">
  <h3 class="title">Valor Retornado</h3>
  <p class="simpara">Retorna um array de strings que corresponde à linha buscada 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 tipo de array retornado depende de como o tipo é definido. Ao usar CUBRID_BOTH (padrão), será obtido um array com índices associativos e numéricos e será possível decidir qual tipo de dados será usado definindo o argumento <code class="parameter">type</code>. A variável <code class="parameter">type</code> pode ser definida com um dos seguintes valores:</p>
  <ul class="simplelist">
   <li>CUBRID_NUM : Array numérico (baseado em 0)</li>
   <li>CUBRID_ASSOC : Array associativo</li>
   <li>CUBRID_BOTH : Array numérico e associativo (padrão)</li>
  </ul>
 </div>


 <div class="refsect1 examples" id="refsect1-function.cubrid-fetch-array-examples">
  <h3 class="title">Exemplos</h3>
  <div class="example" id="example-1">
   <p><strong>Exemplo #1 Exemplo de <span class="function"><strong>cubrid_fetch_array()</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 name,area,seats,address 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_array</span><span style="color: #007700">(</span><span style="color: #0000BB">$req</span><span style="color: #007700">, </span><span style="color: #0000BB">CUBRID_NUM</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">, </span><span style="color: #0000BB">$row</span><span style="color: #007700">[</span><span style="color: #0000BB">0</span><span style="color: #007700">], </span><span style="color: #0000BB">$row</span><span style="color: #007700">[</span><span style="color: #0000BB">1</span><span style="color: #007700">], </span><span style="color: #0000BB">$row</span><span style="color: #007700">[</span><span style="color: #0000BB">2</span><span style="color: #007700">], </span><span style="color: #0000BB">$row</span><span style="color: #007700">[</span><span style="color: #0000BB">3</span><span style="color: #007700">]);<br />}<br /><br /></span><span style="color: #FF8000">// se for desejado operar um objeto LOB, pode-se usar cubrid_fetch_array($req, CUBRID_NUM | 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-array-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.php" class="function" rel="rdfs-seeAlso">cubrid_fetch()</a> - Busca a pr&oacute;xima linha do conjunto de resultados</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); ?>