<?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 => 'fr',
  ),
  'this' => 
  array (
    0 => 'function.cubrid-fetch.php',
    1 => 'cubrid_fetch',
    2 => 'R&eacute;cup&egrave;re la prochaine ligne du jeu de r&eacute;sultats',
  ),
  'up' => 
  array (
    0 => 'ref.cubrid.php',
    1 => 'Fonctions 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' => 'fr',
    '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">Récupère la prochaine ligne du jeu de résultats</span></p>

 </div>

 <div class="refsect1 description" id="refsect1-function.cubrid-fetch-description">
  <h3 class="title">Description</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 fonction <span class="function"><strong>cubrid_fetch()</strong></span> est utilisée
   pour récupérer une seule ligne depuis le résultat de la
   requête. Le curseur se déplace automatiquement sur la prochaine
   ligne une fois la récupération effectuée.
  </p>
 </div>


 <div class="refsect1 parameters" id="refsect1-function.cubrid-fetch-parameters">
  <h3 class="title">Liste de paramètres</h3>
  <dl>
   
    <dt><code class="parameter">result</code></dt>
    <dd><span class="simpara">Le paramètre <code class="parameter">result</code>
     provient de l&#039;appel à la fonction <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">Type du tableau à retourner : CUBRID_NUM, CUBRID_ASSOC, CUBRID_BOTH, CUBRID_OBJECT.
     Si l&#039;on veut utiliser un objet LOB, il est possible d&#039;utiliser CUBRID_LOB.
     </span></dd>
   
  </dl>
 </div>


 <div class="refsect1 returnvalues" id="refsect1-function.cubrid-fetch-returnvalues">
  <h3 class="title">Valeurs de retour</h3>
  <p class="simpara">
   Tableau ou objet de résultat, en cas de succès.
  </p>
  <p class="simpara">
   <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong> lorsqu&#039;il n&#039;y a plus de ligne de disponible, NULL
   si une erreur survient.
  </p>
  <p class="simpara">
   Le résultat peut être sous la forme d&#039;un tableau ou d&#039;un objet ;
   le type de résultat peut être défini grâce au paramètre <code class="parameter">type</code>.
   La variable <code class="parameter">type</code> peut être définie à une
   des valeurs suivantes :
  </p>
  <ul class="simplelist">
   <li>CUBRID_NUM : Tableau numérique (en commençant à l'indice 0)</li>
   <li>CUBRID_ASSOC : Tableau associatif</li>
   <li>CUBRID_BOTH : Tableau numérique et associatif (valeur par défaut)</li>
   <li>CUBRID_OBJECT : Objet dont les noms des attributs correspondent
    aux noms des colonnes du résultat de la requête</li>
  </ul>
  <p class="simpara">
   Lorsque l&#039;argument <code class="parameter">type</code> est omis, le résultat
   sera retourné en utilisant l&#039;option CUBRID_BOTH par défaut. Lorsque l&#039;on
   veut recevoir le résultat de la requête sous la forme d&#039;un objet, le nom
   de la colonne du résultat doit être conforme aux règles de nommage des
   identifiants en PHP. Par exemple, les noms de colonnes comme &quot;count(*)&quot;
   ne peuvent être acceptés dans le type objet.
  </p>
 </div>


 <div class="refsect1 examples" id="refsect1-function.cubrid-fetch-examples">
  <h3 class="title">Exemples</h3>
  <div class="example" id="example-1">
   <p><strong>Exemple #1 Exemple avec <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 %-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">$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 %-6s %-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">// Si vous voulez utiliser un objet LOB, vous pouvez utiliser<br />// 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>L&#039;exemple ci-dessus va afficher :</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">Voir aussi</h3>
  <ul class="simplelist">
   <li><span class="function"><a href="function.cubrid-execute.php" class="function" rel="rdfs-seeAlso">cubrid_execute()</a> - Ex&eacute;cute une requ&ecirc;te SQL pr&eacute;par&eacute;e</span></li>
   <li><span class="function"><a href="function.cubrid-fetch-array.php" class="function" rel="rdfs-seeAlso">cubrid_fetch_array()</a> - R&eacute;cup&egrave;re une ligne de r&eacute;sultat sous forme de tableau associatif, de tableau num&eacute;rique, ou les deux</span></li>
   <li><span class="function"><a href="function.cubrid-fetch-row.php" class="function" rel="rdfs-seeAlso">cubrid_fetch_row()</a> - Retourne un tableau num&eacute;rique avec les valeurs de la ligne courante</span></li>
   <li><span class="function"><a href="function.cubrid-fetch-assoc.php" class="function" rel="rdfs-seeAlso">cubrid_fetch_assoc()</a> - Retourne un tableau associatif correspondant &agrave; la ligne r&eacute;cup&eacute;r&eacute;e</span></li>
   <li><span class="function"><a href="function.cubrid-fetch-object.php" class="function" rel="rdfs-seeAlso">cubrid_fetch_object()</a> - R&eacute;cup&egrave;re la prochaine ligne et la retourne sous la forme d'un objet</span></li>
  </ul>
 </div>


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