pg-last-error.xml

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

<!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.2 -->
<refentry xml:id="function.pg-last-error" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>pg_last_error</refname>
  <refpurpose>Obtiene una cadena con el último mensaje de error de la conexión</refpurpose>
 </refnamediv>

 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type>string</type><methodname>pg_last_error</methodname>
   <methodparam choice="opt"><type>resource</type><parameter>connection</parameter></methodparam>
  </methodsynopsis>
  <para>
   <function>pg_last_error</function> devuelve el último mensaje de error para una
   <parameter>connection</parameter> determinada.
  </para>
  <para>
   Los mensajes de error pueden ser sobrescritos por las llamadas de función internas de PostgreSQL (libpq).
   Puede no devolver un mensaje de error apropiado si se producen varios errores dentro de una función de módulo PostgreSQL.
  </para>
  <para>
   Use <function>pg_result_error</function>, <function>pg_result_error_field</function>,
   <function>pg_result_status</function> y
   <function>pg_connection_status</function> Para un mejor manejo de errores.
  </para>
  <note>
   <para>
    Esta función se llamaba <function>pg_errormessage</function>.
   </para>
  </note>
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>connection</parameter></term>
     <listitem>
      <para>
       Recurso de conexión de base de datos PostgreSQL. Cuando
       <parameter>connection</parameter> no esta presente, la conexión por defecto 
       es usada. La conexión por defecto es la ultima conexión hecha por 
       <function>pg_connect</function> o <function>pg_pconnect</function>.
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>

 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   Un <type>string</type> que contiene el último mensaje de error dado por
   <parameter>connection</parameter>, o &false; en caso de error.
  </para>
 </refsect1>

 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title>Ejemplo de<function>pg_last_error</function></title>
    <programlisting role="php">
<![CDATA[
<?php
  $dbconn = pg_connect("dbname=publisher") or die("Could not connect");

  // Consulta que falla
  $res = pg_query($dbconn, "select * from doesnotexist");
  
  echo pg_last_error($dbconn);
?>
]]>
    </programlisting>
   </example>
  </para>
 </refsect1>
 
 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>pg_result_error</function></member>
    <member><function>pg_result_error_field</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
-->