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,