doc-fr/reference/cubrid/functions/cubrid-move-cursor.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 648875cf73af01acdb6afaa5ca38b0bf6631bf42 Maintainer: yannick Status: ready -->
<!-- Reviewed: no -->

<refentry xml:id="function.cubrid-move-cursor" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <refnamediv>
  <refname>cubrid_move_cursor</refname>
  <refpurpose>Déplace le curseur dans le résultat</refpurpose>
 </refnamediv>
 
 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type>bool</type><methodname>cubrid_move_cursor</methodname>
   <methodparam><type>resource</type><parameter>req_identifier</parameter></methodparam>  
   <methodparam><type>int</type><parameter>offset</parameter></methodparam>  
   <methodparam choice="opt"><type>int</type><parameter>origin</parameter><initializer>CUBRID_CURSOR_CURRENT</initializer></methodparam>  
  </methodsynopsis>
  <para>
   La fonction <function>cubrid_move_cursor</function> est utilisée pour déplacer le
   curseur courant suivant le paramètre <parameter>req_identifier</parameter>
   de la valeur du paramètre <parameter>offset</parameter> et dans la direction
   définie par le paramètre <parameter>origin</parameter> argument. Pour définir
   l'argument <parameter>origin</parameter>, vous pouvez utiliser <constant>CUBRID_CURSOR_FIRST</constant> pour
   la première partie du résultat, <constant>CUBRID_CURSOR_CURRENT</constant> pour la position courant du résultat,
   ou <constant>CUBRID_CURSOR_LAST</constant> pour la dernière partie du résultat. Si l'argument <parameter>origin</parameter>
   n'est pas explicitement désigné, alors la fonction utilisera <constant>CUBRID_CURSOR_CURRENT</constant> comme valeur par défaut.
  </para>
  <para>
   Si la valeur courant du déplacement du curseur est au delà des limites valides, alors
   le curseur se déplace à la prochaine position après l'intervalle valide du curseur. Par exemple,
   si vous le déplacez de 20 unités dans le résultat dont la taille est de 10, alors le curseur
   se placera sur la 11ème place et retournera <constant>CUBRID_NO_MORE_DATA</constant>.
  </para>
 </refsect1>
 
 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>req_identifier</parameter></term>
     <listitem><para>Identifiant de requête.</para></listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>offset</parameter></term>
     <listitem><para>Nombre d'unités que vous voulez utiliser pour le déplacement.</para></listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>origin</parameter></term>
     <listitem><para>Cible où vous voulez déplacer le curseur, soit <constant>CUBRID_CURSOR_FIRST</constant>, <constant>CUBRID_CURSOR_CURRENT</constant>, <constant>CUBRID_CURSOR_LAST</constant>.</para></listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>

 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   &return.success;
  </para>
 </refsect1>
 
 <refsect1 role="examples">
  &reftitle.examples;
  <example>
   <title>Exemple avec <function>cubrid_move_cursor</function></title>
   <programlisting role="php">
<![CDATA[
<?php
$conn = cubrid_connect("127.0.0.1", 33000, "demodb", "dba");

$req = cubrid_execute($conn, "SELECT * FROM code");
cubrid_move_cursor($req, 1, CUBRID_CURSOR_LAST);

$result = cubrid_fetch_row($req);
var_dump($result);

cubrid_move_cursor($req, 1, CUBRID_CURSOR_FIRST);
$result = cubrid_fetch_row($req);
var_dump($result);

cubrid_move_cursor($req, 1, CUBRID_CURSOR_CURRENT);
$result = cubrid_fetch_row($req);
var_dump($result);

cubrid_close_request($req);
cubrid_disconnect($conn);
?>
]]>
   </programlisting>
   &example.outputs;
   <screen>
<![CDATA[
array(2) {
  [0]=>
  string(1) "G"
  [1]=>
  string(4) "Gold"
}
array(2) {
  [0]=>
  string(1) "X"
  [1]=>
  string(5) "Mixed"
}
array(2) {
  [0]=>
  string(1) "M"
  [1]=>
  string(3) "Man"
}
]]>
   </screen>
  </example>
 </refsect1>
 
 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>cubrid_execute</function></member>   
   </simplelist>
  </para>
 </refsect1>
 
</refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->