Added documentation for odbc_execute()'s file reading functionality.

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@70129 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Torben Wilson 2002-02-12 21:12:22 +00:00
parent a44013aae6
commit eee09e45c7

View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.30 $ -->
<!-- $Revision: 1.31 $ -->
<reference id="ref.odbc">
<title>Unified ODBC functions</title>
<titleabbrev>ODBC</titleabbrev>
@ -451,12 +451,53 @@
</methodsynopsis>
<para>
Executes a statement prepared with
<function>odbc_prepare</function>. Returns
&true; on successful execution,
&false; otherwise. The array
<parameter>parameters_array</parameter> only needs to
be given if you really have parameters in your statement.
<function>odbc_prepare</function>. Returns &true; on successful
execution; &false; otherwise. The array
<parameter>parameters_array</parameter> only needs to be given if
you really have parameters in your statement.
</para>
<para>
Parameters in <parameter>parameter_array</parameter> will be
substituted for placeholders in the prepared statement in order.
</para>
<para>
Any parameters in <parameter>parameter_array</parameter> which
start and end with single quotes will be taken as the name of a
file to read and send to the database server as the data for the
appropriate placeholder.
</para>
<note>
<para>
As of PHP 4.1.1, this file reading functionality has the
following restrictions:
<itemizedlist>
<listitem>
<simpara>
File reading is <emphasis>not</emphasis> subject to any <link
linkend="features.safe-mode">safe mode</link> restrictions.
</simpara>
</listitem>
<listitem>
<simpara>
<link linkend="features.remote-files">Remote files</link>
are not supported.
</simpara>
</listitem>
<listitem>
<simpara>
If you wish to store a string which actually begins and ends
with single quotes, and you cannot escape them with
backslashes--for instance, if your server requires single
quotes to be escaped by doubling them (<literal>''</literal>)
instead of backslashing them (<literal>\'</literal>)--then
you must use another mechanism to store them (such as
executing the query directly with
<function>odbc_exec</function>).
</simpara>
</listitem>
</itemizedlist>
</para>
</note>
</refsect1>
</refentry>