<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.13 $ -->
<!-- splitted from ./en/functions/mysql.xml, last change in rev 1.2 -->
  <refentry id="function.mysql-error">
   <refnamediv>
    <refname>mysql_error</refname>
    <refpurpose>
     Returns the text of the error message from previous MySQL
     operation
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>string</type><methodname>mysql_error</methodname>
      <methodparam choice="opt"><type>resource</type><parameter>
        link_identifier
       </parameter></methodparam>
     </methodsynopsis>
    <para>
     Returns the error text from the last MySQL function, or
     <literal>''</literal> (the empty string) if no error occurred. 
     If no link is explicitly passed to the function, the last
     successful open link will be used to retrieve the error message
     from the MySQL server.
    </para>
    <para>
     Errors coming back from the MySQL database backend no longer
     issue warnings. Instead, use <function>mysql_error</function> to
     retrieve the error text. Note that this function only returns the
     error text from the most recently executed MySQL function (not
     including <function>mysql_error</function> and
     <function>mysql_errno</function>), so if you want to use it, make
     sure you check the value before calling another MySQL function.
     <example>
      <title><function>mysql_error</function> example</title>
      <programlisting role="php">
<![CDATA[
<?php
$link = mysql_connect("localhost", "mysql_user", "mysql_password");

mysql_select_db("nonexistentdb", $link);
echo mysql_errno($link) . ": " . mysql_error($link). "\n";

mysql_select_db("kossu", $link);
mysql_query("SELECT * FROM nonexistenttable", $link);
echo mysql_errno($link) . ": " . mysql_error($link) . "\n";
?>
]]>
      </programlisting>
      <para>
       The above example would produce the following output:
      </para>
       <screen>
<![CDATA[
1049: Unknown database 'nonexistentdb'
1146: Table 'kossu.nonexistenttable' doesn't exist
]]>
       </screen>
     </example>
    </para>
    <para>
     See also <function>mysql_errno</function> and
     <ulink url="&url.mysql.docs.error.msg;">MySQL error messages</ulink>.
    </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
-->