dbs Fri May 27 14:23:16 2005 EDT
Modified files:
/phpdoc/en/reference/pdo/functions PDO-exec.xml
Log:
Add warning about not abusing the return value of PDO::exec.
http://cvs.php.net/diff.php/phpdoc/en/reference/pdo/functions/PDO-exec.xml?r1=1.3&r2=1.4&ty=u
Index: phpdoc/en/reference/pdo/functions/PDO-exec.xml
diff -u phpdoc/en/reference/pdo/functions/PDO-exec.xml:1.3
phpdoc/en/reference/pdo/functions/PDO-exec.xml:1.4
--- phpdoc/en/reference/pdo/functions/PDO-exec.xml:1.3 Mon Jan 17 22:16:39 2005
+++ phpdoc/en/reference/pdo/functions/PDO-exec.xml Fri May 27 14:23:15 2005
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.3 $ -->
+<!-- $Revision: 1.4 $ -->
<!-- Generated by xml_proto.php v2.2. Found in /scripts directory of phpdoc.
-->
<refentry id="function.PDO-exec">
<refnamediv>
@@ -54,6 +54,25 @@
or deleted by the SQL statement you issued. If no rows were affected,
<function>PDO::exec</function> returns <literal>0</literal>.
</para>
+
+ <warning>
+ <para>
+ Do not rely on the return value as an indicator of success. The following
+ example incorrectly relies on the return value of
+ <function>PDO::exec</function>:
+ <programlisting role="php">
+<![CDATA[
+<?php
+$db->exec() or die($db->errorInfo());
+?>
+]]>
+ </programlisting>
+ The previous example is incorrect because the SQL statement may
+ legitimately return 0 affected rows, and <function>die</function> does
+ not distinguish between <literal>0</literal> and &false;.
+ </para>
+ </warning>
+
</refsect1>
<refsect1 role="examples">
