File: msql.xml

package info (click to toggle)
phpdoc 20020310-1
links: PTS
area: main
in suites: woody
size: 35,272 kB
ctags: 354
sloc: xml: 799,767; php: 1,395; cpp: 500; makefile: 200; sh: 140; awk: 51
file content (1087 lines) | stat: -rw-r--r-- 41,026 bytes
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.12 $ -->
 <reference id="ref.msql">
  <title>mSQL</title>
  <titleabbrev>mSQL</titleabbrev>
  <partintro>
   <simpara>
    Ces fonctions vous permettent d'acc&eacute;der aux bases de donn&eacute;es
    mSQL. Pour cela, vous devez compiler PHP avec le support msql,
    en utilisant l'option de configuration
    <link linkend="install.configure.with-msql"><option role="configure">--with-msql[=dir]</option></link>.
    Par d&eacute;faut, le chemin est <filename>'/usr/local/Hughes'</filename>.
   </simpara>
   <simpara>
    Plus d'informations sur mSQL &agrave; <ulink url="&url.msql;">&url.msql;</ulink>.
   </simpara>
  </partintro>
  <refentry id="function.msql">
   <refnamediv>
    <refname>msql</refname>
    <refpurpose>Ex&eacute;cute une requ&ecirc;te mSQL.</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>resource</type><methodname>msql</methodname>
      <methodparam><type>string</type><parameter>database</parameter></methodparam>
      <methodparam><type>string</type><parameter>query</parameter></methodparam>
      <methodparam><type>resource</type><parameter>link_identifier</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>msql</function> retourne un identifiant positif
     de r&eacute;sultat de requ&ecirc;te, ou &false;
     en cas d'erreur.
    </para>
    <para>
     <function>msql</function> s&eacute;lectionne la base de donn&eacute;es
     <parameter>database</parameter>, et y ex&eacute;cute la requ&ecirc;te
     <parameter>query</parameter>. Si l'identifiant de connexion
     <parameter>link_identifier</parameter> n'est pas fourni, la fonction
     va rechercher un lien ouvert &agrave; un serveur mSQL, et sinon, il
     va tenter d'en cr&eacute;er une, avec <function>msql_connect</function>,
     sans argument.
    </para>
   </refsect1>
  </refentry>
  <refentry id="function.msql-affected-rows">
   <refnamediv>
    <refname>msql_affected_rows</refname>
    <refpurpose>Retourne le nombre de ligne affect&eacute;es.</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>int</type><methodname>msql_affected_rows</methodname>
      <methodparam><type>resource</type><parameter>query_identifier</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>msql_affected_rows</function> retourne le nombre de
     lignes affect&eacute;es par la derni&egrave;re commande INSERT, UPDATE
     ou DELETE sur le serveur associ&eacute; au <parameter>link_identifier</parameter>.
     Si ce dernier n'est pas pr&eacute;cis&eacute;, la
     derni&egrave;re connexion est utilis&eacute;e.
    </para>
    <para>
     Voir aussi
     <function>msql_query</function>.
    </para>
   </refsect1>
  </refentry>
  <refentry id="function.msql-close">
   <refnamediv>
    <refname>msql_close</refname>
    <refpurpose>Ferme une connexion mSQL.</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>int</type><methodname>msql_close</methodname>
      <methodparam><type>resource</type><parameter>link_identifier</parameter></methodparam>
     </methodsynopsis>
    <para>
      <function>msql_close</function> retourne &true; en cas de succ&egrave;s,
      &false; en cas d'erreur.
    </para>
    <para>
      <function>msql_close</function> ferme la connexion au serveur de base
      de donn&eacute;es mSQL r&eacute;f&eacute;renc&eacute; par l'identifiant
      fourni. Si aucun identifiant n'est fourni, la derni&egrave;re connexion
      sera utilis&eacute;e.
    </para>
    <para>
      Notez bien qu'il n'est pas toujours n&eacute;cessaire d'appeler cette
      fonction, car les connexions non persistantes seront automatiquement
      ferm&eacute;es &agrave; la fin du script.
    </para>
    <para>
      <function>msql_close</function> ne peut pas fermer les connexions
      persistantes, g&eacute;n&eacute;r&eacute;es par
      <function>msql_pconnect</function>.
    </para>
    <para>
     Voir aussi
     <function>msql_connect</function> et
     <function>msql_pconnect</function>.
    </para>
   </refsect1>
  </refentry>
  <refentry id="function.msql-connect">
   <refnamediv>
    <refname>msql_connect</refname>
    <refpurpose>Ouvre une connexion mSQL.</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>resource</type><methodname>msql_connect</methodname>
      <methodparam choice="opt"><type>string</type><parameter>
        hostname
       </parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>
        hostname:port
       </parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>
        username
       </parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>
        password
       </parameter></methodparam>
     </methodsynopsis>
    <para>
      <function>msql_connect</function> retourne un identifiant de connexion
      positif en cas de succ&egrave;s, et &false; sinon.
    </para>
    <para>
      <function>msql_connect</function> &eacute;tablit une connexion &agrave;
      un serveur mSQL. Le nom d'h&ocirc;te est optionnel, et lorsqu'il manque,
      localhost est utilis&eacute;.
    </para>
    <para>
     Si un deuxi&egrave;me appel est fait &agrave;
     <function>msql_connect</function>, avec les m&ecirc;mes
     arguments, ce ne sera pas une nouvelle connexion qui va
     &ecirc;tre ouverte, mais l'ancienne connexion qui sera utilis&eacute;e,
     et son identifiant sera retourn&eacute;.
    </para>
    <para>
     Le lien au serveur sera ferm&eacute; d&egrave;s la fin du script,
     ou bien, manuellement, lors de l'appel de <function>msql_close</function>.
    </para>
    <para>
     Voir aussi
     <function>msql_pconnect</function> et
     <function>msql_close</function>.
    </para>
   </refsect1>
  </refentry>
  <refentry id="function.msql-create-db">
   <refnamediv>
    <refname>msql_create_db</refname>
    <refpurpose>Cr&eacute;e une base de donn&eacute;es mSQL.</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>int</type><methodname>msql_create_db</methodname>
      <methodparam><type>string</type><parameter>database_name</parameter></methodparam>
      <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam>
     </methodsynopsis>
    <para>
      <function>msql_create_db</function> essaie de cr&eacute;er une
      nouvelle base de donn&eacute;es nomm&eacute;e <parameter>database_name</parameter>
      sur le serveur r&eacute;f&eacute;renc&eacute; par l'identifiant
      <parameter>link_identifier</parameter>.
    </para>
    <para>
      Voir aussi
      <function>msql_drop_db</function>.
    </para>
   </refsect1>
  </refentry>
  <refentry id="function.msql-createdb">
   <refnamediv>
    <refname>msql_createdb</refname>
    <refpurpose>Cr&eacute;e une base de donn&eacute;es mSQL.</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>int</type><methodname>msql_createdb</methodname>
      <methodparam><type>string</type><parameter>database_name</parameter></methodparam>
      <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam>
     </methodsynopsis>
    <para>
     Identique &agrave; <function>msql_create_db</function>.
    </para>
   </refsect1>
  </refentry>
  <refentry id="function.msql-data-seek">
   <refnamediv>
    <refname>msql_data_seek</refname>
    <refpurpose>D&eacute;place le pointeur interne.</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>bool</type><methodname>msql_data_seek</methodname>
      <methodparam><type>resource</type><parameter>query_identifier</parameter></methodparam>
      <methodparam><type>int</type><parameter>row_number</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>msql_data_seek</function> retourne &true;
     en cas de succ&egrave;s, et &false; en cas d'&eacute;chec.
    </para>
    <para>
     <function>msql_data_seek</function> d&eacute;place le pointeur
     interne de r&eacute;sultat mSQL, et le place &agrave; l'offset
     donn&eacute;. Le prochain appel &agrave; la fonction to
     <function>msql_fetch_row</function> retournera cette ligne.
    </para>
    <para>
      Voir aussi
      <function>msql_fetch_row</function>.
    </para>
   </refsect1>
  </refentry>
  <refentry id="function.msql-dbname">
   <refnamediv>
    <refname>msql_dbname</refname>
    <refpurpose>Lit le nom de la base de donn&eacute;es courante.</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>string</type><methodname>msql_dbname</methodname>
      <methodparam><type>resource</type><parameter>query_identifier</parameter></methodparam>
      <methodparam><type>int</type><parameter>i</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>msql_dbname</function> retourne le nom de la base de
     donn&eacute;es enregistr&eacute; en position <parameter>i</parameter>
     du pointeur de r&eacute;sultat retourn&eacute; par la fonction
     <function>msql_listdbs</function>.
     La fonction <function>msql_numrows</function> peut &ecirc;tre
     utilis&eacute;e pour d&eacute;terminer le nombre de bases disponibles.
    </para>
   </refsect1>
  </refentry>
  <refentry id="function.msql-drop-db">
   <refnamediv>
    <refname>msql_drop_db</refname>
    <refpurpose>Efface une base de donn&eacute;es mSQL.</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>int</type><methodname>msql_drop_db</methodname>
      <methodparam><type>string</type><parameter>database_name</parameter></methodparam>
      <methodparam><type>int</type><parameter>link_identifier</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>msql_drop_db</function> retourne &true;
     en cas de succ&egrave;s, et &false; en cas d'&eacute;chec.
    </para>
    <para>
     <function>msql_drop_db</function> essaie d'effacer une base de donn&eacute;es
     enti&egrave;re sur le serveur r&eacute;f&eacute;renc&eacute; par l'identifiant
     fourni.
    </para>
    <para>
     Voir aussi
     <function>msql_create_db</function>.
    </para>
   </refsect1>
  </refentry>
  <refentry id="function.msql-dropdb">
   <refnamediv>
    <refname>msql_dropdb</refname>
    <refpurpose>Efface une base de donn&eacute;es mSQL.</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
    <para>
     Voir <function>msql_drop_db</function>.
    </para>
   </refsect1>
  </refentry>
  <refentry id="function.msql-error">
   <refnamediv>
    <refname>msql_error</refname>
    <refpurpose>Retourne le message d'erreur</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>string</type><methodname>msql_error</methodname>
      <void/>
     </methodsynopsis>
    <para>
      Les erreurs g&eacute;n&eacute;r&eacute;es par mSQL ne sont plus
      trait&eacute;es comme des alertes. Au lieu de cela, elles sont
      stock&eacute;es, et accessibles &agrave; partir de cette fonction.
    </para>
   </refsect1>
  </refentry>
  <refentry id="function.msql-fetch-array">
   <refnamediv>
    <refname>msql_fetch_array</refname>
    <refpurpose>Lit une ligne sous la forme d'un tableau.</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>int</type><methodname>msql_fetch_array</methodname>
      <methodparam><type>resource</type><parameter>query_identifier</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>result_type</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>msql_fetch_array</function> retourne un tableau qui
     contient la ligne demand&eacute;e, ou &false;,
     si il n'y a pas d'autres lignes.
    </para>
    <para>
     <function>msql_fetch_array</function> est une version &eacute;volu&eacute;e
     de <function>msql_fetch_row</function>. En plus d'enregistrer les
     donn&eacute;es dans un tableau &agrave; indice num&eacute;rique, il peut
     enregistrer les donn&eacute;es dans un tableau associatif, en utilisant les
     noms des champs comme cl&eacute;s.
    </para>
    <para>
     Le deuxi&egrave;me argument <parameter>result_type</parameter> de
     <function>msql_fetch_array</function> est une constante, et peut prendre
     les valeurs suivantes : MSQL_ASSOC, MSQL_NUM, et MSQL_BOTH.
    </para>
    <para>
     M&eacute;fiez vous des requ&ecirc;tes qui retournent une ligne qui ne
     contient qu'un champs de valeur 0 (ou &null;, ou cha&icirc;ne vide).
    </para>
    <para>
     Il est important de noter que <function>msql_fetch_array</function> est
     marginalement plus lent que <function>msql_fetch_row</function>, alors
     qu'elle apporte un confort d'utilisation appr&eacute;ciable.
    </para>
    <para>
     Voir aussi
     <function>msql_fetch_row</function>.
    </para>
   </refsect1>
  </refentry>
  <refentry id="function.msql-fetch-field">
   <refnamediv>
    <refname>msql_fetch_field</refname>
    <refpurpose>Lit la valeur d'un champs.</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>object</type><methodname>msql_fetch_field</methodname>
      <methodparam><type>resource</type><parameter>query_identifier</parameter></methodparam>
      <methodparam><type>int</type><parameter>field_offset</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>msql_fetch_field</function> retourne un objet contenant
     les informations sur un champs.
    </para>
    <para>
     <function>msql_fetch_field</function> sert &agrave; lire les informations
     sur les champs, dans certaines requ&ecirc;tes. Si l'offset du champs n'est
     pas sp&eacute;cifi&eacute;, le prochain champs sera retourn&eacute;.
    </para>
    <para>
      Les propri&eacute;t&eacute;s de l'objet sont :
     <itemizedlist>
      <listitem>
       <simpara>
	name - nom de la colonne
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	table - nom de la table &agrave; qui appartient la colonne.
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	not_null - 1 si la colonne ne peut &ecirc;tre &null;
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	primary_key - 1 si la colonne est une cl&eacute; primaire
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	unique - 1 la colonne est une cl&eacute; unique
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	type - le type de la colonne
       </simpara>
      </listitem>
     </itemizedlist>
    </para>
    <para>
     Voir aussi
     <function>msql_field_seek</function>.
    </para>
   </refsect1>
  </refentry>
  <refentry id="function.msql-fetch-object">
   <refnamediv>
    <refname>msql_fetch_object</refname>
    <refpurpose>Lit une ligne sous la forme d'un objet.</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>int</type><methodname>msql_fetch_object</methodname>
      <methodparam><type>resource</type><parameter>query_identifier</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>result_type</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>msql_fetch_object</function> retourne un objet, dont
     les propri&eacute;t&eacute;s seront affect&eacute;es
     suivant les champs de la ligne lue, ou &false;
     si il ne reste plus de lignes.
    </para>
    <para>
     <function>msql_fetch_object</function> est identique &agrave;
     <function>msql_fetch_array</function>, avec une diff&eacute;rence : c'est
     un objet qui est retourn&eacute;, &agrave; la place d'un tableau. Par
     cons&eacute;quent, cela signifie que vous ne pouvez acc&eacute;der aux
     valeurs que par les noms des champs, et non plus avec leur offset.
     (les nombres sont interdits dans les noms de propri&eacute;t&eacute;s)
    </para>
    <para>
     L'argument optionnel <parameter>result_type</parameter> de
     <function>msql_fetch_array</function> est une constante qui peut prendre
     les valeurs suivantes : MSQL_ASSOC, MSQL_NUM, et MSQL_BOTH.
    </para>
    <para>
     <function>msql_fetch_object</function> est aussi rapide que
     <function>msql_fetch_array</function>, et marginalement plus
     lente que <function>msql_fetch_row</function>
     (la diff&eacute;rence est non significative).
    </para>
    <para>
     Voir aussi
     <function>msql_fetch_array</function> et
     <function>msql_fetch_row</function>.
    </para>
   </refsect1>
  </refentry>
  <refentry id="function.msql-fetch-row">
   <refnamediv>
    <refname>msql_fetch_row</refname>
    <refpurpose>Retourne une ligne sous la forme d'un objet.</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>array</type><methodname>msql_fetch_row</methodname>
      <methodparam><type>int</type><parameter>query_identifier</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>msql_fetch_row</function> retourne un tableau qui
     contient la ligne demand&eacute;e, ou &false;,
     si il n'y a plus de lignes &agrave; lire.
    </para>
    <para>
     <function>msql_fetch_row</function> retourne une ligne, extraite du
     r&eacute;sultat associ&eacute; &agrave; l'identifiant de r&eacute;sultat
     <parameter>query_identifier</parameter>. La ligne est retourn&eacute;e
     sous la forme d'un tableau. Chaque r&eacute;sultat est enregistr&eacute;
     dans un champs, index&eacute; num&eacute;riquement, &agrave; partir de 0.
    </para>
    <para>
     Les appels ult&eacute;rieurs &agrave; <function>msql_fetch_row</function>
     retourneront les lignes suivantes, ou &false;,
     lorsqu'il n'y aura plus de ligne.
    </para>
    <para>
     Voir aussi
     <function>msql_fetch_array</function>,
     <function>msql_fetch_object</function>,
     <function>msql_data_seek</function> et
     <function>msql_result</function>.
    </para>
   </refsect1>
  </refentry>
  <refentry id="function.msql-fieldname">
   <refnamediv>
    <refname>msql_fieldname</refname>
    <refpurpose>Lit le nom d'un champs.</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>string</type><methodname>msql_fieldname</methodname>
      <methodparam><type>resource</type><parameter>query_identifier</parameter></methodparam>
      <methodparam><type>int</type><parameter>field</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>msql_fieldname</function> retourne le nom du champs &agrave; l'index
     <parameter>field</parameter>. <parameter>query_identifier</parameter> est un
     identifiant de r&eacute;sultat, et <parameter>field</parameter> est un index
     de champs. <literal>msql_fieldname($result, 2);</literal> retournera le nom
     du deuxi&egrave;me champs, dans le r&eacute;sultat associ&eacute; &agrave;
     <parameter>query_identifier</parameter>.
    </para>
   </refsect1>
  </refentry>
  <refentry id="function.msql-field-seek">
   <refnamediv>
    <refname>msql_field_seek</refname>
    <refpurpose>Fixe d'offset d'un champs.</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>int</type><methodname>msql_field_seek</methodname>
      <methodparam><type>resource</type><parameter>query_identifier</parameter></methodparam>
      <methodparam><type>int</type><parameter>field_offset</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>msql_field_seek</function> recherche l'offset du champs
     <parameter>field_offset</parameter>. Le prochain appel &agrave;
     <function>msql_fetch_field</function> sans l'argument
     <parameter>field_offset</parameter>, retournera ce champs.
    </para>
    <para>
     Voir aussi
     <function>msql_fetch_field</function>.
    </para>
   </refsect1>
  </refentry>
  <refentry id="function.msql-fieldtable">
   <refnamediv>
    <refname>msql_fieldtable</refname>
    <refpurpose>
     Retourne le nom d'une table &agrave; partir d'un nom de champs.
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>int</type><methodname>msql_fieldtable</methodname>
      <methodparam><type>resource</type><parameter>query_identifier</parameter></methodparam>
      <methodparam><type>int</type><parameter>field</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>msql_fieldtable</function> retourne le nom de la table
     d'o&ugrave; est le champs <parameter>field</parameter>
     a &eacute;t&eacute; extrait.
    </para>
   </refsect1>
  </refentry>
  <refentry id="function.msql-fieldtype">
   <refnamediv>
    <refname>msql_fieldtype</refname>
    <refpurpose>Retourne le type de champs.</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>string</type><methodname>msql_fieldtype</methodname>
      <methodparam><type>resource</type><parameter>query_identifier</parameter></methodparam>
      <methodparam><type>int</type><parameter>i</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>msql_fieldtype</function> est similaire &agrave;
     <function>msql_fieldname</function>. Les arguments sont identiques,
     mais c'est le type du champs qui est retourn&eacute;. Cela produira
     un r&eacute;sultat tel que "int", "string" ou "real".
    </para>
   </refsect1>
  </refentry>
  <refentry id="function.msql-fieldflags">
   <refnamediv>
    <refname>msql_fieldflags</refname>
    <refpurpose>Retourne le flag d'un champs.</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>string</type><methodname>msql_fieldflags</methodname>
      <methodparam><type>resource</type><parameter>query_identifier</parameter></methodparam>
      <methodparam><type>int</type><parameter>i</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>msql_fieldflags</function> retourne le flag du champs
     sp&eacute;cifi&eacute;. Actuellement, il peut valoir soit "not &null;",
     "primary key", ou une combinaison des deux ou "" (cha&icirc;ne vide).
    </para>
   </refsect1>
  </refentry>
  <refentry id="function.msql-fieldlen">
   <refnamediv>
    <refname>msql_fieldlen</refname>
    <refpurpose>Retourne la longueur d'un champs.</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>int</type><methodname>msql_fieldlen</methodname>
      <methodparam><type>resource</type><parameter>query_identifier</parameter></methodparam>
      <methodparam><type>int</type><parameter>i</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>msql_fieldlen</function> retourne la longueur du champs
     <parameter>i</parameter>.
    </para>
   </refsect1>
  </refentry>
  <refentry id="function.msql-free-result">
   <refnamediv>
    <refname>msql_free_result</refname>
    <refpurpose>Lib&egrave;re le r&eacute;sultat de la m&eacute;moire.</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>int</type><methodname>msql_free_result</methodname>
      <methodparam><type>resource</type><parameter>query_identifier</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>msql_free_result</function> lib&egrave;re de la m&eacute;moire
     le r&eacute;sultat associ&eacute; &agrave; l'identifiant de r&eacute;sultat
     <parameter>query_identifier</parameter>. Lorsque PHP a termin&eacute; une
     requ&ecirc;te, cette m&eacute;moire est lib&eacute;r&eacute;e, ce qui fait
     que vous n'aurez pas besoin de cette fonction. Vous pouvez toujours
     l'utiliser pour vous assurer que vous n'utilisez pas trop de m&eacute;moire
     durant un script.
    </para>
   </refsect1>
  </refentry>
  <refentry id="function.msql-freeresult">
   <refnamediv>
    <refname>msql_freeresult</refname>
    <refpurpose>Lib&egrave;re le r&eacute;sultat de la m&eacute;moire.</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
    <para>
     Voir <function>msql_free_result</function>
    </para>
   </refsect1>
  </refentry>
  <refentry id="function.msql-list-fields">
   <refnamediv>
    <refname>msql_list_fields</refname>
    <refpurpose>Liste les champs d'une table.</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>int</type><methodname>msql_list_fields</methodname>
      <methodparam><type>string</type><parameter>database</parameter></methodparam>
      <methodparam><type>string</type><parameter>tablename</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>msql_list_fields</function> lit les informations de la table
     <parameter>tablename</parameter>. Les arguments sont le nom de la base
     de donn&eacute;es, <parameter>database</parameter> et le nom de la table
     <parameter>tablename</parameter>. Cette fonction retourne un identifiant
     de r&eacute;sultat qui sera utilis&eacute; avec
     <function>msql_fieldflags</function>, <function>msql_fieldlen</function>,
     <function>msql_fieldname</function> et <function>msql_fieldtype</function>.
     Un identifiant de r&eacute;sultat est un entier positif. La fonction
     retourne -1 si une erreur survient. Une cha&icirc;ne d&eacute;crivant
     l'erreur sera plac&eacute;e dans la variable <literal>$phperrmsg</literal>,
     et &agrave; moins que cette fonction n'ai &eacute;t&eacute; appel&eacute;e
     avec &#64; (<literal>&#64;msql_list_fields()</literal>), alors cette erreur sera
     affich&eacute;e.
    </para>
    <para>
      Voir aussi
      <function>msql_error</function>.
    </para>
   </refsect1>
  </refentry>
  <refentry id="function.msql-listfields">
   <refnamediv>
    <refname>msql_listfields</refname>
    <refpurpose>Liste les champs d'une table.</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
    <para>
     Voir <function>msql_list_fields</function>.
    </para>
   </refsect1>
  </refentry>
  <refentry id="function.msql-list-dbs">
   <refnamediv>
    <refname>msql_list_dbs</refname>
    <refpurpose>Liste les bases de donn&eacute;es mSQL sur un serveur.</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>int</type><methodname>msql_list_dbs</methodname>
      <void/>
     </methodsynopsis>
    <para>
     <function>msql_list_dbs</function> retournea un pointeur de r&eacute;sultat,
     qui contiendra les noms des bases de donn&eacute;es disponibles sur
     la connexion mSQL courante. Utilisez <function>msql_dbname</function>
     pour passer en revue toutes les lignes.
    </para>
   </refsect1>
  </refentry>
  <refentry id="function.msql-listdbs">
   <refnamediv>
    <refname>msql_listdbs</refname>
    <refpurpose>Liste les bases de donn&eacute;es mSQL sur un serveur.</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
    <para>
     Voir <function>msql_list_dbs</function>.
    </para>
   </refsect1>
  </refentry>
  <refentry id="function.msql-list-tables">
   <refnamediv>
    <refname>msql_list_tables</refname>
    <refpurpose>Liste les tables mSQL sur une base de donn&eacute;es </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>int</type><methodname>msql_list_tables</methodname>
      <methodparam><type>string</type><parameter>database</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>msql_list_tables</function> prend un nom de base de donn&eacute;es,
     et fourni un r&eacute;sultat, un peu comme la fonction <function>msql</function>.
     La fonction <function>msql_tablename</function> devrait &ecirc;tre
     utilis&eacute;e de pr&eacute;f&eacute;rence pour extraire les nom de
     table d'un pointeur de r&eacute;sultat.
    </para>
   </refsect1>
  </refentry>
  <refentry id="function.msql-listtables">
   <refnamediv>
    <refname>msql_listtables</refname>
    <refpurpose>Liste les tables mSQL sur une base de donn&eacute;es.</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
    <para>
     Voir <function>msql_list_tables</function>.
    </para>
   </refsect1>
  </refentry>
  <refentry id="function.msql-num-fields">
   <refnamediv>
    <refname>msql_num_fields</refname>
    <refpurpose>Retourne le nombre de champs dans un r&eacute;sultat.</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>int</type><methodname>msql_num_fields</methodname>
      <methodparam><type>resource</type><parameter>query_identifier</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>msql_num_fields</function> retourne le nombre de champs du
     r&eacute;sultat associ&eacute; &agrave; l'identifiant
     <parameter>query_identifier</parameter>.
    </para>
    <para>
     Voir aussi
     <function>msql</function>,
     <function>msql_query</function>,
     <function>msql_fetch_field</function> et
     <function>msql_num_rows</function>.
    </para>
   </refsect1>
  </refentry>
  <refentry id="function.msql-num-rows">
   <refnamediv>
    <refname>msql_num_rows</refname>
    <refpurpose>Retourne le nombre de lignes dans un r&eacute;sultat.</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>int</type><methodname>msql_num_rows</methodname>
      <methodparam><type>resource</type><parameter>query_identifier</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>msql_num_rows</function> retourne le nombre de lignes du
     r&eacute;sultat associ&eacute; &agrave; l'identifiant
     <parameter>query_identifier</parameter>.
    </para>
    <para>
     Voir aussi
     <function>msql</function>,
     <function>msql_query</function> et
     <function>msql_fetch_row</function>.
    </para>
   </refsect1>
  </refentry>
  <refentry id="function.msql-numfields">
   <refnamediv>
    <refname>msql_numfields</refname>
    <refpurpose>Retourne le nombre de champs dans un r&eacute;sultat.</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>int</type><methodname>msql_numfields</methodname>
      <methodparam><type>resource</type><parameter>query_identifier</parameter></methodparam>
     </methodsynopsis>
    <para>
    Identique &agrave; <function>msql_num_fields</function>.
    </para>
   </refsect1>
  </refentry>
  <refentry id="function.msql-numrows">
   <refnamediv>
    <refname>msql_numrows</refname>
    <refpurpose>Retourne le nombre de lignes dans un r&eacute;sultat.</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>int</type><methodname>msql_numrows</methodname>
      <void/>
     </methodsynopsis>
    <para>
     Identique &agrave; <function>msql_num_rows</function>.
    </para>
   </refsect1>
  </refentry>
  <refentry id="function.msql-pconnect">
   <refnamediv>
    <refname>msql_pconnect</refname>
    <refpurpose>Ouvre une connexion persistante &agrave; un serveur mSQL.</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>int</type><methodname>msql_pconnect</methodname>
      <methodparam choice="opt"><type>string</type><parameter>
        hostname
       </parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>
        hostname:port
       </parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>
        username
       </parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>
        password
       </parameter></methodparam>
     </methodsynopsis>
    <para>
     Retourne un identifiant de connexion persistante &agrave; un serveur mSQL
     en cas de succ&egrave;s, et &false; sinon.
    </para>
    <para>
     <function>msql_pconnect</function> se comporte presque comme
     <function>msql_connect</function> mais avec deux diff&eacute;rences
     majeures.
    </para>
    <para>
      D'abord, lors de la connexion, <function>msql_pconnect</function> cherche
      si une connexion persistante a d&eacute;j&agrave; &eacute;t&eacute;
      ouverte sur le m&ecirc;me h&ocirc;te. Si une telle connexion est
      trouv&eacute;e, elle sera utilis&eacute;e.
    </para>
    <para>
     Deuxi&egrave;mement, la connexion au serveur SQL ne sera pas
     termin&eacute;e lors de la fin de l'ex&eacute;cution du script. A la place,
     le lien restera ouvert pour d'autres connexions futures.
     (<function>msql_close</function> ne fermera pas un lien ouvert par
     <function>msql_pconnect</function>).
    </para>
    <para>
     C'est pourquoi une telle connexion est consid&eacute;r&eacute;e comme
     'persistante'.
    </para>
   </refsect1>
  </refentry>
  <refentry id="function.msql-query">
   <refnamediv>
    <refname>msql_query</refname>
    <refpurpose>Envoie une requ&ecirc;te mSQL </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>resource</type><methodname>msql_query</methodname>
      <methodparam><type>string</type><parameter>query</parameter></methodparam>
      <methodparam><type>int</type><parameter>link_identifier</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>msql_query</function> envoie une requ&ecirc;te &agrave;
     la base de donn&eacute;es active, sur le serveur associ&eacute; &agrave;
     l'identifiant de connexion <parameter>link_identifier</parameter>.
     Si <parameter>link_identifier</parameter> n'est pas fourni, PHP tentera
     d'utiliser la derni&egrave;re connexion ouverte. Si aucune connexion n'a
     &eacute;t&eacute; ouverte, la fonction tentera de se connecter par elle
     m&ecirc;me, avec <function>msql_connect</function> appel&eacute; sans
     argument.
    </para>
    <para>
     <function>msql_query</function> retourne un identifiant positif mSQL en
     cas de succ&egrave;s, et &false; sinon.
    </para>
    <para>
     Voir aussi
     <function>msql</function>,
     <function>msql_select_db</function>, et
     <function>msql_connect</function>.
    </para>
   </refsect1>
  </refentry>
  <refentry id="function.msql-regcase">
   <refnamediv>
    <refname>msql_regcase</refname>
    <refpurpose>
      Pr&eacute;pare une cha&icirc;ne pour une recherche par
      expression r&eacute;guli&egrave;re insensible &agrave; la
     casse.
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
    <para>
     Voir <function>sql_regcase</function>.
    </para>
   </refsect1>
  </refentry>
  <refentry id="function.msql-result">
   <refnamediv>
    <refname>msql_result</refname>
    <refpurpose>Retourne les donn&eacute;es de r&eacute;sultat.</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>int</type><methodname>msql_result</methodname>
      <methodparam><type>resource</type><parameter>query_identifier</parameter></methodparam>
      <methodparam><type>int</type><parameter>i</parameter></methodparam>
      <methodparam><type>mixed</type><parameter>field</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>msql_result</function> retourne la valeur de la cellule, &agrave; la
     ligne <parameter>i</parameter> et l'offset sp&eacute;cifi&eacute;,
     <parameter>field</parameter> dans le r&eacute;sultat mSQL
     <parameter>query_identifier</parameter>.
    </para>
    <para>
     <function>msql_result</function> retourne le contenu d'une cellule depuis un
     r&eacute;sultat mSQL <parameter>query_identifier</parameter>. L'argument de
     champs <parameter>field</parameter> peut &ecirc;tre aussi bien un offset,
     qu'un nom de champs, ou encore le nom de la table  point le nom du fichier
     (nom_table.nom_champs). Si la colonne est un alias, (par exemple 'select foo
     as bar from...'), utilisez de pr&eacute;f&eacute;rence l'alias au nom de colonne.
    </para>
    <para>
     Lorsque vous travailler sur des r&eacute;sutats de grande taille, il est
     pr&eacute;f&eacute;rable d'utiliser les fonctions qui r&eacute;cup&egrave;rent
     toute la ligne (voir ci-dessous). Comme ces fonctions retournent plusieurs
     cellules en m&ecirc;me temps, elles sont beaucoup plus rapide que
     <function>msql_result</function>. De plus, sachez qu'acc&eacute;der &agrave;
     un champs avec son indice num&eacute;rique est beaucoup plus rapide qu'en
     utilisant les autres m&eacute;thodes.
    </para>
    <para>
     Alternatives recommand&eacute;es :
     <function>msql_fetch_row</function>, <function>msql_fetch_array</function> et
     <function>msql_fetch_object</function>.
    </para>
   </refsect1>
  </refentry>
  <refentry id="function.msql-select-db">
   <refnamediv>
    <refname>msql_select_db</refname>
    <refpurpose>S&eacute;lectionne une base de donn&eacute;es mSQL.</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
     <type>int</type><methodname>msql_select_db</methodname>
     <methodparam><type>string</type><parameter>database_name</parameter></methodparam>
     <methodparam><type>resource</type><parameter>link_identifier</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>msql_select_db</function> retourne &true;
     en cas de succ&egrave;s, et &false; en cas d'erreur.
    </para>
    <para>
     <function>msql_select_db</function> choisi la base de donn&eacute;es
     courante sur le serveur associ&eacute; &agrave; l'identifiant de connexion
     <parameter>link_identifier</parameter>. Si <parameter>link_identifier</parameter>
     n'est pas fourni, PHP tentera d'utiliser la derni&egrave;re connexion
     ouverte. Si aucune connexion n'a &eacute;t&eacute; ouverte, la fonction
     tentera de se connecter par elle-m&ecirc;me, avec
     <function>msql_connect</function> appel&eacute;e sans argument.
    </para>
    <para>
     Les prochains appels &agrave; <function>msql_query</function> seront
     fait dans la base de donn&eacute;es active.
    </para>
    <para>
     Voir aussi
     <function>msql_connect</function>,
     <function>msql_pconnect</function> et
     <function>msql_query</function>.
    </para>
   </refsect1>
  </refentry>
  <refentry id="function.msql-selectdb">
   <refnamediv>
    <refname>msql_selectdb</refname>
    <refpurpose>S&eacute;lectionne une base de donn&eacute;es mSQL.</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
    <para>
     Voir aussi
     <function>msql_select_db</function>.
    </para>
   </refsect1>
  </refentry>
  <refentry id="function.msql-tablename">
   <refnamediv>
    <refname>msql_tablename</refname>
    <refpurpose>Retourne le nom d'une table &agrave; partir d'un nom de champs.</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>string</type><methodname>msql_tablename</methodname>
      <methodparam><type>int</type><parameter>query_identifier</parameter></methodparam>
      <methodparam><type>int</type><parameter>field</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>msql_tablename</function> prend un pointeur de r&eacute;sultat
     (retourn&eacute; par la fonction <function>msql_list_tables</function>),
     ainsi qu'un index, et retourne le nom d'une table. La fonction
     <function>msql_numrows</function> peut servir &agrave; d&eacute;terminer
     le nombre de table dans le pointeur de r&eacute;sultat.
     <example>
      <title>Exemple <function>msql_tablename</function></title>
      <programlisting role="php">
&lt;?php
msql_connect ("localhost");
$result = msql_list_tables ("limousin");
$i = 0;
while ($i &lt; msql_numrows ($result)) {
    $tb_names[$i] = msql_tablename ($result, $i);
    echo $tb_names[$i] . "&lt;br&gt;";
    $i++;
}
?&gt;
      </programlisting>
     </example>
    </para>
   </refsect1>
  </refentry>
 </reference>
<!-- 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:"../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->