cvs: phpdoc /en/reference/sqlite/functions sqlite-exec.xml

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