doc-fr/reference/pgsql/functions/pg-set-error-verbosity.xml

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.4 $ -->
<!-- EN-Revision: 1.8 Maintainer: jsgoupil Status: ready -->
<!-- Reviewed: yes -->

<refentry xml:id="function.pg-set-error-verbosity" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>pg_set_error_verbosity</refname>
  <refpurpose>
   Détermine la le degré des messages retournés par
   <function>pg_last_error</function> et <function>pg_result_error</function>
  </refpurpose>
 </refnamediv>

 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type>int</type><methodname>pg_set_error_verbosity</methodname>
   <methodparam choice="opt"><type>resource</type><parameter>connection</parameter></methodparam>
   <methodparam><type>int</type><parameter>verbosity</parameter></methodparam>
  </methodsynopsis>
  <methodsynopsis>
   <type>int</type><methodname>pg_set_error_verbosity</methodname>
   <methodparam><type>int</type><parameter>verbosity</parameter></methodparam>
  </methodsynopsis>
  <para>
   Détermine la le degré des messages retournés par
   <function>pg_last_error</function> et <function>pg_result_error</function>.
  </para>
  <para>
   <function>pg_set_error_verbosity</function> fixe le degré d'erreur et
   retourne le paramètre précédant de la connexion. Avec le mode
   <constant>PGSQL_ERRORS_TERSE</constant>, les messages retournés inclus la
   sévérité, le texte primaire et la position seulement; normalement, cela va
   entrer sur une seule ligne. Le mode par défaut
   (<constant>PGSQL_ERRORS_DEFAULT</constant>) produit des messages qui incluent
   les messages ci-dessus et des détails, des astuces ou les champs en
   contexte (ces messages peuvent être étendus sur plusieurs lignes). Le mode
   <constant>PGSQL_ERRORS_VERBOSE</constant> tous les champs disponibles. Le
   changement du degré des messages n'affecte pas les messages disponibles qui
   proviennent des résultats déjà existants, mais seulement les messages des
   résultats créés par la suite.
  </para>
 </refsect1>

<refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>connection</parameter></term>
     <listitem>
      <para>
       La ressource de connexion de la base de données PostgreSQL. Lorsque
       <parameter>connection</parameter> n'est pas présent, la connexion par
       défaut est utilisée. La connexion par défaut est la dernière connexion
       faite par <function>pg_connect</function> ou <function>pg_pconnect</function>.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>verbosity</parameter></term>
     <listitem>
      <para>
       Le degré de message d'erreur : 
       <constant>PGSQL_ERRORS_TERSE</constant>,
       <constant>PGSQL_ERRORS_DEFAULT</constant>
       ou <constant>PGSQL_ERRORS_VERBOSE</constant>.
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>

 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   Le degré de message d'erreur précédant :
   <constant>PGSQL_ERRORS_TERSE</constant>,
   <constant>PGSQL_ERRORS_DEFAULT</constant>
   ou <constant>PGSQL_ERRORS_VERBOSE</constant>.
  </para>
 </refsect1>
 
 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title>Exemple avec <function>pg_set_error_verbosity</function></title>
    <programlisting role="php">
<![CDATA[
<?php
  $dbconn = pg_connect("dbname=publisher") or die("Connexion impossible");

  if (!pg_connection_busy($dbconn)) {
      pg_send_query($dbconn, "select * from nexistepas;");
  }
  
  pg_set_error_verbosity($dbconn, PGSQL_ERRORS_VERBOSE);
  $res1 = pg_get_result($dbconn);
  echo pg_result_error($res1);
?>
]]>
    </programlisting>
   </example>
  </para>
 </refsect1>

 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>pg_last_error</function></member>
    <member><function>pg_result_error</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:"../../../../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
-->