pg-set-error-verbosity.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: c43a3cd9b49627b8d42a4b6ad530e10e26ca30dd Maintainer: lacatoire Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.pg-set-error-verbosity" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>pg_set_error_verbosity</refname>
  <refpurpose>
   Détermine 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 class="union"><type>int</type><type>false</type></type><methodname>pg_set_error_verbosity</methodname>
   <methodparam choice="opt"><type>PgSql\Connection</type><parameter>connection</parameter></methodparam>
   <methodparam><type>int</type><parameter>verbosity</parameter></methodparam>
  </methodsynopsis>
  <para>
   Détermine 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édent de la connexion. Avec le mode
   <constant>PGSQL_ERRORS_TERSE</constant>, les messages retournés incluent 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>
      &pgsql.parameter.connection-with-unspecified-default;
     </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édent :
   <constant>PGSQL_ERRORS_TERSE</constant>,
   <constant>PGSQL_ERRORS_DEFAULT</constant>
   ou <constant>PGSQL_ERRORS_VERBOSE</constant>, ou &false; en cas d'erreur.
  </para>
 </refsect1>

 <refsect1 role="changelog">
  &reftitle.changelog;
  <informaltable>
   <tgroup cols="2">
    <thead>
     <row>
      <entry>&Version;</entry>
      <entry>&Description;</entry>
     </row>
    </thead>
    <tbody>
     &pgsql.changelog.connection-object;
    </tbody>
   </tgroup>
  </informaltable>
 </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:"~/.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
-->