sigmasternchen/php-doc-en
1
0
Fork 0
mirror of https://github.com/sigmasternchen/php-doc-en synced 2025-03-16 00:48:54 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

Add example and correct grammar

Browse source 
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@290495 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Christopher Jones 2009-11-11 01:01:39 +00:00
parent ece206b8dd
commit b6093f02ca
1 changed files with 43 additions and 14 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

57
reference/oci8/functions/oci-parse.xml
View file

@ -3,7 +3,7 @@
<refentry xml:id="function.oci-parse" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>oci_parse</refname>
<refpurpose>Prepares Oracle statement for execution</refpurpose>
<refpurpose>Prepares an Oracle statement for execution</refpurpose>
</refnamediv>
<refsect1 role="description">
@ -11,10 +11,10 @@
<methodsynopsis>
<type>resource</type><methodname>oci_parse</methodname>
<methodparam><type>resource</type><parameter>connection</parameter></methodparam>
<methodparam><type>string</type><parameter>query</parameter></methodparam>
<methodparam><type>string</type><parameter>sql_text</parameter></methodparam>
</methodsynopsis>
<para>
Prepares the <parameter>query</parameter>using
Prepares the <parameter>sql_text</parameter>using
<parameter>connection</parameter> and returns the statement identifier,
which can be used with <function>oci_bind_by_name</function>,
<function>oci_execute</function> and other functions.
@ -30,15 +30,15 @@
<listitem>
<para>
An Oracle connection identifier, returned by
<function>oci_connect</function> or <function>oci_pconnect</function>.
<function>oci_connect</function>, <function>oci_pconnect</function>, or <function>oci_new_connect</function>.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>query</parameter></term>
<term><parameter>sql_text</parameter></term>
<listitem>
<para>
The SQL query.
The SQL or PL/SQL statement.
</para>
</listitem>
</varlistentry>
@ -49,7 +49,38 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Returns a statement handler on success, or &false; on error.
Returns a statement handle on success, or &false; on error.
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title><function>oci_parse</function> example</title>
<programlisting role="php">
<![CDATA[
<?php
$connection = oci_connect("hr", "welcome", "localhost/XE");
$statement = oci_parse($connection, "SELECT * FROM employees");
oci_execute($statement);
echo "<table border='1'>\n";
while ($row = oci_fetch_array($statement, OCI_ASSOC+OCI_RETURN_NULLS)) {
echo "<tr>\n";
foreach ($row as $item) {
echo " <td>".($item!==null?htmlentities($item, ENT_QUOTES):"&nbsp;")."</td>\n";
}
echo "</tr>\n";
}
echo "</table>\n";
?>
]]>
</programlisting>
</example>
</para>
</refsect1>
@ -58,17 +89,15 @@
<note>
<para>
This function <emphasis>does not</emphasis> validate
<parameter>query</parameter>. The only way to find out if
<parameter>query</parameter> is valid SQL or PL/SQL statement - is to
execute it.
<parameter>sql_text</parameter>. The only way to find out if
<parameter>sql_text</parameter> is a valid SQL or PL/SQL statement
is to execute it.
</para>
</note>
<note>
<para>
In PHP versions before 5.0.0 you must use <function>ociparse</function> instead.
This name still can be used, it was left as alias of
<function>oci_parse</function> for downwards compatability.
This, however, is deprecated and not recommended.
In PHP versions before 5.0.0 you must
use <function>ociparse</function> instead. &oci.name.compat.note;
</para>
</note>
</refsect1>