abies Mon Sep 1 19:59:19 2003 EDT
Modified files:
/phpdoc/en/reference/ibase/functions ibase-execute.xml
ibase-query.xml
Log:
Clarify description.
Added PHP5 note
Index: phpdoc/en/reference/ibase/functions/ibase-execute.xml
diff -u phpdoc/en/reference/ibase/functions/ibase-execute.xml:1.3
phpdoc/en/reference/ibase/functions/ibase-execute.xml:1.4
--- phpdoc/en/reference/ibase/functions/ibase-execute.xml:1.3 Sun Jul 27 18:21:30
2003
+++ phpdoc/en/reference/ibase/functions/ibase-execute.xml Mon Sep 1 19:59:18
2003
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.3 $ -->
+<!-- $Revision: 1.4 $ -->
<!-- splitted from ./en/functions/ibase.xml, last change in rev 1.2 -->
<refentry id="function.ibase-execute">
<refnamediv>
@@ -14,10 +14,18 @@
<methodparam
choice="opt"><type>int</type><parameter>bind_args</parameter></methodparam>
</methodsynopsis>
<para>
- Execute a query prepared by <function>ibase_prepare</function>.
+ Execute a query prepared by <function>ibase_prepare</function>. If
+ the query raises an error, returns &false;. If it is successful and
+ there is a (possibly empty) result set (such as with a SELECT query),
+ returns a result identifier. If the query was successful and there were
+ no results, returns &true;.
+ </para>
+ <para>
This is a lot more effective than using <function>ibase_query</function>
if you are repeating a same kind of query several times with only
some parameters changing.
+ </para>
+ <para>
<example>
<title><function>ibase_execute</function> example</title>
<programlisting role="php">
@@ -38,6 +46,17 @@
]]>
</programlisting>
</example>
+ </para>
+ <note>
+ <para>
+ In PHP 5.0.0 and up, this function returns the number of rows affected by
+ the query (if > 0 and applicable to the statement type). A query that succeeded,
+ but did not affect any rows (eg. an UPDATE of a non-existent record) will return
+ &true;.
+ </para>
+ </note>
+ <para>
+ See also <function>ibase_query</function>.
</para>
</refsect1>
</refentry>
Index: phpdoc/en/reference/ibase/functions/ibase-query.xml
diff -u phpdoc/en/reference/ibase/functions/ibase-query.xml:1.3
phpdoc/en/reference/ibase/functions/ibase-query.xml:1.4
--- phpdoc/en/reference/ibase/functions/ibase-query.xml:1.3 Sun Jul 27 18:21:30
2003
+++ phpdoc/en/reference/ibase/functions/ibase-query.xml Mon Sep 1 19:59:18 2003
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.3 $ -->
+<!-- $Revision: 1.4 $ -->
<!-- splitted from ./en/functions/ibase.xml, last change in rev 1.2 -->
<refentry id="function.ibase-query">
<refnamediv>
@@ -15,9 +15,9 @@
<methodparam
choice="opt"><type>int</type><parameter>bind_args</parameter></methodparam>
</methodsynopsis>
<simpara>
- Performs a query on an InterBase database. If the query is not
- successful, returns &false;. If it is successful and there are resulting
- rows (such as with a SELECT query), returns a result identifier. If
+ Performs a query on an InterBase database. If the query raises an error,
+ returns &false;. If it is successful and there is a (possibly empty)
+ result set (such as with a SELECT query), returns a result identifier. If
the query was successful and there were no results, returns &true;.
</simpara>
<para>
@@ -39,6 +39,14 @@
</programlisting>
</example>
</para>
+ <note>
+ <para>
+ In PHP 5.0.0 and up, this function returns the number of rows affected by
+ the query (if > 0 and applicable to the statement type). A query that succeeded,
+ but did not affect any rows (eg. an UPDATE of a non-existent record) will return
+ &true;.
+ </para>
+ </note>
<note>
<para>
If you get some error like "arithmetic exception, numeric overflow,
