dba-fetch.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 44428b04b7b046593e9ab33874eddd1fea7dfab1 Maintainer: yannick Status: ready -->
<!-- Reviewed: yes Maintainer: yannick -->

<refentry xml:id="function.dba-fetch" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>dba_fetch</refname>
  <refpurpose>Lit les données liées à une clé DBA</refpurpose>
 </refnamediv>
 
 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type class="union"><type>string</type><type>false</type></type><methodname>dba_fetch</methodname>
   <methodparam><type class="union"><type>string</type><type>array</type></type><parameter>key</parameter></methodparam>
   <methodparam><type>Dba\Connection</type><parameter>dba</parameter></methodparam>
   <methodparam choice="opt"><type>int</type><parameter>skip</parameter><initializer>0</initializer></methodparam>
  </methodsynopsis>
  <simpara>
   Signature surchargée obsolète à partir de 8.3.0 :
  </simpara>
  <methodsynopsis>
   <type>string</type><methodname>dba_fetch</methodname>
   <methodparam><type class="union"><type>string</type><type>array</type></type><parameter>key</parameter></methodparam>
   <methodparam><type>int</type><parameter>skip</parameter></methodparam>
   <methodparam><type>resource</type><parameter>dba</parameter></methodparam>
  </methodsynopsis>
  <para>
   <function>dba_fetch</function> lit les données spécifiées 
   par la clé <parameter>key</parameter> dans la base identifiée
   par <parameter>dba</parameter>.
  </para>
 </refsect1>
 
 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>key</parameter></term>
     <listitem>
      <para>
       La clé correspondant aux données.
      </para>
      <note>
       <para>
        Lorsque vous travaillez avec des fichiers .ini, cette fonction accepte des
        tableaux comme clés où l'index 0 est le groupe et l'index 1 est le nom
        de la valeur. Voir la fonction <function>dba_key_split</function>.
       </para>
      </note>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>dba</parameter></term>
     <listitem>
      <para>
       &dba.parameter.dba;
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>skip</parameter></term>
     <listitem>
      <para>
       Le nombre de paires clé-valeur à ignorer lors de l'utilisation de bases de données cdb.
       Cette valeur est ignorée pour toutes les autres bases de données qui ne prennent pas en charge
       les clés multiples avec le même nom.
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>
 
 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   Retourne la chaîne associée si la paire clé/valeur est trouvée, &false; sinon.
  </para>
 </refsect1>

 <refsect1 role="changelog">
  &reftitle.changelog;
  <informaltable>
   <tgroup cols="2">
    <thead>
     <row>
      <entry>&Version;</entry>
      <entry>&Description;</entry>
     </row>
    </thead>
    <tbody>
     &dba.changelog.dba-object;
     <row>
      <entry>8.3.0</entry>
      <entry>
       L'appel de <function>dba_fetch</function> avec <parameter>dba</parameter> comme
       troisième argument est désormais obsolète.
      </entry>
     </row>
     <row>
      <entry>8.2.0</entry>
      <entry>
       L'argument facultatif "skip" de la fonction <function>dba_fetch</function> est maintenant placé à la fin,
       conformément à la sémantique PHP côté utilisateur. La signature précédemment surchargée
       est toujours acceptée mais déconseillée.
      </entry>
     </row>
    </tbody>
   </tgroup>
  </informaltable>
 </refsect1>

 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>dba_exists</function></member>
    <member><function>dba_delete</function></member>
    <member><function>dba_insert</function></member>
    <member><function>dba_replace</function></member>
    <member><function>dba_key_split</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
-->