stas Thu May 13 10:36:08 2004 EDT
Modified files:
/phpdoc/en/reference/sqlite/functions sqlite-exec.xml
Log:
document sqlite_exec
http://cvs.php.net/diff.php/phpdoc/en/reference/sqlite/functions/sqlite-exec.xml?r1=1.2&r2=1.3&ty=u
Index: phpdoc/en/reference/sqlite/functions/sqlite-exec.xml
diff -u phpdoc/en/reference/sqlite/functions/sqlite-exec.xml:1.2
phpdoc/en/reference/sqlite/functions/sqlite-exec.xml:1.3
--- phpdoc/en/reference/sqlite/functions/sqlite-exec.xml:1.2 Thu May 13 10:29:46
2004
+++ phpdoc/en/reference/sqlite/functions/sqlite-exec.xml Thu May 13 10:36:08
2004
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
<refentry id="function.sqlite-exec">
<refnamediv>
<refname>sqlite_exec</refname>
@@ -11,12 +11,43 @@
<title>Description</title>
<methodsynopsis>
<type>bool</type><methodname>sqlite_exec</methodname>
+ <methodparam><type>resource</type><parameter>dbhandle</parameter></methodparam>
<methodparam><type>string</type><parameter>query</parameter></methodparam>
- <methodparam><type>resource</type><parameter>db</parameter></methodparam>
</methodsynopsis>
-
- &warn.undocumented.func;
-
+ <methodsynopsis>
+ <type>bool</type><methodname>sqlite_exec</methodname>
+ <methodparam><type>string</type><parameter>query</parameter></methodparam>
+ <methodparam><type>resource</type><parameter>dbhandle</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Executes an SQL statement given by the <parameter>query</parameter> against
+ a given database handle (specified by the <parameter>dbhandle</parameter>
+ parameter).
+ </para>
+ <para>
+ This function will return a boolean result; &true; for success or &false; for
failure.
+ If you need to run a query that returns rows, see
<function>sqlite_query</function>.
+ </para>
+ <note>
+ <simpara>
+ Two alternative syntaxes are supported for compatibility with other
+ database extensions (such as MySQL).
+ The preferred form is the first one, where the
+ <parameter>db</parameter> parameter is the first parameter to the
+ function.
+ </simpara>
+ </note>
+ <warning>
+ <simpara>
+ SQLite <emphasis>will</emphasis> execute multiple queries separated by
+ semicolons, so you can use it to execute a batch of SQL that you have
+ loaded from a file or have embedded in a script.
+ </simpara>
+ </warning>
+ <para>
+ See also <function>sqlite_query</function>,
<function>sqlite_unbuffered_query</function> and
+ <function>sqlite_array_query</function>.
+ </para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
