cvs: phpdoc /en/reference/oci8 configure.xml constants.xml ini.xml reference.xml /en/reference/oci8/functions OCI-Collection-append.xml
OCI-Collection-assign.xml OCI-Collection-assignElem.xml OCI-Collection-free.xml OCI-Collection-getElem.xml OCI-Collection-max.xml
OCI-Collection-size.xml OCI-Collection-trim.xml OCI-Lob-append.xml OCI-Lob-close.xml OCI-Lob-eof.xml OCI-Lob-erase.xml OCI-Lob-export.xml
OCI-Lob-flush.xml OCI-Lob-free.xml OCI-Lob-getBuffering.xml OCI-Lob-import.xml OCI-Lob-load.xml OCI-Lob-read.xml OCI-Lob-rewind.xml OCI-Lob-save.xml
OCI-Lob-seek.xml OCI-Lob-setBuffering.xml OCI-Lob-size.xml OCI-Lob-tell.xml OCI-Lob-truncate.xml OCI-Lob-write.xml OCI-Lob-writeTemporary.xml
oci-bind-by-name.xml oci-cancel.xml oci-close.xml oci-commit.xml oci-connect.xml oci-define-by-name.xml oci-error.xml oci-execute.xml
oci-fetch-all.xml oci-fetch-array.xml oci-fetch-assoc.xml oci-fetch-object.xml oci-fetch-row.xml oci-field-name.xml oci-field-precision.xml
oci-field-scale.xml oci-field-size.xml oci-field-type-raw.xml oci-field-type.xml oci-internal-debug.xml oci-lob-copy.xml oci-new-collection.xml
oci-new-connect.xml oci-new-cursor.xml oci-new-descriptor.xml oci-num-rows.xml oci-parse.xml oci-password-change.xml oci-pconnect.xml oci-rollback.xml
oci-server-version.xml oci-set-prefetch.xml oci-statement-type.xml ocibindbyname.xml ocicancel.xml ocicloselob.xml ocicollappend.xml ocicollassign.xml
ocicollassignelem.xml ocicollgetelem.xml ocicollmax.xml ocicollsize.xml ocicolltrim.xml ocicolumnisnull.xml ocicolumnname.xml ocicolumnprecision.xml
ocicolumnscale.xml ocicolumnsize.xml ocicolumntype.xml ocicolumntyperaw.xml ocicommit.xml ocidefinebyname.xml ocierror.xml ociexecute.xml ocifetch.xml
ocifetchinto.xml ocifetchstatement.xml ocifreecollection.xml ocifreecursor.xml ocifreedesc.xml ocifreestatement.xml ociinternaldebug.xml
ociloadlob.xml ocilogoff.xml ocilogon.xml ocinewcollection.xml ocinewcursor.xml ocinewdescriptor.xml ocinlogon.xml ocinumcols.xml ociparse.xml
ociplogon.xml ociresult.xml ocirollback.xml ocirowcount.xml ocisavelob.xml ocisavelobfile.xml ociserverversion.xml ocisetprefetch.xml
ocistatementtype.xml ociwritelobtofile.xml ociwritetemporarylob.xml

tony2001 Tue Sep 6 16:18:32 2005 EDT Added files: /phpdoc/en/reference/oci8 ini.xml Modified files: /phpdoc/en/reference/oci8 configure.xml constants.xml reference.xml /phpdoc/en/reference/oci8/functions OCI-Collection-append.xml OCI-Collection-assign.xml OCI-Collection-assignElem.xml OCI-Collection-free.xml OCI-Collection-getElem.xml OCI-Collection-max.xml OCI-Collection-size.xml OCI-Collection-trim.xml OCI-Lob-append.xml OCI-Lob-close.xml OCI-Lob-eof.xml OCI-Lob-erase.xml OCI-Lob-export.xml OCI-Lob-flush.xml OCI-Lob-free.xml OCI-Lob-getBuffering.xml OCI-Lob-import.xml OCI-Lob-load.xml OCI-Lob-read.xml OCI-Lob-rewind.xml OCI-Lob-save.xml OCI-Lob-seek.xml OCI-Lob-setBuffering.xml OCI-Lob-size.xml OCI-Lob-tell.xml OCI-Lob-truncate.xml OCI-Lob-write.xml OCI-Lob-writeTemporary.xml oci-bind-by-name.xml oci-cancel.xml oci-close.xml oci-commit.xml oci-connect.xml oci-define-by-name.xml oci-error.xml oci-execute.xml oci-fetch-all.xml oci-fetch-array.xml oci-fetch-assoc.xml oci-fetch-object.xml oci-fetch-row.xml oci-field-name.xml oci-field-precision.xml oci-field-scale.xml oci-field-size.xml oci-field-type-raw.xml oci-field-type.xml oci-internal-debug.xml oci-lob-copy.xml oci-new-collection.xml oci-new-connect.xml oci-new-cursor.xml oci-new-descriptor.xml oci-num-rows.xml oci-parse.xml oci-password-change.xml oci-pconnect.xml oci-rollback.xml oci-server-version.xml oci-set-prefetch.xml oci-statement-type.xml ocibindbyname.xml ocicancel.xml ocicloselob.xml ocicollappend.xml ocicollassign.xml ocicollassignelem.xml ocicollgetelem.xml ocicollmax.xml ocicollsize.xml ocicolltrim.xml ocicolumnisnull.xml ocicolumnname.xml ocicolumnprecision.xml ocicolumnscale.xml ocicolumnsize.xml ocicolumntype.xml ocicolumntyperaw.xml ocicommit.xml ocidefinebyname.xml ocierror.xml ociexecute.xml ocifetch.xml ocifetchinto.xml ocifetchstatement.xml ocifreecollection.xml ocifreecursor.xml ocifreedesc.xml ocifreestatement.xml ociinternaldebug.xml ociloadlob.xml ocilogoff.xml ocilogon.xml ocinewcollection.xml ocinewcursor.xml ocinewdescriptor.xml ocinlogon.xml ocinumcols.xml ociparse.xml ociplogon.xml ociresult.xml ocirollback.xml ocirowcount.xml ocisavelob.xml ocisavelobfile.xml ociserverversion.xml ocisetprefetch.xml ocistatementtype.xml ociwritelobtofile.xml ociwritetemporarylob.xml Log: updated OCI8 docs

http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/configure.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc/en/reference/oci8/configure.xml diff -u phpdoc/en/reference/oci8/configure.xml:1.3 phpdoc/en/reference/oci8/configure.xml:1.4 --- phpdoc/en/reference/oci8/configure.xml:1.3 Fri Jan 28 04:23:41 2005 +++ phpdoc/en/reference/oci8/configure.xml Tue Sep 6 16:18:26 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <section id="oci8.installation"> &reftitle.install; <para> @@ -8,7 +8,8 @@ your environment variable ORACLE_HOME. </para> <para> - If you're using Oracle Instant Client, you need to build PHP with the option + If you're using <ulink url="&url.oracle.instant.client;">Oracle Instant + Client</ulink>, you need to build PHP with the option <option role="configure">--with-oci8-instant-client[=DIR]</option>. Note that Oracle Instant Client support first appeared in versions 4.3.11 and 5.0.4. http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/constants.xml?r1=1.5&r2=1.6&ty=u Index: phpdoc/en/reference/oci8/constants.xml diff -u phpdoc/en/reference/oci8/constants.xml:1.5 phpdoc/en/reference/oci8/constants.xml:1.6 --- phpdoc/en/reference/oci8/constants.xml:1.5 Mon Apr 18 12:37:16 2005 +++ phpdoc/en/reference/oci8/constants.xml Tue Sep 6 16:18:26 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> +<!-- $Revision: 1.6 $ --> <section id="oci8.constants"> &reftitle.constants; &extension.constants; @@ -24,7 +24,7 @@ <listitem> <simpara> Statement execution mode. Use this mode if you don't want - to really execute query, but only get select-list description. + to execute the query, but get the select-list's description. </simpara> </listitem> </varlistentry> @@ -383,6 +383,69 @@ </simpara> </listitem> </varlistentry> + <varlistentry> + <term> + <constant>OCI_SYSOPER</constant> + (<type>integer</type>) + </term> + <listitem> + <simpara> + Used with <function>oci_connect</function> to connect as SYSOPER + using external credentials (<link + linkend="ini.oci8.privileged_connect">oci8.privileged_connect</link> + should be enabled for this). + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term> + <constant>OCI_SYSDBA</constant> + (<type>integer</type>) + </term> + <listitem> + <simpara> + Used with <function>oci_connect</function> to connect as SYSDBA + using external credentials (<link + linkend="ini.oci8.privileged_connect">oci8.privileged_connect</link> + should be enabled for this). + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term> + <constant>OCI_LOB_BUFFER_FREE</constant> + (<type>integer</type>) + </term> + <listitem> + <simpara> + Used with <xref linkend="function.oci-lob-flush"/> to free buffers used. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term> + <constant>OCI_TEMP_CLOB</constant> + (<type>integer</type>) + </term> + <listitem> + <simpara> + Used with <xref linkend="function.oci-lob-writetemporary"/> to indicate + explicilty that temporary CLOB should be created. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term> + <constant>OCI_TEMP_BLOB</constant> + (<type>integer</type>) + </term> + <listitem> + <simpara> + Used with <xref linkend="function.oci-lob-writetemporary"/> to indicate + explicilty that temporary BLOB should be created. + </simpara> + </listitem> + </varlistentry> </variablelist> </section> @@ -406,3 +469,4 @@ vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> + http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/reference.xml?r1=1.14&r2=1.15&ty=u Index: phpdoc/en/reference/oci8/reference.xml diff -u phpdoc/en/reference/oci8/reference.xml:1.14 phpdoc/en/reference/oci8/reference.xml:1.15 --- phpdoc/en/reference/oci8/reference.xml:1.14 Sun Sep 4 15:39:21 2005 +++ phpdoc/en/reference/oci8/reference.xml Tue Sep 6 16:18:26 2005 @@ -1,31 +1,21 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.14 $ --> -<!-- Purpose: database.vendors --> -<!-- Membership: bundled, external --> - +<!-- $Revision: 1.15 $ --> <reference id="ref.oci8"> - <title>Oracle 8 functions</title> + <title>Oracle functions</title> <titleabbrev>OCI8</titleabbrev> <partintro> <section id="oci8.intro"> &reftitle.intro; <para> - These functions allow you to access Oracle9, Oracle8 and Oracle7 databases. - It uses the Oracle Call Interface (OCI). - </para> - <para> - This extension is more flexible than the - <link linkend="ref.oracle">old Oracle</link> - extension. It supports binding of global and local PHP variables - to Oracle placeholders, has full LOB, FILE and ROWID support - and allows you to use user-supplied define variables. - You are recommended to use this extension instead of - <link linkend="ref.oracle">old Oracle</link> extension where - possible. + These functions allow you to access Oracle 10, Oracle 9, Oracle 8 and + Oracle 7 databases using the Oracle Call Interface (OCI). They + support binding of PHP variables to Oracle placeholders, have full + LOB, FILE and ROWID support, and allow you to use user-supplied + define variables. </para> </section> - + <section id="oci8.requirements"> &reftitle.required; <para> @@ -34,10 +24,18 @@ <filename>php_oci8.dll</filename> dll. </para> <para> + The most convenient way to install all the required files + is to use Oracle Instant Client, which is available from here: + <ulink url="&url.oracle.instant.client;">&url.oracle.instant.client;</ulink>. + Instant Client does not need ORACLE_SID or ORACLE_HOME environment + variables set. You still may need to set LD_LIBRARY_PATH and NLS_LANG, though. + </para> + <para> Before using this extension, make sure that you have set up your Oracle environment variables properly for the Oracle user, as well - as your web daemon user. The variables you might need to set are as - follows: + as your web daemon user. These variables should be set up + <emphasis>before</emphasis> you start your web-server. The + variables you might need to set are as follows: <itemizedlist> <listitem> <simpara> @@ -64,12 +62,11 @@ NLS_LANG </simpara> </listitem> - <listitem> - <simpara> - ORA_NLS33 - </simpara> - </listitem> </itemizedlist> + For less frequently used Oracle environment variables such as + TNS_ADMIN, TWO_TASK, ORA_TZFILE, and the various Oracle + globalization settings like ORA_NLS33, ORA_NLS10 and the NLS_* + variables refer to Oracle documentation. </para> <para> After setting up the environment variables for your webserver user, @@ -113,56 +110,142 @@ </informalexample> </para> <para> - Please note that on some systems like UnixWare it is libthread + Please note that on some systems, like UnixWare it is libthread instead of libpthread. PHP and Apache have to be configured with EXTRA_LIBS=-lthread. </para> </note> </section> - &reference.oci8.configure; - - <section id="oci8.configuration"> - &reftitle.runtime; - &no.config; - </section> + &reference.oci8.ini; + + &reference.oci8.constants; - <section id="oci8.resources"> - &reftitle.resources; + <section id="oci8.examples"> + &reftitle.examples; <para> + <example> + <title>Basic query</title> + <programlisting role="php"> +<![CDATA[ +<?php + + $conn = oci_connect('hr', 'hr', 'orcl'); + if (!$conn) { + $e = oci_error(); + print htmlentities($e['message']); + exit; + } + + $query = 'SELECT * FROM DEPARTMENTS'; + + $stid = oci_parse($conn, $query); + if (!$stid) { + $e = oci_error($conn); + print htmlentities($e['message']); + exit; + } + + $r = oci_execute($stid, OCI_DEFAULT); + if (!$r) { + $e = oci_error($stid); + echo htmlentities($e['message']); + exit; + } + + print '<table border="1">'; + while ($row = oci_fetch_array($stid, OCI_RETURN_NULLS)) { + print '<tr>'; + foreach ($row as $item) { + print '<td>'.($item?htmlentities($item):'&nbsp;').'</td>'; + } + print '</tr>'; + } + print '</table>'; + + oci_close($conn); +?> +]]> + </programlisting> + </example> </para> - </section> + <para> + <example> + <title>Insert with bind variables</title> + <programlisting role="php"> +<![CDATA[ +<?php - &reference.oci8.constants; + // Before running, create the table: + // CREATE TABLE MYTABLE (mid NUMBER, myd VARCHAR2(20)); - <section id="oci8.examples"> - &reftitle.examples; + $conn = oci_connect('scott', 'tiger', 'orcl'); + + $query = 'INSERT INTO MYTABLE VALUES(:myid, :mydata)'; + + $stid = oci_parse($conn, $query); + + $id = 60; + $data = 'Some data'; + + oci_bind_by_name($stid, ':myid', $id); + oci_bind_by_name($stid, ':mydata', $data); + + $r = oci_execute($stid); + + if ($r) + print "One row inserted"; + + oci_close($conn); + +?> +]]> + </programlisting> + </example> + </para> + + <para> <example> - <title>OCI Hints</title> + <title>Inserting data into a CLOB column</title> <programlisting role="php"> <![CDATA[ <?php -// by sergo at bacup dot ru -// Use option: OCI_DEFAULT for execute command to delay execution -OCIExecute($stmt, OCI_DEFAULT); +// Before running, create the table: +// CREATE TABLE MYTABLE (mykey NUMBER, myclob CLOB); + +$conn = oci_connect('scott', 'tiger', 'orcl'); + +$mykey = 12343; // arbitrary key for this example; -// for retrieve data use (after fetch): +$sql = "INSERT INTO mytable (mykey, myclob) + VALUES (:mykey, EMPTY_CLOB()) + RETURNING myclob INTO :myclob"; -$result = OCIResult($stmt, $n); -if (is_object($result)) $result = $result->load(); - -// For INSERT or UPDATE statement use: - -$sql = "insert into table (field1, field2) values (field1 = 'value', - field2 = empty_clob()) returning field2 into :field2"; -OCIParse($conn, $sql); -$clob = OCINewDescriptor($conn, OCI_D_LOB); -OCIBindByName($stmt, ":field2", &$clob, -1, OCI_B_CLOB); -OCIExecute($stmt, OCI_DEFAULT); -$clob->save("some text"); -OCICommit($conn); +$stid = oci_parse($conn, $sql); +$clob = oci_new_descriptor($conn, OCI_D_LOB); +oci_bind_by_name($stid, ":mykey", $mykey, 5); +oci_bind_by_name($stid, ":myclob", $clob, -1, OCI_B_CLOB); +oci_execute($stid, OCI_DEFAULT); +$clob->save("A very long string"); + +oci_commit($conn); + +// Fetching CLOB data + +$query = 'SELECT myclob FROM mytable WHERE mykey = :mykey'; + +$stid = oci_parse ($conn, $query); +oci_bind_by_name($stid, ":mykey", $mykey, 5); +oci_execute($stid, OCI_DEFAULT); + +print '<table border="1">'; +while ($row = oci_fetch_array($stid, OCI_ASSOC)) { + $result = $row['MYCLOB']->load(); + print '<tr><td>'.$result.'</td></tr>'; +} +print '</table>'; ?> ]]> @@ -171,14 +254,14 @@ </para> <para> You can easily access stored procedures in the same way as you - would from the commands line. + would from the command line. <example> <title>Using Stored Procedures</title> <programlisting role="php"> <![CDATA[ <?php // by webmaster at remoterealty dot com -$sth = OCIParse($dbh, "begin sp_newaddress( :address_id, '$firstname', +$sth = oci_parse($dbh, "begin sp_newaddress( :address_id, '$firstname', '$lastname', '$company', '$address1', '$address2', '$city', '$state', '$postalcode', '$country', :error_code );end;"); @@ -186,9 +269,9 @@ // in/out variable and :error_code being an out variable. // Then you do the binding: - OCIBindByName($sth, ":address_id", $addr_id, 10); - OCIBindByName($sth, ":error_code", $errorcode, 10); - OCIExecute($sth); + oci_bind_by_name($sth, ":address_id", $addr_id, 10); + oci_bind_by_name($sth, ":error_code", $errorcode, 10); + oci_execute($sth); ?> ]]> @@ -197,6 +280,172 @@ </para> </section> + <section id="oci8.connection"> + <title>Connecting Handling</title> + <para> + The oci8 extension provides you with 3 different functions for + connecting to Oracle. It is up to you to use the most appropriate + function for your application, and the information in this section is + intended to help you make an informed choice. + </para> + <para> + Connecting to an Oracle server is a reasonably expensive operation, in + terms of the time that it takes to complete. The <function>oci_pconnect</function> + function uses a persistent cache of connections that can be re-used + across different script requests. This means that you will typically + only incur the connection overhead once per php process (or apache child). + </para> + <para> + If your application connects to Oracle using a different set of + credentials for each web user, the persistent cache employed by + <function>oci_pconnect</function> will become less useful as the + number of concurrent users increases, to the point where it may + start to adversely affect the overall performance of your Oracle + server due to maintaining too many idle connections. If your + application is structured in this way, it is recommended that + you either tune your application using the <link + linkend="ini.oci8.max_persistent">oci8.max_persistent</link> and <link + linkend="ini.oci8.persistent_timeout">oci8.persistent_timeout</link> + configuration settings (these will give you control over the + persistent connection cache size and lifetime) or use + <function>oci_connect</function> instead. + </para> + <para> + Both <function>oci_connect</function> and <function>oci_pconnect</function> + employ a connection cache; if you make multiple calls to + <function>oci_connect</function>, using the same parameters, in a + given script, the second and subsequent calls return return the existing + connection handle. The cache used by <function>oci_connect</function> + is cleaned up at the end of the script run, or when you explicitly close + the connection handle. <function>oci_pconnect</function> has similar + behaviour, although its cache is maintained separately and survives + between requests. + </para> + <para> + This caching feature is important to remember, because it gives the + appearance that the two handles are not transactionally isolated (they + are in fact the same connection handle, so there is no isolation of any + kind). If your application needs two separate, transactionally isolated + connections, you should use <function>oci_new_connect</function>. + </para> + <para> + <function>oci_new_connect</function> always creates a new connection to + the Oracle server, regardless of what other connections might already exist. + High traffic web applications should try to avoid using + <function>oci_new_connect</function>, especially in the busiest sections of + the application. + </para> + </section> + + <section id="oci8.datatypes"> + <title>Datatypes supported by the driver</title> + <table> + <title>The driver supports the following types when binding parameters using + <function>oci_bind_by_name</function> function:</title> + <tgroup cols="2"> + <thead> + <row> + <entry>Type</entry> + <entry>Mapping</entry> + </row> + </thead> + <tbody> + <row> + <entry>SQLT_NTY</entry> + <entry>Maps a native collection type from a PHP collection object, + such as those created by <function>oci_new_collection</function>.</entry> + </row> + <row> + <entry>SQLT_BFILEE</entry> + <entry>Maps a native descriptor, such as those created by + <function>oci_new_descriptor</function>.</entry> + </row> + <row> + <entry>SQLT_CFILEE</entry> + <entry>Maps a native descriptor, such as those created by + <function>oci_new_descriptor</function>.</entry> + </row> + <row> + <entry>SQLT_CLOB</entry> + <entry>Maps a native descriptor, such as those created by + <function>oci_new_descriptor</function>.</entry> + </row> + <row> + <entry>SQLT_BLOB</entry> + <entry>Maps a native descriptor, such as those created by + <function>oci_new_descriptor</function>.</entry> + </row> + <row> + <entry>SQLT_RDD</entry> + <entry>Maps a native descriptor, such as those created by + <function>oci_new_descriptor</function>.</entry> + </row> + <row> + <entry>SQLT_NUM</entry> + <entry>Converts the PHP parameter to a 'C' long type, and binds to + that value.</entry> + </row> + <row> + <entry>SQLT_RSET</entry> + <entry>Maps a native statement handle, such as those created by + <function>oci_parse</function> or those retrieved from other OCI queries.</entry> + </row> + <row> + <entry>SQLT_CHR and any other type</entry> + <entry>Converts the PHP parameter to a string type and binds as a + string.</entry> + </row> + </tbody> + </tgroup> + </table> + + <table> + <title>The following types are supported when retrieving columns from a result set:</title> + <tgroup cols="2"> + <thead> + <row> + <entry>Type</entry> + <entry>Mapping</entry> + </row> + </thead> + <tbody> + <row> + <entry>SQLT_RSET</entry> + <entry>Creates an oci statement resource to represent the the cursor.</entry> + </row> + <row> + <entry>SQLT_RDD</entry> + <entry>Creates a ROWID object.</entry> + </row> + <row> + <entry>SQLT_BLOB</entry> + <entry>Creates a LOB object.</entry> + </row> + <row> + <entry>SQLT_CLOB</entry> + <entry>Creates a LOB object.</entry> + </row> + <row> + <entry>SQLT_BFILE</entry> + <entry>Creates a LOB object.</entry> + </row> + <row> + <entry>SQLT_LNG</entry> + <entry>Bound as SQLT_CHR, returned as a string</entry> + </row> + <row> + <entry>SQLT_LBI</entry> + <entry>Bound as SQLT_BIN, returned as a string</entry> + </row> + <row> + <entry>Any other type</entry> + <entry>Bound as SQLT_CHR, returned as a string</entry> + </row> + </tbody> + </tgroup> + </table> + </section> + </partintro> &reference.oci8.functions; @@ -223,3 +472,4 @@ vi: ts=1 sw=1 --> + http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/OCI-Collection-append.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc/en/reference/oci8/functions/OCI-Collection-append.xml diff -u phpdoc/en/reference/oci8/functions/OCI-Collection-append.xml:1.2 phpdoc/en/reference/oci8/functions/OCI-Collection-append.xml:1.3 --- phpdoc/en/reference/oci8/functions/OCI-Collection-append.xml:1.2 Sun Nov 21 17:37:23 2004 +++ phpdoc/en/reference/oci8/functions/OCI-Collection-append.xml Tue Sep 6 16:18:28 2005 @@ -1,25 +1,55 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> - <refentry id="function.OCI-Collection-append"> - <refnamediv> - <refname>OCI-Collection->append</refname> - <refpurpose>Appends an object to the collection</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>OCI-Collection->append</methodname> - <methodparam><type>mixed</type><parameter>value</parameter></methodparam> - </methodsynopsis> - <para> - Appends an object to the end of the collection. Parameter - <parameter>value</parameter> can be a string or a number. - </para> - <para> - &return.success; - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.3 $ --> +<refentry id="function.oci-collection-append"> + <refnamediv> + <refname>OCI-Collection->append</refname> + <refpurpose>Appends element to the collection</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <classsynopsis> + <ooclass><classname>OCI-Collection</classname></ooclass> + <methodsynopsis> + <type>bool</type><methodname>append</methodname> + <methodparam><type>mixed</type><parameter>value</parameter></methodparam> + </methodsynopsis> + </classsynopsis> + <para> + Appends element to the end of the collection. Parameter + <parameter>value</parameter> can be a string or a number. + </para> + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>value</parameter></term> + <listitem> + <para> + The value to be added to the collection. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><xref linkend="function.oci-collection-assign" /></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/OCI-Collection-assign.xml?r1=1.5&r2=1.6&ty=u Index: phpdoc/en/reference/oci8/functions/OCI-Collection-assign.xml diff -u phpdoc/en/reference/oci8/functions/OCI-Collection-assign.xml:1.5 phpdoc/en/reference/oci8/functions/OCI-Collection-assign.xml:1.6 --- phpdoc/en/reference/oci8/functions/OCI-Collection-assign.xml:1.5 Sun Nov 21 17:37:23 2004 +++ phpdoc/en/reference/oci8/functions/OCI-Collection-assign.xml Tue Sep 6 16:18:29 2005 @@ -1,26 +1,56 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> - <refentry id="function.OCI-Collection-assign"> - <refnamediv> - <refname>OCI-Collection->assign</refname> - <refpurpose>Assigns a value to the collection from another existing collection</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>OCI-Collection->assign</methodname> - <methodparam><type>OCI-Collection</type><parameter>from</parameter></methodparam> - </methodsynopsis> - <para> - Assigns a value to the collection from another, previously created - collection. Both collections must be created with - <function>oci_new_collection</function> prior to using them. - </para> - <para> - &return.success; - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.6 $ --> +<refentry id="function.oci-collection-assign"> + <refnamediv> + <refname>OCI-Collection->assign</refname> + <refpurpose>Assigns a value to the collection from another existing collection</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <classsynopsis> + <ooclass><classname>OCI-Collection</classname></ooclass> + <methodsynopsis> + <type>bool</type><methodname>assign</methodname> + <methodparam><type>OCI-Collection</type><parameter>from</parameter></methodparam> + </methodsynopsis> + </classsynopsis> + <para> + Assigns a value to the collection from another, previously created + collection. Both collections must be created with + <function>oci_new_collection</function> prior to using them. + </para> + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>from</parameter></term> + <listitem> + <para> + An instance of OCI-Collection. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><xref linkend="function.oci-collection-append" /></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/OCI-Collection-assignElem.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc/en/reference/oci8/functions/OCI-Collection-assignElem.xml diff -u phpdoc/en/reference/oci8/functions/OCI-Collection-assignElem.xml:1.3 phpdoc/en/reference/oci8/functions/OCI-Collection-assignElem.xml:1.4 --- phpdoc/en/reference/oci8/functions/OCI-Collection-assignElem.xml:1.3 Sun Nov 21 17:37:23 2004 +++ phpdoc/en/reference/oci8/functions/OCI-Collection-assignElem.xml Tue Sep 6 16:18:29 2005 @@ -1,26 +1,62 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> - <refentry id="function.OCI-Collection-assignElem"> - <refnamediv> - <refname>OCI-Collection->assignElem</refname> - <refpurpose>Assigns a value to the element of the collection</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>OCI-Collection->assignElem</methodname> - <methodparam><type>int</type><parameter>index</parameter></methodparam> - <methodparam><type>mixed</type><parameter>value</parameter></methodparam> - </methodsynopsis> - <para> - Assigns a value to the element with index <parameter>index</parameter>. - Parameter <parameter>value</parameter> can be a string or a number. - </para> - <para> - &return.success; - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.4 $ --> +<refentry id="function.oci-collection-element-assign"> + <refnamediv> + <refname>OCI-Collection->assignElem</refname> + <refpurpose>Assigns a value to the element of the collection</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <classsynopsis> + <ooclass><classname>OCI-Collection</classname></ooclass> + <methodsynopsis> + <type>bool</type><methodname>assignElem</methodname> + <methodparam><type>int</type><parameter>index</parameter></methodparam> + <methodparam><type>mixed</type><parameter>value</parameter></methodparam> + </methodsynopsis> + </classsynopsis> + <para> + Assigns a value to the element with index <parameter>index</parameter>. + Parameter <parameter>value</parameter> can be a string or a number. + </para> + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>index</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>value</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><xref linkend="function.oci-collection-element-get" /></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/OCI-Collection-free.xml?r1=1.1&r2=1.2&ty=u Index: phpdoc/en/reference/oci8/functions/OCI-Collection-free.xml diff -u phpdoc/en/reference/oci8/functions/OCI-Collection-free.xml:1.1 phpdoc/en/reference/oci8/functions/OCI-Collection-free.xml:1.2 --- phpdoc/en/reference/oci8/functions/OCI-Collection-free.xml:1.1 Sun Nov 21 17:44:16 2004 +++ phpdoc/en/reference/oci8/functions/OCI-Collection-free.xml Tue Sep 6 16:18:29 2005 @@ -1,24 +1,38 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> - <refentry id="function.OCI-Collection-free"> - <refnamediv> - <refname>OCI-Collection->free</refname> - <refpurpose>Frees resources associated with collection object</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>OCI-Collection->free</methodname> - <void /> - </methodsynopsis> - <para> - Frees resources associated with collection object. - </para> - <para> - &return.success; - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.2 $ --> +<refentry id="function.oci-collection-free"> + <refnamediv> + <refname>OCI-Collection->free</refname> + <refpurpose>Frees the resources associated with the collection object</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <classsynopsis> + <ooclass><classname>OCI-Collection</classname></ooclass> + <methodsynopsis> + <type>bool</type><methodname>free</methodname> + <void /> + </methodsynopsis> + </classsynopsis> + <para> + Frees the resources associated with the collection object. + </para> + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><xref linkend="function.oci-new-collection" /></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -40,3 +54,4 @@ vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> + http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/OCI-Collection-getElem.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc/en/reference/oci8/functions/OCI-Collection-getElem.xml diff -u phpdoc/en/reference/oci8/functions/OCI-Collection-getElem.xml:1.2 phpdoc/en/reference/oci8/functions/OCI-Collection-getElem.xml:1.3 --- phpdoc/en/reference/oci8/functions/OCI-Collection-getElem.xml:1.2 Sun Nov 21 17:37:23 2004 +++ phpdoc/en/reference/oci8/functions/OCI-Collection-getElem.xml Tue Sep 6 16:18:29 2005 @@ -1,32 +1,56 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> - <refentry id="function.OCI-Collection-getElem"> - <refnamediv> - <refname>OCI-Collection->getElem</refname> - <refpurpose>Returns value of the element</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>mixed</type><methodname>OCI-Collection->getElem</methodname> - <methodparam><type>int</type><parameter>index</parameter></methodparam> - </methodsynopsis> - <para> - Method <function>OCI-Collection->getElem</function> returns value of the - element with index <parameter>index</parameter> (1-based). - </para> - <para> - <function>OCI-Collection->getElem</function> will return &false; if - such element doesn't exist; &null; if element is &null;; string if - element is column of a string datatype or number if element is numeric - field. - </para> - <para> - <function>OCI-Collection->getElem</function> will return &false; in case of - error. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.3 $ --> +<refentry id="function.oci-collection-element-get"> + <refnamediv> + <refname>OCI-Collection->getElem</refname> + <refpurpose>Returns value of the element</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <classsynopsis> + <ooclass><classname>OCI-Collection</classname></ooclass> + <methodsynopsis> + <type>mixed</type><methodname>getElem</methodname> + <methodparam><type>int</type><parameter>index</parameter></methodparam> + </methodsynopsis> + </classsynopsis> + <para> + Returns element's value with the index <parameter>index</parameter> (1-based). + </para> + <para> + <function>OCI-Collection->getElem</function> returns &false; if + such element doesn't exist; &null; if element is &null;; string if + element is column of a string datatype or number if element is numeric + field. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>index</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><xref linkend="function.oci-collection-element-assign" /></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -48,3 +72,4 @@ vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> + http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/OCI-Collection-max.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc/en/reference/oci8/functions/OCI-Collection-max.xml diff -u phpdoc/en/reference/oci8/functions/OCI-Collection-max.xml:1.2 phpdoc/en/reference/oci8/functions/OCI-Collection-max.xml:1.3 --- phpdoc/en/reference/oci8/functions/OCI-Collection-max.xml:1.2 Sun Nov 21 17:37:23 2004 +++ phpdoc/en/reference/oci8/functions/OCI-Collection-max.xml Tue Sep 6 16:18:29 2005 @@ -1,26 +1,37 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> - <refentry id="function.OCI-Collection-max"> - <refnamediv> - <refname>OCI-Collection->max</refname> - <refpurpose>Gets the maximum number of elements in the collection</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>OCI-Collection->max</methodname> - <void /> - </methodsynopsis> - <para> - Returns the maximum number of elements in the collection. - If the returned value is 0, then the number of elements is not limited. - <function>OCI-Collection->max</function> returns &false; in case of error. - </para> - <para> - See also <function>oci_collection_size</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.3 $ --> +<refentry id="function.oci-collection-max"> + <refnamediv> + <refname>OCI-Collection->max</refname> + <refpurpose>Returns the maximum number of elements in the collection</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <classsynopsis> + <ooclass><classname>OCI-Collection</classname></ooclass> + <methodsynopsis> + <type>int</type><methodname>max</methodname> + <void /> + </methodsynopsis> + </classsynopsis> + <para> + Returns the maximum number of elements in the collection. + If the returned value is 0, then the number of elements is not limited. + <function>OCI-Collection->max</function> returns &false; in case of error. + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><xref linkend="function.oci-collection-size" /></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/OCI-Collection-size.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc/en/reference/oci8/functions/OCI-Collection-size.xml diff -u phpdoc/en/reference/oci8/functions/OCI-Collection-size.xml:1.2 phpdoc/en/reference/oci8/functions/OCI-Collection-size.xml:1.3 --- phpdoc/en/reference/oci8/functions/OCI-Collection-size.xml:1.2 Sun Nov 21 17:37:23 2004 +++ phpdoc/en/reference/oci8/functions/OCI-Collection-size.xml Tue Sep 6 16:18:29 2005 @@ -1,24 +1,35 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> - <refentry id="function.OCI-Collection-size"> - <refnamediv> - <refname>OCI-Collection->size</refname> - <refpurpose>Returns size of the collection</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>OCI-Collection->size</methodname> - <void /> - </methodsynopsis> - <para> - Returns the number of elements in the collection. - </para> - <para> - See also <function>oci_collection_max</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.3 $ --> +<refentry id="function.oci-collection-size"> + <refnamediv> + <refname>OCI-Collection->size</refname> + <refpurpose>Returns size of the collection</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <classsynopsis> + <ooclass><classname>OCI-Collection</classname></ooclass> + <methodsynopsis> + <type>int</type><methodname>size</methodname> + <void /> + </methodsynopsis> + </classsynopsis> + <para> + Returns the number of elements in the collection or &false; on error. + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><xref linkend="function.oci-collection-max" /></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/OCI-Collection-trim.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc/en/reference/oci8/functions/OCI-Collection-trim.xml diff -u phpdoc/en/reference/oci8/functions/OCI-Collection-trim.xml:1.2 phpdoc/en/reference/oci8/functions/OCI-Collection-trim.xml:1.3 --- phpdoc/en/reference/oci8/functions/OCI-Collection-trim.xml:1.2 Sun Nov 21 17:37:23 2004 +++ phpdoc/en/reference/oci8/functions/OCI-Collection-trim.xml Tue Sep 6 16:18:29 2005 @@ -1,28 +1,54 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> - <refentry id="function.OCI-Collection-trim"> - <refnamediv> - <refname>OCI-Collection->trim</refname> - <refpurpose>Trims elements from the end of the collection</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>OCI-Collection->trim</methodname> - <methodparam><type>int</type><parameter>num</parameter></methodparam> - </methodsynopsis> - <para> - Trims <parameter>num</parameter> of elements from the end of the - collection. - </para> - <para> - &return.success; - </para> - <para> - See also <function>oci_collection_size</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.3 $ --> +<refentry id="function.oci-collection-trim"> + <refnamediv> + <refname>OCI-Collection->trim</refname> + <refpurpose>Trims elements from the end of the collection</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <classsynopsis> + <ooclass><classname>OCI-Collection</classname></ooclass> + <methodsynopsis> + <type>bool</type><methodname>trim</methodname> + <methodparam><type>int</type><parameter>num</parameter></methodparam> + </methodsynopsis> + </classsynopsis> + <para> + Trims <parameter>num</parameter> of elements from the end of the + collection. + </para> + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>num</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><xref linkend="function.oci-collection-size" /></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/OCI-Lob-append.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc/en/reference/oci8/functions/OCI-Lob-append.xml diff -u phpdoc/en/reference/oci8/functions/OCI-Lob-append.xml:1.4 phpdoc/en/reference/oci8/functions/OCI-Lob-append.xml:1.5 --- phpdoc/en/reference/oci8/functions/OCI-Lob-append.xml:1.4 Fri Nov 12 06:02:29 2004 +++ phpdoc/en/reference/oci8/functions/OCI-Lob-append.xml Tue Sep 6 16:18:29 2005 @@ -1,35 +1,61 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> - <refentry id="function.oci-lob-append"> - <refnamediv> - <refname>lob->append</refname> - <refpurpose>Appends data from the large object to another large object</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>lob->append</methodname> - <methodparam><type>OCI-Lob</type><parameter>lob_from</parameter></methodparam> - </methodsynopsis> - <para> - Appends data from the large object to the end of another large object. - </para> - <para> - Writing to the large object with <function>lob->append</function> will - fail if buffering was previously enabled. You must disable buffering - before appending. You may need to flush buffers with - <function>oci_lob_flush</function> before disabling buffering. - </para> - <para> - &return.success; - </para> - <para> - See also <function>oci_lob_flush</function>, - <function>ocisetbufferinglob</function> and - <function>ocigetbufferinglob</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.5 $ --> +<refentry id="function.oci-lob-append"> + <refnamediv> + <refname>OCI-Lob->append</refname> + <refpurpose>Appends data from the large object to another large object</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <classsynopsis> + <ooclass><classname>OCI-Lob</classname></ooclass> + <methodsynopsis> + <type>bool</type><methodname>append</methodname> + <methodparam><type>OCI-Lob</type><parameter>lob_from</parameter></methodparam> + </methodsynopsis> + </classsynopsis> + <para> + Appends data from the large object to the end of another large object. + </para> + <para> + Writing to the large object with <function>OCI-Lob->append</function> will + fail if buffering was previously enabled. You must disable buffering + before appending. You may need to flush buffers with + <xref linkend="function.oci-lob-flush"/> before disabling buffering. + </para> + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>lob_from</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><xref linkend="function.oci-lob-flush" /></member> + <member><xref linkend="function.oci-lob-setbuffering" /></member> + <member><xref linkend="function.oci-lob-getbuffering" /></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/OCI-Lob-close.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc/en/reference/oci8/functions/OCI-Lob-close.xml diff -u phpdoc/en/reference/oci8/functions/OCI-Lob-close.xml:1.3 phpdoc/en/reference/oci8/functions/OCI-Lob-close.xml:1.4 --- phpdoc/en/reference/oci8/functions/OCI-Lob-close.xml:1.3 Thu Apr 1 03:11:27 2004 +++ phpdoc/en/reference/oci8/functions/OCI-Lob-close.xml Tue Sep 6 16:18:29 2005 @@ -1,37 +1,40 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> - <refentry id="function.oci-lob-close"> - <refnamediv> - <refname>lob->close</refname> - <refpurpose>Closes LOB descriptor</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>lob->close</methodname> - <void /> - </methodsynopsis> - <para> - <function>lob->close</function> closes descriptor of LOB or FILE. This - function should be used only with - <function>lob->writeTemporary</function>. - </para> - <para> - &return.success; - </para> - <note> - <para> - In PHP versions before 5.0.0 you must use <function>ocicloselob</function> instead. - This name still can be used, it was left as alias of - <function>oci_lob_close</function> for downwards compatability. - This, however, is deprecated and not recommended. - </para> - </note> - <para> - See also <function>oci_lob_write_temporary</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.4 $ --> +<refentry id="function.oci-lob-close"> + <refnamediv> + <refname>OCI-Lob->close</refname> + <refpurpose>Closes LOB descriptor</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <classsynopsis> + <ooclass><classname>OCI-Lob</classname></ooclass> + <methodsynopsis> + <type>bool</type><methodname>close</methodname> + <void /> + </methodsynopsis> + </classsynopsis> + <para> + <function>OCI-Lob->close</function> closes descriptor of LOB or FILE. This + function should be used only with + <xref linkend="function.oci-lob-writetemporary" />. + </para> + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><xref linkend="function.oci-lob-writetemporary" /></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/OCI-Lob-eof.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc/en/reference/oci8/functions/OCI-Lob-eof.xml diff -u phpdoc/en/reference/oci8/functions/OCI-Lob-eof.xml:1.2 phpdoc/en/reference/oci8/functions/OCI-Lob-eof.xml:1.3 --- phpdoc/en/reference/oci8/functions/OCI-Lob-eof.xml:1.2 Tue Mar 9 04:28:19 2004 +++ phpdoc/en/reference/oci8/functions/OCI-Lob-eof.xml Tue Sep 6 16:18:29 2005 @@ -1,25 +1,37 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> - <refentry id="function.oci-lob-eof"> - <refnamediv> - <refname>lob->eof</refname> - <refpurpose>Tests for end-of-file on a large object's descriptor</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>lob->eof</methodname> - <void /> - </methodsynopsis> - <para> - Returns &true; if internal pointer of large object is at the end of LOB. - Otherwise returns &false;. - </para> - <para> - See also <function>oci_lob_size</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.3 $ --> +<refentry id="function.oci-lob-eof"> + <refnamediv> + <refname>OCI-Lob->eof</refname> + <refpurpose>Tests for end-of-file on a large object's descriptor<</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <classsynopsis> + <ooclass><classname>OCI-Lob</classname></ooclass> + <methodsynopsis> + <type>bool</type><methodname>eof</methodname> + <void /> + </methodsynopsis> + </classsynopsis> + <para> + Returns &true; if internal pointer of large object is at the end of LOB. + Otherwise returns &false;. + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><xref linkend="function.oci-lob-size" /></member> + </simplelist> + </para> + </refsect1> + +</refentry> + <!-- Keep this comment at the end of the file Local variables: mode: sgml http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/OCI-Lob-erase.xml?r1=1.1&r2=1.2&ty=u Index: phpdoc/en/reference/oci8/functions/OCI-Lob-erase.xml diff -u phpdoc/en/reference/oci8/functions/OCI-Lob-erase.xml:1.1 phpdoc/en/reference/oci8/functions/OCI-Lob-erase.xml:1.2 --- phpdoc/en/reference/oci8/functions/OCI-Lob-erase.xml:1.1 Mon Mar 8 09:12:17 2004 +++ phpdoc/en/reference/oci8/functions/OCI-Lob-erase.xml Tue Sep 6 16:18:29 2005 @@ -1,33 +1,69 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> - <refentry id="function.oci-lob-erase"> - <refnamediv> - <refname>lob->erase</refname> - <refpurpose>Erases a specified portion of the internal LOB data</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>lob->erase</methodname> - <methodparam choice="opt"><type>int</type><parameter>offset</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam> - </methodsynopsis> - <para> - Erases a specified portion of the internal LOB data starting at a - specified <parameter>offset</parameter>. Parameters - <parameter>length</parameter> and <parameter>offset</parameter> are optional. - <function>lob->erase</function> erases all LOB data by default. - </para> - <para> - For BLOBs, erasing means that the existing LOB value is overwritten with - zero-bytes. For CLOBs, the existing LOB value is overwritten with spaces. - </para> - <para> - <function>lob->erase</function> returns the actual number of - characters/bytes erased or &false; in case of error. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.2 $ --> +<refentry id="function.oci-lob-erase"> + <refnamediv> + <refname>OCI-Lob->erase</refname> + <refpurpose>Erases a specified portion of the internal LOB data</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <classsynopsis> + <ooclass><classname>OCI-Lob</classname></ooclass> + <methodsynopsis> + <type>int</type><methodname>erase</methodname> + <methodparam choice="opt"><type>int</type><parameter>offset</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam> + </methodsynopsis> + </classsynopsis> + <para> + Erases a specified portion of the internal LOB data starting at a + specified <parameter>offset</parameter>. Parameters + <parameter>length</parameter> and <parameter>offset</parameter> are optional. + <function>OCI-Lob->erase</function> erases all LOB data by default. + </para> + <para> + For BLOBs, erasing means that the existing LOB value is overwritten with + zero-bytes. For CLOBs, the existing LOB value is overwritten with spaces. + </para> + <para> + <function>OCI-Lob->erase</function> returns the actual number of + characters/bytes erased or &false; in case of error. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>offset</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>length</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><xref linkend="function.oci-lob-truncate" /></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/OCI-Lob-export.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc/en/reference/oci8/functions/OCI-Lob-export.xml diff -u phpdoc/en/reference/oci8/functions/OCI-Lob-export.xml:1.2 phpdoc/en/reference/oci8/functions/OCI-Lob-export.xml:1.3 --- phpdoc/en/reference/oci8/functions/OCI-Lob-export.xml:1.2 Fri May 14 11:25:52 2004 +++ phpdoc/en/reference/oci8/functions/OCI-Lob-export.xml Tue Sep 6 16:18:29 2005 @@ -1,30 +1,73 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> - <refentry id="function.oci-lob-export"> - <refnamediv> - <refname>lob->export</refname> - <refpurpose>Exports LOB's contents to a file</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>lob->export</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>start</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam> - </methodsynopsis> - <para> - Exports LOB's contents to a file, which name is given in parameter - <parameter>filename</parameter>. Optional parameter - <parameter>start</parameter> indicates from what position to start export - and parameter <parameter>length</parameter> - length of data to be - exported. - </para> - <para> - &return.success; - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.3 $ --> +<refentry id="function.oci-lob-export"> + <refnamediv> + <refname>OCI-Lob->export</refname> + <refpurpose>Exports LOB's contents to a file</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <classsynopsis> + <ooclass><classname>OCI-Lob</classname></ooclass> + <methodsynopsis> + <type>bool</type><methodname>export</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>start</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam> + </methodsynopsis> + </classsynopsis> + <para> + Exports LOB contents to a file. The file name is given in the parameter + <parameter>filename</parameter>. The optional parameter + <parameter>start</parameter> indicates from where to start exporting + and the parameter <parameter>length</parameter> - indicates the length of data to be + exported. + </para> + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>filename</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>start</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>length</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><xref linkend="function.oci-lob-import" /></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -46,3 +89,4 @@ vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> + http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/OCI-Lob-flush.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc/en/reference/oci8/functions/OCI-Lob-flush.xml diff -u phpdoc/en/reference/oci8/functions/OCI-Lob-flush.xml:1.3 phpdoc/en/reference/oci8/functions/OCI-Lob-flush.xml:1.4 --- phpdoc/en/reference/oci8/functions/OCI-Lob-flush.xml:1.3 Wed Jun 15 14:10:26 2005 +++ phpdoc/en/reference/oci8/functions/OCI-Lob-flush.xml Tue Sep 6 16:18:29 2005 @@ -1,35 +1,65 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> - <refentry id="function.oci-lob-flush"> - <refnamediv> - <refname>lob->flush</refname> - <refpurpose>Flushes/writes buffer of the LOB to the server</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>lob->flush</methodname> - <methodparam choice="opt"><type>int</type><parameter>flag</parameter></methodparam> - </methodsynopsis> - <para> - <function>lob->flush</function> actually writes data to the server. - By default, resources are not freed, but using flag - <constant>OCI_LOB_BUFFER_FREE</constant> you can do it explicitly. - Be sure you know what you're doing - next read/write operation to the - same part of LOB will involve a round-trip to the server and initialize - new buffer resources. It is recommended to use - <constant>OCI_LOB_BUFFER_FREE</constant> flag only when you are not going - to work with the LOB anymore. - </para> - <para> - <function>lob->flush</function> returns &false; if buffering was not - enabled or an error occurred. - </para> - <para> - &return.success; - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.4 $ --> +<refentry id="function.oci-lob-flush"> + <refnamediv> + <refname>OCI-Lob->flush</refname> + <refpurpose>Flushes/writes buffer of the LOB to the server</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <classsynopsis> + <ooclass><classname>OCI-Lob</classname></ooclass> + <methodsynopsis> + <type>bool</type><methodname>flush</methodname> + <methodparam choice="opt"><type>int</type><parameter>flag</parameter></methodparam> + </methodsynopsis> + </classsynopsis> + <para> + <function>OCI-Lob->flush</function> actually writes data to the server. + By default, resources are not freed, but using flag + <constant>OCI_LOB_BUFFER_FREE</constant> you can do it explicitly. + Be sure you know what you're doing - next read/write operation to the + same part of LOB will involve a round-trip to the server and initialize + new buffer resources. It is recommended to use + <constant>OCI_LOB_BUFFER_FREE</constant> flag only when you are not going + to work with the LOB anymore. + </para> + <para> + <function>OCI-Lob->flush</function> returns &false; if buffering was not + enabled or an error occurred. + </para> + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>flag</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><xref linkend="function.oci-lob-getbuffering" /></member> + <member><xref linkend="function.oci-lob-setbuffering" /></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/OCI-Lob-free.xml?r1=1.1&r2=1.2&ty=u Index: phpdoc/en/reference/oci8/functions/OCI-Lob-free.xml diff -u phpdoc/en/reference/oci8/functions/OCI-Lob-free.xml:1.1 phpdoc/en/reference/oci8/functions/OCI-Lob-free.xml:1.2 --- phpdoc/en/reference/oci8/functions/OCI-Lob-free.xml:1.1 Mon Mar 8 09:12:17 2004 +++ phpdoc/en/reference/oci8/functions/OCI-Lob-free.xml Tue Sep 6 16:18:29 2005 @@ -1,25 +1,30 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> - <refentry id="function.oci-free-descriptor"> - <refnamediv> - <refname>descriptor->free</refname> - <refpurpose>Frees resources associated with descriptor</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>descriptor->free</methodname> - <void /> - </methodsynopsis> - <para> - <function>descriptor->free</function> frees resources associated with - descriptor, previously allocated with <function>oci_new_descriptor</function>. - </para> - <para> - &return.success; - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.2 $ --> +<refentry id="function.oci-lob-free"> + <refnamediv> + <refname>OCI-Lob->free</refname> + <refpurpose>Frees resources associated with the LOB descriptor</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <classsynopsis> + <ooclass><classname>OCI-Lob</classname></ooclass> + <methodsynopsis> + <type>bool</type><methodname>free</methodname> + <void /> + </methodsynopsis> + </classsynopsis> + <para> + Frees resources associated with the descriptor, previously allocated with + <function>oci_new_descriptor</function>. + </para> + <para> + &return.success; + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/OCI-Lob-getBuffering.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc/en/reference/oci8/functions/OCI-Lob-getBuffering.xml diff -u phpdoc/en/reference/oci8/functions/OCI-Lob-getBuffering.xml:1.2 phpdoc/en/reference/oci8/functions/OCI-Lob-getBuffering.xml:1.3 --- phpdoc/en/reference/oci8/functions/OCI-Lob-getBuffering.xml:1.2 Mon Mar 8 11:49:36 2004 +++ phpdoc/en/reference/oci8/functions/OCI-Lob-getBuffering.xml Tue Sep 6 16:18:29 2005 @@ -1,25 +1,36 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> -<refentry id="function.ocigetbufferinglob"> - <refnamediv> - <refname>lob->getBuffering</refname> - <refpurpose>Returns current state of buffering for large object</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>lob->getBuffering</methodname> - <void/> - </methodsynopsis> - <para> - Returns &false; if buffering for the large object is off and &true; if - buffering is used. - </para> - <para> - See also <function>ocisetbufferinglob</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.3 $ --> +<refentry id="function.oci-lob-getbuffering"> + <refnamediv> + <refname>OCI-Lob->getBuffering</refname> + <refpurpose>Returns current state of buffering for the large object</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <classsynopsis> + <ooclass><classname>OCI-Lob</classname></ooclass> + <methodsynopsis> + <type>bool</type><methodname>getBuffering</methodname> + <void/> + </methodsynopsis> + </classsynopsis> + <para> + Returns &false; if buffering for the large object is off and &true; if + buffering is used. + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><xref linkend="function.oci-lob-setbuffering" /></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/OCI-Lob-import.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc/en/reference/oci8/functions/OCI-Lob-import.xml diff -u phpdoc/en/reference/oci8/functions/OCI-Lob-import.xml:1.2 phpdoc/en/reference/oci8/functions/OCI-Lob-import.xml:1.3 --- phpdoc/en/reference/oci8/functions/OCI-Lob-import.xml:1.2 Thu Apr 1 03:11:27 2004 +++ phpdoc/en/reference/oci8/functions/OCI-Lob-import.xml Tue Sep 6 16:18:29 2005 @@ -1,33 +1,55 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> - <refentry id="function.oci-lob-import"> - <refnamediv> - <refname>lob->import</refname> - <refpurpose>Imports file data to the LOB</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>lob->import</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - </methodsynopsis> - <para> - Writes data from <parameter>filename</parameter> in to the current - position of large object. - </para> - <para> - &return.success; - </para> - <note> - <para> - In PHP versions before 5.0.0 you must use <function>ocisavelobfile</function> instead. - This name still can be used, it was left as alias of - <function>oci_lob_import</function> for downwards compatability. - This, however, is deprecated and not recommended. - </para> - </note> - </refsect1> - </refentry> +<!-- $Revision: 1.3 $ --> +<refentry id="function.oci-lob-import"> + <refnamediv> + <refname>OCI-Lob->import</refname> + <refpurpose>Imports file data to the LOB</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <classsynopsis> + <ooclass><classname>OCI-Lob</classname></ooclass> + <methodsynopsis> + <type>bool</type><methodname>import</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + </methodsynopsis> + </classsynopsis> + <para> + Writes data from the <parameter>filename</parameter> in to the current + position of large object. + </para> + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>filename</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><xref linkend="function.oci-lob-export" /></member> + <member><xref linkend="function.oci-lob-write" /></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/OCI-Lob-load.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc/en/reference/oci8/functions/OCI-Lob-load.xml diff -u phpdoc/en/reference/oci8/functions/OCI-Lob-load.xml:1.3 phpdoc/en/reference/oci8/functions/OCI-Lob-load.xml:1.4 --- phpdoc/en/reference/oci8/functions/OCI-Lob-load.xml:1.3 Thu Apr 1 03:11:28 2004 +++ phpdoc/en/reference/oci8/functions/OCI-Lob-load.xml Tue Sep 6 16:18:29 2005 @@ -1,33 +1,39 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> - <refentry id="function.oci-lob-load"> - <refnamediv> - <refname>lob->load</refname> - <refpurpose>Returns large object's contents</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>string</type><methodname>lob->load</methodname> - <void /> - </methodsynopsis> - <para> - Returns large object's contents. As script execution is terminated - when the <link linkend="ini.memory-limit">memory_limit</link> is reached, - ensure that the LOB does not exceed this limit. In most cases it's - recommended to use <function>oci_lob_read</function> instead. In case of - error <function>lob->load</function> returns &false;. - </para> - <note> - <para> - In PHP versions before 5.0.0 you must use <function>ociloadlob</function> instead. - This name still can be used, it was left as alias of - <function>oci_lob_load</function> for downwards compatability. - This, however, is deprecated and not recommended. - </para> - </note> - </refsect1> - </refentry> +<!-- $Revision: 1.4 $ --> +<refentry id="function.oci-lob-load"> + <refnamediv> + <refname>OCI-Lob->load</refname> + <refpurpose>Returns large object's contents</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <classsynopsis> + <ooclass><classname>OCI-Lob</classname></ooclass> + <methodsynopsis> + <type>string</type><methodname>load</methodname> + <void /> + </methodsynopsis> + </classsynopsis> + <para> + Returns large object's contents. As script execution is terminated + when the <link linkend="ini.memory-limit">memory_limit</link> is reached, + ensure that the LOB does not exceed this limit. In most cases it's + recommended to use <xref linkend="function.oci-lob-read" /> instead. + In case of error <function>OCI-Lob->load</function> returns &false;. + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><xref linkend="function.oci-lob-read" /></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/OCI-Lob-read.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc/en/reference/oci8/functions/OCI-Lob-read.xml diff -u phpdoc/en/reference/oci8/functions/OCI-Lob-read.xml:1.2 phpdoc/en/reference/oci8/functions/OCI-Lob-read.xml:1.3 --- phpdoc/en/reference/oci8/functions/OCI-Lob-read.xml:1.2 Mon Mar 8 11:49:36 2004 +++ phpdoc/en/reference/oci8/functions/OCI-Lob-read.xml Tue Sep 6 16:18:29 2005 @@ -1,34 +1,57 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> - <refentry id="function.oci-lob-read"> - <refnamediv> - <refname>lob->read</refname> - <refpurpose>Reads part of large object</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>string</type><methodname>lob->read</methodname> - <methodparam><type>int</type><parameter>length</parameter></methodparam> - </methodsynopsis> - <para> - Reads <parameter>length</parameter> bytes from the current position of - LOB's internal pointer. Reading stops when <parameter>length</parameter> - bytes have been read or end of large object is reached. - Internal pointer of large object will be shifted on the amount of bytes - read. - </para> - <para> - Returns &false; in case of error. - </para> - <para> - See also <function>oci_lob_eof</function>, - <function>oci_lob_seek</function>, - <function>oci_lob_tell</function> and - <function>oci_lob_write</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.3 $ --> +<refentry id="function.oci-lob-read"> + <refnamediv> + <refname>OCI-Lob->read</refname> + <refpurpose>Reads part of the large object</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <classsynopsis> + <ooclass><classname>OCI-Lob</classname></ooclass> + <methodsynopsis> + <type>string</type><methodname>read</methodname> + <methodparam><type>int</type><parameter>length</parameter></methodparam> + </methodsynopsis> + </classsynopsis> + <para> + Reads <parameter>length</parameter> bytes from the current position of LOB's internal pointer. + Reading stops when <parameter>length</parameter> bytes have been read or + end of the large object is reached. Internal pointer of the large object will + be shifted on the amount of bytes read. + </para> + <para> + Returns &false; in case of error. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>length</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><xref linkend="function.oci-lob-load" /></member> + <member><xref linkend="function.oci-lob-write" /></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -50,3 +73,4 @@ vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> + http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/OCI-Lob-rewind.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc/en/reference/oci8/functions/OCI-Lob-rewind.xml diff -u phpdoc/en/reference/oci8/functions/OCI-Lob-rewind.xml:1.2 phpdoc/en/reference/oci8/functions/OCI-Lob-rewind.xml:1.3 --- phpdoc/en/reference/oci8/functions/OCI-Lob-rewind.xml:1.2 Tue Mar 9 04:28:19 2004 +++ phpdoc/en/reference/oci8/functions/OCI-Lob-rewind.xml Tue Sep 6 16:18:29 2005 @@ -1,28 +1,40 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> - <refentry id="function.oci-lob-rewind"> - <refnamediv> - <refname>lob->rewind</refname> - <refpurpose>Moves the internal pointer to the beginning of the large object</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>lob->rewind</methodname> - <void /> - </methodsynopsis> - <para> - Sets the internal pointer to the beginning of the large object. - </para> - <para> - &return.success; - </para> - <para> - See also <function>oci_lob_seek</function> and - <function>oci_lob_tell</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.3 $ --> +<refentry id="function.oci-lob-rewind"> + <refnamediv> + <refname>OCI-Lob->rewind</refname> + <refpurpose>Moves the internal pointer to the beginning of the large object</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <classsynopsis> + <ooclass><classname>OCI-Lob</classname></ooclass> + <methodsynopsis> + <type>bool</type><methodname>rewind</methodname> + <void /> + </methodsynopsis> + </classsynopsis> + <para> + Sets the internal pointer to the beginning of the large object. + </para> + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><xref linkend="function.oci-lob-seek" /></member> + <member><xref linkend="function.oci-lob-tell" /></member> + </simplelist> + </para> + </refsect1> + +</refentry> + <!-- Keep this comment at the end of the file Local variables: mode: sgml http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/OCI-Lob-save.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc/en/reference/oci8/functions/OCI-Lob-save.xml diff -u phpdoc/en/reference/oci8/functions/OCI-Lob-save.xml:1.2 phpdoc/en/reference/oci8/functions/OCI-Lob-save.xml:1.3 --- phpdoc/en/reference/oci8/functions/OCI-Lob-save.xml:1.2 Thu Apr 1 03:11:28 2004 +++ phpdoc/en/reference/oci8/functions/OCI-Lob-save.xml Tue Sep 6 16:18:29 2005 @@ -1,39 +1,66 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> - <refentry id="function.oci-lob-save"> - <refnamediv> - <refname>lob->save</refname> - <refpurpose>Saves data to the large object</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>lob->save</methodname> - <methodparam><type>string</type><parameter>data</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>offset</parameter></methodparam> - </methodsynopsis> - <para> - Saves <parameter>data</parameter> to the large object. - Parameter <parameter>offset</parameter> can be used to indicate offset - from the beginning of the large object. - </para> - <para> - &return.success; - </para> - <note> - <para> - In PHP versions before 5.0.0 you must use <function>ocisavelob</function> instead. - This name still can be used, it was left as alias of - <function>oci_lob_save</function> for downwards compatability. - This, however, is deprecated and not recommended. - </para> - </note> - <para> - See also <function>oci_lob_write</function> and - <function>oci_lob_import</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.3 $ --> +<refentry id="function.oci-lob-save"> + <refnamediv> + <refname>OCI-Lob->save</refname> + <refpurpose>Saves data to the large object</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <classsynopsis> + <ooclass><classname>OCI-Lob</classname></ooclass> + <methodsynopsis> + <type>bool</type><methodname>save</methodname> + <methodparam><type>string</type><parameter>data</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>offset</parameter></methodparam> + </methodsynopsis> + </classsynopsis> + <para> + Saves <parameter>data</parameter> to the large object. + Parameter <parameter>offset</parameter> can be used to indicate offset + from the beginning of the large object. + </para> + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>data</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> + <variablelist> + <varlistentry> + <term><parameter>offset</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><xref linkend="function.oci-lob-write" /></member> + <member><xref linkend="function.oci-lob-import" /></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/OCI-Lob-seek.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc/en/reference/oci8/functions/OCI-Lob-seek.xml diff -u phpdoc/en/reference/oci8/functions/OCI-Lob-seek.xml:1.2 phpdoc/en/reference/oci8/functions/OCI-Lob-seek.xml:1.3 --- phpdoc/en/reference/oci8/functions/OCI-Lob-seek.xml:1.2 Tue Mar 9 04:28:19 2004 +++ phpdoc/en/reference/oci8/functions/OCI-Lob-seek.xml Tue Sep 6 16:18:29 2005 @@ -1,44 +1,81 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> - <refentry id="function.oci-lob-seek"> - <refnamediv> - <refname>lob->seek</refname> - <refpurpose>Sets the internal pointer of the large object</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>lob->seek</methodname> - <methodparam><type>int</type><parameter>offset</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>whence</parameter></methodparam> - </methodsynopsis> - <para> - Sets the internal pointer of the large object. Parameter - <parameter>offset</parameter> indicates the amount of - bytes, on which internal pointer should be moved from the position, - pointed by <parameter>whence</parameter>: - <simplelist> - <member> - <constant>OCI_SEEK_SET</constant> - sets the position equal to - <parameter>offset</parameter> - </member> - <member> - <constant>OCI_SEEK_CUR</constant> - adds <parameter>offset</parameter> - bytes to the current position - </member> - <member> - <constant>OCI_SEEK_END</constant> - adds <parameter>offset</parameter> - bytes to the end of large object (use negative value to move to a position - before the end of large object) - </member> - </simplelist> - </para> - <para> - See also <function>oci_lob_rewind</function> and - <function>oci_lob_tell</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.3 $ --> +<refentry id="function.oci-lob-seek"> + <refnamediv> + <refname>OCI-Lob->seek</refname> + <refpurpose>Sets the internal pointer of the large object</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <classsynopsis> + <ooclass><classname>OCI-Lob</classname></ooclass> + <methodsynopsis> + <type>bool</type><methodname>seek</methodname> + <methodparam><type>int</type><parameter>offset</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>whence</parameter></methodparam> + </methodsynopsis> + </classsynopsis> + <para> + Sets the internal pointer of the large object. Parameter + <parameter>offset</parameter> indicates the amount of + bytes, on which internal pointer should be moved from the position, + pointed by <parameter>whence</parameter>: + <simplelist> + <member> + <constant>OCI_SEEK_SET</constant> - sets the position equal to + <parameter>offset</parameter> + </member> + <member> + <constant>OCI_SEEK_CUR</constant> - adds <parameter>offset</parameter> + bytes to the current position + </member> + <member> + <constant>OCI_SEEK_END</constant> - adds <parameter>offset</parameter> + bytes to the end of large object (use negative value to move to a position + before the end of large object) + </member> + </simplelist> + </para> + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>offset</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>whence</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><xref linkend="function.oci-lob-rewind" /></member> + <member><xref linkend="function.oci-lob-tell" /></member> + <member><xref linkend="function.oci-lob-eof" /></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/OCI-Lob-setBuffering.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc/en/reference/oci8/functions/OCI-Lob-setBuffering.xml diff -u phpdoc/en/reference/oci8/functions/OCI-Lob-setBuffering.xml:1.3 phpdoc/en/reference/oci8/functions/OCI-Lob-setBuffering.xml:1.4 --- phpdoc/en/reference/oci8/functions/OCI-Lob-setBuffering.xml:1.3 Thu Aug 12 21:00:47 2004 +++ phpdoc/en/reference/oci8/functions/OCI-Lob-setBuffering.xml Tue Sep 6 16:18:29 2005 @@ -1,38 +1,64 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> - <refentry id="function.ocisetbufferinglob"> - <refnamediv> - <refname>lob->setBuffering</refname> - <refpurpose>Changes current state of buffering for large object</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>lob->setBuffering</methodname> - <methodparam><type>bool</type><parameter>on_off</parameter></methodparam> - </methodsynopsis> - <para> - <function>lob->setBuffering</function> sets the buffering for the - large object, depending on the value of the <parameter>on_off</parameter> - parameter. Repeated calls to <function>lob->setBuffering</function> with - the same flag will return &true;. The values for <parameter>on_off - </parameter> are: &true; for on and &false; for off. - </para> - <para> - Use of this function may provide performance improvements by buffering - small reads and writes of LOBs by reducing the number of network - round-trips and LOB versions. <function>oci_lob_flush</function> should - be used to flush buffers, when you have finished working with the large - object. - </para> - <para> - &return.success; - </para> - <para> - See also <function>ocigetbufferinglob</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.4 $ --> +<refentry id="function.oci-lob-setbuffering"> + <refnamediv> + <refname>OCI-Lob->setBuffering</refname> + <refpurpose>Changes current state of buffering for the large object</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <classsynopsis> + <ooclass><classname>OCI-Lob</classname></ooclass> + <methodsynopsis> + <type>bool</type><methodname>setBuffering</methodname> + <methodparam><type>bool</type><parameter>on_off</parameter></methodparam> + </methodsynopsis> + </classsynopsis> + <para> + <function>lob->setBuffering</function> sets the buffering for the + large object, depending on the value of the <parameter>on_off</parameter> + parameter. Repeated calls to <function>lob->setBuffering</function> with + the same flag will return &true;. The values for <parameter>on_off + </parameter> are: &true; for on and &false; for off. + </para> + <para> + Use of this function may provide performance improvements by buffering + small reads and writes of LOBs by reducing the number of network + round-trips and LOB versions. <function>oci_lob_flush</function> should + be used to flush buffers, when you have finished working with the large + object. + </para> + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>on_off</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><xref linkend="function.oci-lob-getbuffering" /></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/OCI-Lob-size.xml?r1=1.1&r2=1.2&ty=u Index: phpdoc/en/reference/oci8/functions/OCI-Lob-size.xml diff -u phpdoc/en/reference/oci8/functions/OCI-Lob-size.xml:1.1 phpdoc/en/reference/oci8/functions/OCI-Lob-size.xml:1.2 --- phpdoc/en/reference/oci8/functions/OCI-Lob-size.xml:1.1 Mon Mar 8 09:12:17 2004 +++ phpdoc/en/reference/oci8/functions/OCI-Lob-size.xml Tue Sep 6 16:18:29 2005 @@ -1,22 +1,27 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> - <refentry id="function.oci-lob-size"> - <refnamediv> - <refname>lob->size</refname> - <refpurpose>Returns size of large object</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>lob->size</methodname> - <void /> - </methodsynopsis> - <para> - Returns length of large object value or &false; in case of error. - Empty objects have zero length. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.2 $ --> +<refentry id="function.oci-lob-size"> + <refnamediv> + <refname>OCI-Lob->size</refname> + <refpurpose>Returns size of large object</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <classsynopsis> + <ooclass><classname>OCI-Lob</classname></ooclass> + <methodsynopsis> + <type>int</type><methodname>size</methodname> + <void /> + </methodsynopsis> + </classsynopsis> + <para> + Returns length of large object value or &false; in case of error. + Empty objects have zero length. + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/OCI-Lob-tell.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc/en/reference/oci8/functions/OCI-Lob-tell.xml diff -u phpdoc/en/reference/oci8/functions/OCI-Lob-tell.xml:1.3 phpdoc/en/reference/oci8/functions/OCI-Lob-tell.xml:1.4 --- phpdoc/en/reference/oci8/functions/OCI-Lob-tell.xml:1.3 Thu Aug 12 21:00:47 2004 +++ phpdoc/en/reference/oci8/functions/OCI-Lob-tell.xml Tue Sep 6 16:18:29 2005 @@ -1,26 +1,39 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> - <refentry id="function.oci-lob-tell"> - <refnamediv> - <refname>lob->tell</refname> - <refpurpose>Returns current position of internal pointer of large object</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>lob->tell</methodname> - <void /> - </methodsynopsis> - <para> - Returns current position of a LOB's internal pointer or &false; if an - error occurred. - </para> - <para> - See also <function>oci_lob_size</function> and - <function>oci_lob_eof</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.4 $ --> +<refentry id="function.oci-lob-tell"> + <refnamediv> + <refname>OCI-Lob->tell</refname> + <refpurpose>Returns current position of internal pointer of large object</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <classsynopsis> + <ooclass><classname>OCI-Lob</classname></ooclass> + <methodsynopsis> + <type>int</type><methodname>tell</methodname> + <void /> + </methodsynopsis> + </classsynopsis> + <para> + Returns current position of a LOB's internal pointer or &false; if an + error occurred. + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><xref linkend="function.oci-lob-rewind" /></member> + <member><xref linkend="function.oci-lob-size" /></member> + <member><xref linkend="function.oci-lob-eof" /></member> + </simplelist> + </para> + </refsect1> + +</refentry> + <!-- Keep this comment at the end of the file Local variables: mode: sgml http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/OCI-Lob-truncate.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc/en/reference/oci8/functions/OCI-Lob-truncate.xml diff -u phpdoc/en/reference/oci8/functions/OCI-Lob-truncate.xml:1.2 phpdoc/en/reference/oci8/functions/OCI-Lob-truncate.xml:1.3 --- phpdoc/en/reference/oci8/functions/OCI-Lob-truncate.xml:1.2 Tue Mar 9 04:28:19 2004 +++ phpdoc/en/reference/oci8/functions/OCI-Lob-truncate.xml Tue Sep 6 16:18:29 2005 @@ -1,30 +1,56 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> - <refentry id="function.oci-lob-truncate"> - <refnamediv> - <refname>lob->truncate</refname> - <refpurpose>Truncates large object</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>lob->truncate</methodname> - <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam> - </methodsynopsis> - <para> - If parameter <parameter>length</parameter> is given, - <function>lob->truncate</function> truncates large object to - <parameter>length</parameter> bytes. Otherwise, - <function>lob->truncate</function> will purge the LOB completely. - </para> - <para> - &return.success; - </para> - <para> - See also <function>oci_lob_erase</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.3 $ --> +<refentry id="function.oci-lob-truncate"> + <refnamediv> + <refname>OCI-Lob->truncate</refname> + <refpurpose>Truncates large object</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <classsynopsis> + <ooclass><classname>OCI-Lob</classname></ooclass> + <methodsynopsis> + <type>bool</type><methodname>truncate</methodname> + <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam> + </methodsynopsis> + </classsynopsis> + <para> + If parameter <parameter>length</parameter> is given, + <function>OCI-Lob->truncate</function> truncates large object to + <parameter>length</parameter> bytes. Otherwise, + <function>OCI-Lob->truncate</function> will purge the LOB completely. + </para> + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>length</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><xref linkend="function.oci-lob-erase" /></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -46,4 +72,3 @@ vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> - http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/OCI-Lob-write.xml?r1=1.1&r2=1.2&ty=u Index: phpdoc/en/reference/oci8/functions/OCI-Lob-write.xml diff -u phpdoc/en/reference/oci8/functions/OCI-Lob-write.xml:1.1 phpdoc/en/reference/oci8/functions/OCI-Lob-write.xml:1.2 --- phpdoc/en/reference/oci8/functions/OCI-Lob-write.xml:1.1 Mon Mar 8 09:12:17 2004 +++ phpdoc/en/reference/oci8/functions/OCI-Lob-write.xml Tue Sep 6 16:18:29 2005 @@ -1,33 +1,67 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> - <refentry id="function.oci-lob-write"> - <refnamediv> - <refname>lob->write</refname> - <refpurpose>Writes data to the large object</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>lob->write</methodname> - <methodparam><type>string</type><parameter>data</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam> - </methodsynopsis> - <para> - Writes data from the parameter <parameter>data</parameter> into the - current position of LOB's internal pointer. - If the parameter <parameter>length</parameter> is given, writing will - stop after <parameter>length</parameter> bytes have been written or the - end of <parameter>data</parameter> is reached, whichever comes first. - </para> - <para> - <function>lob->write</function> returns the number of bytes written or - &false; in case of error. - </para> - <para> - See also <function>oci_lob_read</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.2 $ --> +<refentry id="function.oci-lob-write"> + <refnamediv> + <refname>OCI-Lob->write</refname> + <refpurpose>Writes data to the large object</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <classsynopsis> + <ooclass><classname>OCI-Lob</classname></ooclass> + <methodsynopsis> + <type>int</type><methodname>write</methodname> + <methodparam><type>string</type><parameter>data</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam> + </methodsynopsis> + </classsynopsis> + <para> + Writes data from the parameter <parameter>data</parameter> into the + current position of LOB's internal pointer. + If the parameter <parameter>length</parameter> is given, writing will + stop after <parameter>length</parameter> bytes have been written or the + end of <parameter>data</parameter> is reached, whichever comes first. + </para> + <para> + <function>OCI-Lob->write</function> returns the number of bytes written or + &false; in case of error. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>data</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>length</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><xref linkend="function.oci-lob-read" /></member> + </simplelist> + </para> + </refsect1> + +</refentry> + <!-- Keep this comment at the end of the file Local variables: mode: sgml http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/OCI-Lob-writeTemporary.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc/en/reference/oci8/functions/OCI-Lob-writeTemporary.xml diff -u phpdoc/en/reference/oci8/functions/OCI-Lob-writeTemporary.xml:1.3 phpdoc/en/reference/oci8/functions/OCI-Lob-writeTemporary.xml:1.4 --- phpdoc/en/reference/oci8/functions/OCI-Lob-writeTemporary.xml:1.3 Thu Apr 1 03:11:28 2004 +++ phpdoc/en/reference/oci8/functions/OCI-Lob-writeTemporary.xml Tue Sep 6 16:18:29 2005 @@ -1,55 +1,73 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> - <refentry id="function.oci-lob-write-temporary"> - <refnamediv> - <refname>lob->writeTemporary</refname> - <refpurpose>Writes temporary large object</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>lob->writeTemporary</methodname> - <methodparam><type>string</type><parameter>data</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>lob_type</parameter></methodparam> - </methodsynopsis> - <para> - Creates a temporary large object and writes <parameter>data</parameter> - to it. - </para> - <para> - Parameter <parameter>lob_type</parameter> can be one of the following: - <simplelist> - <member> - <constant>OCI_TEMP_BLOB</constant> is used to create temporary BLOBs - </member> - <member> - <constant>OCI_TEMP_CLOB</constant> is used to create temporary CLOBs - </member> - </simplelist> - </para> - <para> - <function>lob->writeTemporary</function> creates a CLOB by default. - </para> - <para> - You should use <function>oci_lob_close</function> when the work with the - object is over. - </para> - <para> - &return.success; - </para> - <note> - <para> - In PHP versions before 5.0.0 you must use <function>ociwritetemporarylob</function> instead. - This name still can be used, it was left as alias of - <function>oci_lob_write_temporary</function> for downwards compatability. - This, however, is deprecated and not recommended. - </para> - </note> - <para> - See also <function>oci_lob_close</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.4 $ --> +<refentry id="function.oci-lob-writetemporary"> + <refnamediv> + <refname>OCI-Lob->writeTemporary</refname> + <refpurpose>Writes temporary large object</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <classsynopsis> + <ooclass><classname>OCI-Lob</classname></ooclass> + <methodsynopsis> + <type>bool</type><methodname>writeTemporary</methodname> + <methodparam><type>string</type><parameter>data</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>lob_type</parameter></methodparam> + </methodsynopsis> + </classsynopsis> + <para> + Creates a temporary large object and writes <parameter>data</parameter> + to it. + </para> + <para> + Parameter <parameter>lob_type</parameter> can be one of the following: + <simplelist> + <member> + <constant>OCI_TEMP_BLOB</constant> is used to create temporary BLOBs + </member> + <member> + <constant>OCI_TEMP_CLOB</constant> is used to create temporary CLOBs + </member> + </simplelist> + </para> + <para> + <function>OCI-Lob->writeTemporary</function> creates a CLOB by default. + </para> + <para> + You should use <xref linkend="function.oci-lob-close" /> when the work with the + object is over. + </para> + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>lob_type</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><xref linkend="function.oci-lob-close" /></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/oci-bind-by-name.xml?r1=1.6&r2=1.7&ty=u Index: phpdoc/en/reference/oci8/functions/oci-bind-by-name.xml diff -u phpdoc/en/reference/oci8/functions/oci-bind-by-name.xml:1.6 phpdoc/en/reference/oci8/functions/oci-bind-by-name.xml:1.7 --- phpdoc/en/reference/oci8/functions/oci-bind-by-name.xml:1.6 Fri Jul 1 09:07:49 2005 +++ phpdoc/en/reference/oci8/functions/oci-bind-by-name.xml Tue Sep 6 16:18:29 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> +<!-- $Revision: 1.7 $ --> <refentry id="function.oci-bind-by-name"> <refnamediv> <refname>oci_bind_by_name</refname> @@ -171,7 +171,7 @@ </example> </para> <para> - Remember, that this function strips trailing whitespace. See the following + Remember, this function strips trailing whitespaces. See the following example: </para> <para> @@ -262,3 +262,4 @@ vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> + http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/oci-cancel.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc/en/reference/oci8/functions/oci-cancel.xml diff -u phpdoc/en/reference/oci8/functions/oci-cancel.xml:1.3 phpdoc/en/reference/oci8/functions/oci-cancel.xml:1.4 --- phpdoc/en/reference/oci8/functions/oci-cancel.xml:1.3 Thu Apr 1 03:11:26 2004 +++ phpdoc/en/reference/oci8/functions/oci-cancel.xml Tue Sep 6 16:18:29 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <refentry id="function.oci-cancel"> <refnamediv> <refname>oci_cancel</refname> http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/oci-close.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc/en/reference/oci8/functions/oci-close.xml diff -u phpdoc/en/reference/oci8/functions/oci-close.xml:1.4 phpdoc/en/reference/oci8/functions/oci-close.xml:1.5 --- phpdoc/en/reference/oci8/functions/oci-close.xml:1.4 Thu Apr 1 03:11:26 2004 +++ phpdoc/en/reference/oci8/functions/oci-close.xml Tue Sep 6 16:18:29 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> +<!-- $Revision: 1.5 $ --> <refentry id="function.oci-close"> <refnamediv> <refname>oci_close</refname> @@ -17,11 +17,11 @@ </para> <note> <para> - As non-persistent links are closed automatically at the end of script - execution, calling this function is not required. Because of this and - the method the extension uses to handle connection resources, - <function>oci_close</function> currently provides no actual - functionality. + Starting from the version 1.1 <function>oci_close</function> correctly + closes the Oracle connection. + Use <link + linkend="ini.oci8.old_oci_close_semantics">oci8.old_oci_close_semantics</link> + option to restore old behaviour of this function. </para> </note> <para> @@ -29,7 +29,7 @@ </para> <note> <para> - In PHP versions before 5.0.0 you must use <function>ociclose</function> instead. + In PHP versions before 5.0.0 you must use <function>ocilogoff</function> instead. This name still can be used, it was left as alias of <function>oci_close</function> for downwards compatability. This, however, is deprecated and not recommended. http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/oci-commit.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc/en/reference/oci8/functions/oci-commit.xml diff -u phpdoc/en/reference/oci8/functions/oci-commit.xml:1.3 phpdoc/en/reference/oci8/functions/oci-commit.xml:1.4 --- phpdoc/en/reference/oci8/functions/oci-commit.xml:1.3 Thu Apr 1 03:11:26 2004 +++ phpdoc/en/reference/oci8/functions/oci-commit.xml Tue Sep 6 16:18:29 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <refentry id="function.oci-commit"> <refnamediv> <refname>oci_commit</refname> @@ -63,6 +63,14 @@ </para> <note> <para> + Transactions are automatically rolled back when you close + the connection, or when the script ends, whichever is soonest. You + need to explicitly call <function>oci_commit</function> to commit + the transaction, or <function>oci_rollback</function> to abort it. + </para> + </note> + <note> + <para> In PHP versions before 5.0.0 you must use <function>ocicommit</function> instead. This name still can be used, it was left as alias of <function>oci_commit</function> for downwards compatability. http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/oci-connect.xml?r1=1.6&r2=1.7&ty=u Index: phpdoc/en/reference/oci8/functions/oci-connect.xml diff -u phpdoc/en/reference/oci8/functions/oci-connect.xml:1.6 phpdoc/en/reference/oci8/functions/oci-connect.xml:1.7 --- phpdoc/en/reference/oci8/functions/oci-connect.xml:1.6 Tue Aug 3 13:25:33 2004 +++ phpdoc/en/reference/oci8/functions/oci-connect.xml Tue Sep 6 16:18:29 2005 @@ -1,9 +1,9 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> +<!-- $Revision: 1.7 $ --> <refentry id="function.oci-connect"> <refnamediv> <refname>oci_connect</refname> - <refpurpose>Establishes a connection to Oracle server</refpurpose> + <refpurpose>Establishes a connection to the Oracle server</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -13,6 +13,7 @@ <methodparam><type>string</type><parameter>password</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>db</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>charset</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>session_mode</parameter></methodparam> </methodsynopsis> <para> <function>oci_connect</function> returns a connection identifier @@ -26,14 +27,41 @@ (<filename>tnsnames.ora</filename>) to determine which database to connect to. </para> + <para> + Parameter <parameter>session_mode</parameter> is available since version + 1.1 and accepts the following values: <constant>OCI_DEFAULT</constant>, + <constant>OCI_SYSOPER</constant> and <constant>OCI_SYSDBA</constant>. + If either <constant>OCI_SYSOPER</constant> or + <constant>OCI_SYSDBA</constant> were specified, + <function>oci_connect</function> will try to establish privileged + connection using external credentials. Privileged connections are + disabled by default. To enable them you need to set <link + linkend="ini.oci8.privileged_connect">oci8.privileged_connect</link> + to On. + </para> <note> <simpara> - <function>oci_connect</function> <emphasis>does not</emphasis> reestablish - the connection, if a connection with such parameters was established - before. In this case, <function>oci_connect</function> will return - identifier of previously opened connection. This means, that you cannot - use this function to separate transactions. To establish a distinctly new - connection, use <function>oci_new_connect</function>. + If you're using PHP with Oracle Instant Client, you can use easy connect + naming method described here: + <ulink + url="http://download-west.oracle.com/docs/cd/B12037_01/network.101/b10775/naming.htm#i498306"> + http://download-west.oracle.com/docs/cd/B12037_01/network.101/b10775/naming.htm#i498306</ulink>. + Basically this means you can specify "//db_host[:port]/database_name" + as database name. But if you want to use the old way of naming you + <emphasis>must</emphasis> set either <constant>ORACLE_HOME</constant> or + <constant>TNS_ADMIN</constant>. + </simpara> + </note> + <note> + <simpara> + The second and subsequent calls to <function>oci_connect</function> + with the same parameters will return the connection handle returned + from the first call. This means that queries issued against one + handle are also applied to the other handles, because they are the + <emphasis>same</emphasis> handle. This behaviour is demonstrated in + Example 1 below. If you require two handles to be transactionally + isolated from each other, you should use + <function>oci_new_connect</function> instead. </simpara> </note> &oci.charset; @@ -139,13 +167,15 @@ <note> <para> In PHP versions before 5.0.0 you must use <function>ocilogon</function> instead. - This name still can be used, it was left as alias of + This name still can be used, it was left as the alias of <function>oci_connect</function> for downwards compatability. This, however, is deprecated and not recommended. </para> - </note> <simpara> - See also <function>oci_pconnect</function> and - <function>oci_new_connect</function>. + </note> + <simpara> + See also <function>oci_pconnect</function>, + <function>oci_new_connect</function> and + <function>oci_close</function>. </simpara> </refsect1> </refentry> @@ -170,3 +200,4 @@ vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> + http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/oci-define-by-name.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc/en/reference/oci8/functions/oci-define-by-name.xml diff -u phpdoc/en/reference/oci8/functions/oci-define-by-name.xml:1.4 phpdoc/en/reference/oci8/functions/oci-define-by-name.xml:1.5 --- phpdoc/en/reference/oci8/functions/oci-define-by-name.xml:1.4 Wed Nov 10 03:30:36 2004 +++ phpdoc/en/reference/oci8/functions/oci-define-by-name.xml Tue Sep 6 16:18:29 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> +<!-- $Revision: 1.5 $ --> <refentry id="function.oci-define-by-name"> <refnamediv> <refname>oci_define_by_name</refname> @@ -18,12 +18,12 @@ </methodsynopsis> <para> <function>oci_define_by_name</function> defines PHP variables for fetches - of SQL-Columns. Be careful that Oracle uses ALL-UPPERCASE column names, - whereby in your select you can also write lowercase. + of SQL-Columns. Take into consideration that Oracle uses ALL-UPPERCASE column names, + whereby in your select you can also use lowercase. <function>oci_define_by_name</function> expects the <parameter>column_name</parameter> to be in uppercase. If you define a variable that doesn't exists in your select statement, no - error will issued. + error will be issued. </para> <para> If you need to define an abstract datatype (LOB/ROWID/BFILE) you @@ -91,3 +91,4 @@ vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> + http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/oci-error.xml?r1=1.5&r2=1.6&ty=u Index: phpdoc/en/reference/oci8/functions/oci-error.xml diff -u phpdoc/en/reference/oci8/functions/oci-error.xml:1.5 phpdoc/en/reference/oci8/functions/oci-error.xml:1.6 --- phpdoc/en/reference/oci8/functions/oci-error.xml:1.5 Tue Aug 17 10:29:24 2004 +++ phpdoc/en/reference/oci8/functions/oci-error.xml Tue Sep 6 16:18:29 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> +<!-- $Revision: 1.6 $ --> <refentry id="function.oci-error"> <refnamediv> <refname>oci_error</refname> http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/oci-execute.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc/en/reference/oci8/functions/oci-execute.xml diff -u phpdoc/en/reference/oci8/functions/oci-execute.xml:1.2 phpdoc/en/reference/oci8/functions/oci-execute.xml:1.3 --- phpdoc/en/reference/oci8/functions/oci-execute.xml:1.2 Thu Apr 1 03:11:26 2004 +++ phpdoc/en/reference/oci8/functions/oci-execute.xml Tue Sep 6 16:18:29 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <refentry id="function.oci-execute"> <refnamediv> <refname>oci_execute</refname> @@ -22,6 +22,13 @@ <parameter>mode</parameter>. </para> <para> + When using <constant>OCI_DEFAULT</constant> mode, you're creating a + transaction. Transactions are automatically rolled back when you close + the connection, or when the script ends, whichever is soonest. You + need to explicitly call <function>oci_commit</function> to commit + the transaction, or <function>oci_rollback</function> to abort it. + </para> + <para> &return.success; </para> <note> http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/oci-fetch-all.xml?r1=1.5&r2=1.6&ty=u Index: phpdoc/en/reference/oci8/functions/oci-fetch-all.xml diff -u phpdoc/en/reference/oci8/functions/oci-fetch-all.xml:1.5 phpdoc/en/reference/oci8/functions/oci-fetch-all.xml:1.6 --- phpdoc/en/reference/oci8/functions/oci-fetch-all.xml:1.5 Fri Jul 1 09:07:49 2005 +++ phpdoc/en/reference/oci8/functions/oci-fetch-all.xml Tue Sep 6 16:18:29 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> +<!-- $Revision: 1.6 $ --> <refentry id="function.oci-fetch-all"> <refnamediv> <refname>oci_fetch_all</refname> @@ -19,7 +19,7 @@ <function>oci_fetch_all</function> fetches all the rows from a result into a user-defined array. <function>oci_fetch_all</function> returns the number of rows - fetched or &false; in case of error. <parameter>skip</parameter> + fetched or &false; in case of an error. <parameter>skip</parameter> is the number of initial rows to ignore when fetching the result (default value of 0, to start at the first line). <parameter>maxrows</parameter> is the number of @@ -122,3 +122,4 @@ vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> + http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/oci-fetch-array.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc/en/reference/oci8/functions/oci-fetch-array.xml diff -u phpdoc/en/reference/oci8/functions/oci-fetch-array.xml:1.3 phpdoc/en/reference/oci8/functions/oci-fetch-array.xml:1.4 --- phpdoc/en/reference/oci8/functions/oci-fetch-array.xml:1.3 Thu Aug 12 11:29:06 2004 +++ phpdoc/en/reference/oci8/functions/oci-fetch-array.xml Tue Sep 6 16:18:29 2005 @@ -1,5 +1,5 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> + <?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.4 $ --> <refentry id="function.oci-fetch-array"> <refnamediv> <refname>oci_fetch_array</refname> @@ -16,7 +16,7 @@ </methodsynopsis> <para> Returns an array, which corresponds to the next result row or &false; in - case of error or there is no more rows in the result. + case of error or there are no more rows in the result. </para> <para> <function>oci_fetch_array</function> returns an array with both @@ -24,7 +24,7 @@ </para> &database.fetch-null; <para> - Optional second parameter can be any combination of the following + An optional second parameter can be any combination of the following constants: <simplelist> <member> @@ -58,8 +58,7 @@ </para> <note> <simpara> - Don't forget, that Oracle returns all field names in uppercase and - associative indices in the result array will be uppercased too. + Oracle returns all field names in uppercase and associative indices in the result array will be uppercased too. </simpara> </note> <para> @@ -185,3 +184,4 @@ vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> + http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/oci-fetch-assoc.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc/en/reference/oci8/functions/oci-fetch-assoc.xml diff -u phpdoc/en/reference/oci8/functions/oci-fetch-assoc.xml:1.2 phpdoc/en/reference/oci8/functions/oci-fetch-assoc.xml:1.3 --- phpdoc/en/reference/oci8/functions/oci-fetch-assoc.xml:1.2 Mon Jul 26 10:02:10 2004 +++ phpdoc/en/reference/oci8/functions/oci-fetch-assoc.xml Tue Sep 6 16:18:29 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <refentry id="function.oci-fetch-assoc"> <refnamediv> <refname>oci_fetch_assoc</refname> @@ -19,13 +19,12 @@ </para> &database.fetch-null; <para> - Subsequent call to <function>oci_fetch_assoc</function> will return - next row or &false; if there is no more rows. + A subsequent call to <function>oci_fetch_assoc</function> will return + the next row or &false; if there are no more rows. </para> <note> <simpara> - Don't forget, that Oracle returns all field names in uppercase and - associative indices in the result array will be uppercased too. + Oracle returns all field names in uppercase and associative indices in the result array will be uppercased too. </simpara> </note> <para> @@ -57,3 +56,4 @@ vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> + http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/oci-fetch-object.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc/en/reference/oci8/functions/oci-fetch-object.xml diff -u phpdoc/en/reference/oci8/functions/oci-fetch-object.xml:1.3 phpdoc/en/reference/oci8/functions/oci-fetch-object.xml:1.4 --- phpdoc/en/reference/oci8/functions/oci-fetch-object.xml:1.3 Mon Jul 26 10:02:10 2004 +++ phpdoc/en/reference/oci8/functions/oci-fetch-object.xml Tue Sep 6 16:18:29 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <refentry id="function.oci-fetch-object"> <refnamediv> <refname>oci_fetch_object</refname> @@ -18,12 +18,11 @@ &database.fetch-null; <para> Subsequent calls to <function>oci_fetch_object</function> will return the - next row from the result or &false; if there is no more rows. + next row from the result or &false; if there are no more rows. </para> <note> <simpara> - Don't forget, that Oracle returns all field names in uppercase and - attributes' names in the result object will be in uppercase as well. + Oracle returns all field names in uppercase and attributes' names in the result object will be in uppercase as well. </simpara> </note> <para> @@ -55,3 +54,4 @@ vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> + http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/oci-fetch-row.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc/en/reference/oci8/functions/oci-fetch-row.xml diff -u phpdoc/en/reference/oci8/functions/oci-fetch-row.xml:1.3 phpdoc/en/reference/oci8/functions/oci-fetch-row.xml:1.4 --- phpdoc/en/reference/oci8/functions/oci-fetch-row.xml:1.3 Mon Jul 26 10:02:10 2004 +++ phpdoc/en/reference/oci8/functions/oci-fetch-row.xml Tue Sep 6 16:18:29 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <refentry id="function.oci-fetch-row"> <refnamediv> <refname>oci_fetch_row</refname> @@ -20,7 +20,7 @@ &database.fetch-null; <para> Subsequent calls to <function>oci_fetch_row</function> will return the - next row from the result data or &false; if there is no more rows. + next row from the result data or &false; if there are no more rows. </para> <para> See also <function>oci_fetch_array</function>, @@ -51,3 +51,4 @@ vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> + http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/oci-field-name.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc/en/reference/oci8/functions/oci-field-name.xml diff -u phpdoc/en/reference/oci8/functions/oci-field-name.xml:1.3 phpdoc/en/reference/oci8/functions/oci-field-name.xml:1.4 --- phpdoc/en/reference/oci8/functions/oci-field-name.xml:1.3 Thu Apr 1 03:11:27 2004 +++ phpdoc/en/reference/oci8/functions/oci-field-name.xml Tue Sep 6 16:18:29 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <refentry id="function.oci-field-name"> <refnamediv> <refname>oci_field_name</refname> http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/oci-field-precision.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc/en/reference/oci8/functions/oci-field-precision.xml diff -u phpdoc/en/reference/oci8/functions/oci-field-precision.xml:1.3 phpdoc/en/reference/oci8/functions/oci-field-precision.xml:1.4 --- phpdoc/en/reference/oci8/functions/oci-field-precision.xml:1.3 Thu Apr 1 03:11:27 2004 +++ phpdoc/en/reference/oci8/functions/oci-field-precision.xml Tue Sep 6 16:18:29 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <refentry id="function.oci-field-precision"> <refnamediv> <refname>oci_field_precision</refname> http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/oci-field-scale.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc/en/reference/oci8/functions/oci-field-scale.xml diff -u phpdoc/en/reference/oci8/functions/oci-field-scale.xml:1.3 phpdoc/en/reference/oci8/functions/oci-field-scale.xml:1.4 --- phpdoc/en/reference/oci8/functions/oci-field-scale.xml:1.3 Thu Apr 1 03:11:27 2004 +++ phpdoc/en/reference/oci8/functions/oci-field-scale.xml Tue Sep 6 16:18:29 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <refentry id="function.oci-field-scale"> <refnamediv> <refname>oci_field_scale</refname> http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/oci-field-size.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc/en/reference/oci8/functions/oci-field-size.xml diff -u phpdoc/en/reference/oci8/functions/oci-field-size.xml:1.3 phpdoc/en/reference/oci8/functions/oci-field-size.xml:1.4 --- phpdoc/en/reference/oci8/functions/oci-field-size.xml:1.3 Thu Apr 1 03:11:27 2004 +++ phpdoc/en/reference/oci8/functions/oci-field-size.xml Tue Sep 6 16:18:29 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <refentry id="function.oci-field-size"> <refnamediv> <refname>oci_field_size</refname> http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/oci-field-type-raw.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc/en/reference/oci8/functions/oci-field-type-raw.xml diff -u phpdoc/en/reference/oci8/functions/oci-field-type-raw.xml:1.3 phpdoc/en/reference/oci8/functions/oci-field-type-raw.xml:1.4 --- phpdoc/en/reference/oci8/functions/oci-field-type-raw.xml:1.3 Thu Apr 1 03:11:27 2004 +++ phpdoc/en/reference/oci8/functions/oci-field-type-raw.xml Tue Sep 6 16:18:29 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <refentry id="function.oci-field-type-raw"> <refnamediv> <refname>oci_field_type_raw</refname> http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/oci-field-type.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc/en/reference/oci8/functions/oci-field-type.xml diff -u phpdoc/en/reference/oci8/functions/oci-field-type.xml:1.4 phpdoc/en/reference/oci8/functions/oci-field-type.xml:1.5 --- phpdoc/en/reference/oci8/functions/oci-field-type.xml:1.4 Fri Aug 13 10:10:02 2004 +++ phpdoc/en/reference/oci8/functions/oci-field-type.xml Tue Sep 6 16:18:29 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> +<!-- $Revision: 1.5 $ --> <refentry id="function.oci-field-type"> <refnamediv> <refname>oci_field_type</refname> http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/oci-internal-debug.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc/en/reference/oci8/functions/oci-internal-debug.xml diff -u phpdoc/en/reference/oci8/functions/oci-internal-debug.xml:1.4 phpdoc/en/reference/oci8/functions/oci-internal-debug.xml:1.5 --- phpdoc/en/reference/oci8/functions/oci-internal-debug.xml:1.4 Thu Apr 1 03:11:27 2004 +++ phpdoc/en/reference/oci8/functions/oci-internal-debug.xml Tue Sep 6 16:18:29 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> +<!-- $Revision: 1.5 $ --> <refentry id="function.oci-internal-debug"> <refnamediv> <refname>oci_internal_debug</refname> http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/oci-lob-copy.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc/en/reference/oci8/functions/oci-lob-copy.xml diff -u phpdoc/en/reference/oci8/functions/oci-lob-copy.xml:1.4 phpdoc/en/reference/oci8/functions/oci-lob-copy.xml:1.5 --- phpdoc/en/reference/oci8/functions/oci-lob-copy.xml:1.4 Fri Nov 12 06:02:29 2004 +++ phpdoc/en/reference/oci8/functions/oci-lob-copy.xml Tue Sep 6 16:18:29 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> +<!-- $Revision: 1.5 $ --> <refentry id="function.oci-lob-copy"> <refnamediv> <refname>oci_lob_copy</refname> @@ -14,14 +14,13 @@ <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam> </methodsynopsis> <para> - Copies large object or a part of large object to another large object. + Copies a large object or a part of a large object to another large object. Parameter <parameter>length</parameter> indicates the length of data to - be copied. Old data of LOB-recipient will be overwritten. + be copied. Old LOB-recipient data will be overwritten. </para> <para> - If you need to copy a particular part of LOB to a particular position of - LOB, you can use <function>oci_lob_seek</function> to move internal - pointers of LOBs. + If you need to copy a particular part of a LOB to a particular position of + a LOB, use <function>oci_lob_seek</function> to move LOB internal pointers. </para> <para> &return.success; @@ -50,3 +49,4 @@ vi: ts=1 sw=1 --> + http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/oci-new-collection.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc/en/reference/oci8/functions/oci-new-collection.xml diff -u phpdoc/en/reference/oci8/functions/oci-new-collection.xml:1.4 phpdoc/en/reference/oci8/functions/oci-new-collection.xml:1.5 --- phpdoc/en/reference/oci8/functions/oci-new-collection.xml:1.4 Fri Nov 12 06:02:29 2004 +++ phpdoc/en/reference/oci8/functions/oci-new-collection.xml Tue Sep 6 16:18:29 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> +<!-- $Revision: 1.5 $ --> <refentry id="function.oci-new-collection"> <refnamediv> <refname>oci_new_collection</refname> @@ -14,11 +14,11 @@ <methodparam choice="opt"><type>string</type><parameter>schema</parameter></methodparam> </methodsynopsis> <para> - Allocates new collection object. Parameter <parameter>tdo</parameter> - should be a valid named type (uppercased). Third, optional parameter + Allocates a new collection object. Parameter <parameter>tdo</parameter> + should be a valid named type (uppercase). The third, optional parameter <parameter>schema</parameter> should point to the scheme, where the named type was created. <function>oci_new_collection</function> uses - name of the current user as default value of <parameter>schema</parameter>. + the name of the current user as the default value of <parameter>schema</parameter>. </para> <para> <function>oci_new_collection</function> returns &false; on error. @@ -54,3 +54,4 @@ vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> + http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/oci-new-connect.xml?r1=1.5&r2=1.6&ty=u Index: phpdoc/en/reference/oci8/functions/oci-new-connect.xml diff -u phpdoc/en/reference/oci8/functions/oci-new-connect.xml:1.5 phpdoc/en/reference/oci8/functions/oci-new-connect.xml:1.6 --- phpdoc/en/reference/oci8/functions/oci-new-connect.xml:1.5 Thu Jul 8 06:05:05 2004 +++ phpdoc/en/reference/oci8/functions/oci-new-connect.xml Tue Sep 6 16:18:29 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> +<!-- $Revision: 1.6 $ --> <refentry id="function.oci-new-connect"> <refnamediv> <refname>oci_new_connect</refname> @@ -13,24 +13,50 @@ <methodparam><type>string</type><parameter>password</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>db</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>charset</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>session_mode</parameter></methodparam> </methodsynopsis> <para> - <function>oci_new_connect</function> creates a new connection to an Oracle - server and logs on. The optional third parameter can either contain the name + <function>oci_new_connect</function> establishes a new connection to + an Oracle server and logs on. Unlike <function>oci_connect</function> and + <function>oci_pconnect</function>, <function>oci_new_connect</function> + does not cache connections and will always return a brand-new freshly + opened connection handle. This is useful if your application needs + transactional isolation between two sets of queries. + </para> + <para> + The optional third parameter can either contain the name of the local Oracle instance or the name of the entry in <filename>tnsnames.ora</filename>. If the third parameter is not specified, PHP uses environment variables <literal>ORACLE_SID</literal> and <literal>TWO_TASK</literal> to determine the name of local Oracle instance and location of <filename>tnsnames.ora</filename> accordingly. </para> - &oci.charset; <para> - <function>oci_new_connect</function> forces the creation of a new connection. - This should be used if you need to isolate a set of transactions. By - default, connections are shared and subsequent calls to - <function>oci_connect</function> will return the same connection - identifier. + Parameter <parameter>session_mode</parameter> is available since version + 1.1 and accepts the following values: <constant>OCI_DEFAULT</constant>, + <constant>OCI_SYSOPER</constant> and <constant>OCI_SYSDBA</constant>. + If either <constant>OCI_SYSOPER</constant> or + <constant>OCI_SYSDBA</constant> were specified, + <function>oci_new_connect</function> will try to establish privileged + connection using external credentials. Privileged connections are + disabled by default. To enable them you need to set <link + linkend="ini.oci8.privileged_connect">oci8.privileged_connect</link> + to On. </para> + <note> + <simpara> + If you're using PHP with Oracle Instant Client, you can use easy connect + naming method described here: + <ulink + url="http://download-west.oracle.com/docs/cd/B12037_01/network.101/b10775/naming.htm#i498306"> + http://download-west.oracle.com/docs/cd/B12037_01/network.101/b10775/naming.htm#i498306</ulink>. + Basically this means you can specify "//db_host[:port]/database_name" + as database name. But if you want to use the old way of naming you + <emphasis>must</emphasis> set either <constant>ORACLE_HOME</constant> or + <constant>TNS_ADMIN</constant>. + </simpara> + </note> + &oci.charset; <para> The following demonstrates how you can separate connections. <example> http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/oci-new-cursor.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc/en/reference/oci8/functions/oci-new-cursor.xml diff -u phpdoc/en/reference/oci8/functions/oci-new-cursor.xml:1.4 phpdoc/en/reference/oci8/functions/oci-new-cursor.xml:1.5 --- phpdoc/en/reference/oci8/functions/oci-new-cursor.xml:1.4 Wed Jun 9 02:22:18 2004 +++ phpdoc/en/reference/oci8/functions/oci-new-cursor.xml Tue Sep 6 16:18:29 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> +<!-- $Revision: 1.5 $ --> <refentry id="function.oci-new-cursor"> <refnamediv> <refname>oci_new_cursor</refname> http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/oci-new-descriptor.xml?r1=1.6&r2=1.7&ty=u Index: phpdoc/en/reference/oci8/functions/oci-new-descriptor.xml diff -u phpdoc/en/reference/oci8/functions/oci-new-descriptor.xml:1.6 phpdoc/en/reference/oci8/functions/oci-new-descriptor.xml:1.7 --- phpdoc/en/reference/oci8/functions/oci-new-descriptor.xml:1.6 Mon Jan 3 05:23:28 2005 +++ phpdoc/en/reference/oci8/functions/oci-new-descriptor.xml Tue Sep 6 16:18:29 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> +<!-- $Revision: 1.7 $ --> <refentry id="function.oci-new-descriptor"> <refnamediv> <refname>oci_new_descriptor</refname> http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/oci-num-rows.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc/en/reference/oci8/functions/oci-num-rows.xml diff -u phpdoc/en/reference/oci8/functions/oci-num-rows.xml:1.3 phpdoc/en/reference/oci8/functions/oci-num-rows.xml:1.4 --- phpdoc/en/reference/oci8/functions/oci-num-rows.xml:1.3 Thu Apr 1 03:11:28 2004 +++ phpdoc/en/reference/oci8/functions/oci-num-rows.xml Tue Sep 6 16:18:29 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <refentry id="function.oci-num-rows"> <refnamediv> <refname>oci_num_rows</refname> http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/oci-parse.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc/en/reference/oci8/functions/oci-parse.xml diff -u phpdoc/en/reference/oci8/functions/oci-parse.xml:1.3 phpdoc/en/reference/oci8/functions/oci-parse.xml:1.4 --- phpdoc/en/reference/oci8/functions/oci-parse.xml:1.3 Thu Apr 1 03:11:28 2004 +++ phpdoc/en/reference/oci8/functions/oci-parse.xml Tue Sep 6 16:18:29 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <refentry id="function.oci-parse"> <refnamediv> <refname>oci_parse</refname> http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/oci-password-change.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc/en/reference/oci8/functions/oci-password-change.xml diff -u phpdoc/en/reference/oci8/functions/oci-password-change.xml:1.4 phpdoc/en/reference/oci8/functions/oci-password-change.xml:1.5 --- phpdoc/en/reference/oci8/functions/oci-password-change.xml:1.4 Thu Apr 1 03:11:29 2004 +++ phpdoc/en/reference/oci8/functions/oci-password-change.xml Tue Sep 6 16:18:29 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> +<!-- $Revision: 1.5 $ --> <refentry id="function.oci-password-change"> <refnamediv> <refname>oci_password_change</refname> @@ -14,12 +14,25 @@ <methodparam><type>string</type><parameter>old_password</parameter></methodparam> <methodparam><type>string</type><parameter>new_password</parameter></methodparam> </methodsynopsis> + <methodsynopsis> + <type>resource</type><methodname>oci_password_change</methodname> + <methodparam><type>string</type><parameter>dbname</parameter></methodparam> + <methodparam><type>string</type><parameter>username</parameter></methodparam> + <methodparam><type>string</type><parameter>old_password</parameter></methodparam> + <methodparam><type>string</type><parameter>new_password</parameter></methodparam> + </methodsynopsis> <para> Changes password for user with <parameter>username</parameter>. Parameters <parameter>old_password</parameter> and <parameter>new_password</parameter> should indicate old and new passwords respectively. </para> + <note> + <simpara> + The second <function>oci_password_change</function> syntax is available + since version 1.1. + </simpara> + </note> <para> &return.success; </para> http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/oci-pconnect.xml?r1=1.6&r2=1.7&ty=u Index: phpdoc/en/reference/oci8/functions/oci-pconnect.xml diff -u phpdoc/en/reference/oci8/functions/oci-pconnect.xml:1.6 phpdoc/en/reference/oci8/functions/oci-pconnect.xml:1.7 --- phpdoc/en/reference/oci8/functions/oci-pconnect.xml:1.6 Thu Jul 8 06:05:05 2004 +++ phpdoc/en/reference/oci8/functions/oci-pconnect.xml Tue Sep 6 16:18:29 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> +<!-- $Revision: 1.7 $ --> <refentry id="function.oci-pconnect"> <refnamediv> <refname>oci_pconnect</refname> @@ -13,16 +13,61 @@ <methodparam><type>string</type><parameter>password</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>db</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>charset</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>session_mode</parameter></methodparam> </methodsynopsis> <para> - <function>oci_pconnect</function> creates a new persistent connection to - an Oracle server and logs on. The optional third parameter can either contain + <function>oci_pconnect</function> creates a persistent connection + to an Oracle server and logs on. Persistent connections are cached + and re-used between requests, resulting in reduced overhead on each + page load; a typical PHP application will have a single persistent + connection open against an Oracle server per Apache child process + (or PHP FastCGI/CGI process). See the <link + linkend="features.persistent-connections">Persistent Database + Connections</link> section for more information. + </para> + <note> + <simpara> + Starting with version 1.1 of the oci8 extension, the lifetime and + maximum amount of persistent Oracle connections can be tuned by setting + the following configuration values: <link + linkend="ini.oci8.persistent_timeout">oci8.persistent_timeout</link>, + <link linkend="ini.oci8.ping_interval">oci8.ping_interval</link> and + <link linkend="ini.oci8.max_persistent">oci8.max_persistent</link>. + </simpara> + </note> + <para> + The optional third parameter can either contain the name of the local Oracle instance or the name of the entry in <filename>tnsnames.ora</filename>. If the third parameter is not specified, PHP uses environment variables <literal>ORACLE_SID</literal> and <literal>TWO_TASK</literal> to determine the name of local Oracle instance and location of <filename>tnsnames.ora</filename> accordingly. </para> + <para> + Parameter <parameter>session_mode</parameter> is available since version + 1.1 and accepts the following values: <constant>OCI_DEFAULT</constant>, + <constant>OCI_SYSOPER</constant> and <constant>OCI_SYSDBA</constant>. + If either <constant>OCI_SYSOPER</constant> or + <constant>OCI_SYSDBA</constant> were specified, + <function>oci_connect</function> will try to establish privileged + connection using external credentials. Privileged connections are + disabled by default. To enable them you need to set <link + linkend="ini.oci8.privileged_connect">oci8.privileged_connect</link> + to On. + </para> + <note> + <simpara> + If you're using PHP with Oracle Instant Client, you can use easy connect + naming method described here: + <ulink + url="http://download-west.oracle.com/docs/cd/B12037_01/network.101/b10775/naming.htm#i498306"> + http://download-west.oracle.com/docs/cd/B12037_01/network.101/b10775/naming.htm#i498306</ulink>. + Basically this means you can specify "//db_host[:port]/database_name" + as database name. But if you want to use the old way of naming you + <emphasis>must</emphasis> set either <constant>ORACLE_HOME</constant> or + <constant>TNS_ADMIN</constant>. + </simpara> + </note> &oci.charset; <para> <function>oci_pconnect</function> returns connection identifier or @@ -30,14 +75,6 @@ </para> <note> <para> - Note, that these kind of links only work if you are using - a module version of PHP. See the - <link linkend="features.persistent-connections">Persistent - Database Connections</link> section for more information. - </para> - </note> - <note> - <para> In PHP versions before 5.0.0 you must use <function>ociplogon</function> instead. This name still can be used, it was left as alias of <function>oci_pconnect</function> for downwards compatability. http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/oci-rollback.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc/en/reference/oci8/functions/oci-rollback.xml diff -u phpdoc/en/reference/oci8/functions/oci-rollback.xml:1.2 phpdoc/en/reference/oci8/functions/oci-rollback.xml:1.3 --- phpdoc/en/reference/oci8/functions/oci-rollback.xml:1.2 Thu Apr 1 03:11:29 2004 +++ phpdoc/en/reference/oci8/functions/oci-rollback.xml Tue Sep 6 16:18:29 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <refentry id="function.oci-rollback"> <refnamediv> <refname>oci_rollback</refname> @@ -20,6 +20,14 @@ </para> <note> <para> + Transactions are automatically rolled back when you close + the connection, or when the script ends, whichever is soonest. You + need to explicitly call <function>oci_commit</function> to commit + the transaction, or <function>oci_rollback</function> to abort it. + </para> + </note> + <note> + <para> In PHP versions before 5.0.0 you must use <function>ocirollback</function> instead. This name still can be used, it was left as alias of <function>oci_rollback</function> for downwards compatability. http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/oci-server-version.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc/en/reference/oci8/functions/oci-server-version.xml diff -u phpdoc/en/reference/oci8/functions/oci-server-version.xml:1.3 phpdoc/en/reference/oci8/functions/oci-server-version.xml:1.4 --- phpdoc/en/reference/oci8/functions/oci-server-version.xml:1.3 Thu Apr 1 03:11:29 2004 +++ phpdoc/en/reference/oci8/functions/oci-server-version.xml Tue Sep 6 16:18:29 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <refentry id="function.oci-server-version"> <refnamediv> <refname>oci_server_version</refname> http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/oci-set-prefetch.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc/en/reference/oci8/functions/oci-set-prefetch.xml diff -u phpdoc/en/reference/oci8/functions/oci-set-prefetch.xml:1.3 phpdoc/en/reference/oci8/functions/oci-set-prefetch.xml:1.4 --- phpdoc/en/reference/oci8/functions/oci-set-prefetch.xml:1.3 Thu Apr 1 03:11:29 2004 +++ phpdoc/en/reference/oci8/functions/oci-set-prefetch.xml Tue Sep 6 16:18:29 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <refentry id="function.oci-set-prefetch"> <refnamediv> <refname>oci_set_prefetch</refname> @@ -28,6 +28,11 @@ <para> &return.success; </para> + <simpara> + See also <link + linkend="ini.oci8.default_prefetch">oci8_.default_prefetch</link> + ini option. + </simpara> </refsect1> </refentry> http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/oci-statement-type.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc/en/reference/oci8/functions/oci-statement-type.xml diff -u phpdoc/en/reference/oci8/functions/oci-statement-type.xml:1.3 phpdoc/en/reference/oci8/functions/oci-statement-type.xml:1.4 --- phpdoc/en/reference/oci8/functions/oci-statement-type.xml:1.3 Thu Apr 1 03:11:29 2004 +++ phpdoc/en/reference/oci8/functions/oci-statement-type.xml Tue Sep 6 16:18:29 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <refentry id="function.oci-statement-type"> <refnamediv> <refname>oci_statement_type</refname> http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/ocibindbyname.xml?r1=1.17&r2=1.18&ty=u Index: phpdoc/en/reference/oci8/functions/ocibindbyname.xml diff -u phpdoc/en/reference/oci8/functions/ocibindbyname.xml:1.17 phpdoc/en/reference/oci8/functions/ocibindbyname.xml:1.18 --- phpdoc/en/reference/oci8/functions/ocibindbyname.xml:1.17 Fri Jul 1 09:07:49 2005 +++ phpdoc/en/reference/oci8/functions/ocibindbyname.xml Tue Sep 6 16:18:29 2005 @@ -1,131 +1,19 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.17 $ --> -<!-- - -DO NOT TRANSLATE THIS FILE. -THE FUNCTION IT DESCRIBES WAS RENAMED AND THIS NAME IS DEPRECATED. -PLEASE, TRANSLATE THE APPROPRIATE NEW FILE. - ---> -<!-- splitted from ./en/functions/oci8.xml, last change in rev 1.2 --> - <refentry id="function.ocibindbyname"> - <refnamediv> - <refname>ocibindbyname</refname> - <refpurpose> - Bind a PHP variable to an Oracle Placeholder - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>ocibindbyname</methodname> - <methodparam><type>resource</type><parameter>stmt</parameter></methodparam> - <methodparam><type>string</type><parameter>ph_name</parameter></methodparam> - <methodparam><type>mixed</type><parameter role="reference">variable</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>maxlength</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>type</parameter></methodparam> - </methodsynopsis> - <para> - <function>ocibindbyname</function> binds the PHP variable - <parameter>variable</parameter> to the Oracle placeholder - <parameter>ph_name</parameter>. Whether it will be used for - input or output will be determined run-time, and the necessary - storage space will be allocated. The - <parameter>length</parameter> parameter sets the maximum length - for the bind. If you set <parameter>length</parameter> to -1 - <function>ocibindbyname</function> will use the current length of - <parameter>variable</parameter> to set the maximum length. - </para> - <para> - If you need to bind an abstract Datatype (LOB/ROWID/BFILE) you - need to allocate it first using - <function>ocinewdescriptor</function> function. The - <parameter>length</parameter> is not used for abstract Datatypes - and should be set to -1. The <parameter>type</parameter> variable - tells oracle, what kind of descriptor we want to use. Possible - values are: OCI_B_FILE (Binary-File), OCI_B_CFILE - (Character-File), OCI_B_CLOB (Character-LOB), OCI_B_BLOB - (Binary-LOB) and OCI_B_ROWID (ROWID). - </para> - <para> - <example> - <title><function>ocibindbyname</function> example</title> - <programlisting role="php"> -<![CDATA[ -<?php -/* OCIBindByPos example thies at thieso dot net (980221) - inserts 3 records into emp, and uses the ROWID for updating the - records just after the insert. -*/ - -$conn = OCILogon("scott", "tiger"); - -$stmt = OCIParse($conn, "insert into emp (empno, ename) " . - "values (:empno,:ename) " . - "returning ROWID into :rid"); - -$data = array(1111 => "Larry", 2222 => "Bill", 3333 => "Jim"); - -$rowid = OCINewDescriptor($conn, OCI_D_ROWID); - -OCIBindByName($stmt, ":empno", $empno, 32); -OCIBindByName($stmt, ":ename", $ename, 32); -OCIBindByName($stmt, ":rid", $rowid, -1, OCI_B_ROWID); - -$update = OCIParse($conn, "update emp set sal = :sal where ROWID = :rid"); -OCIBindByName($update, ":rid", $rowid, -1, OCI_B_ROWID); -OCIBindByName($update, ":sal", $sal, 32); - -$sal = 10000; - -foreach ($data as $empno => $ename) { - OCIExecute($stmt); - OCIExecute($update); -} - -$rowid->free(); - -OCIFreeStatement($update); -OCIFreeStatement($stmt); - -$stmt = OCIParse($conn, "select * from emp where empno in (1111,2222,3333)"); -OCIExecute($stmt); -while (OCIFetchInto($stmt, &$arr, OCI_ASSOC)) { - var_dump($arr); -} -OCIFreeStatement($stmt); - -/* delete our "junk" from the emp table.... */ -$stmt = OCIParse($conn, "delete from emp where empno in (1111,2222,3333)"); -OCIExecute($stmt); -OCIFreeStatement($stmt); - -OCILogoff($conn); -?> -]]> - </programlisting> - </example> - </para> - <note> - <para> - This function was renamed to <function>oci_bind_by_name</function> - after PHP >= 5.0.0. For downward compatibility - <function>ocibindbyname</function> can also be used. - This is deprecated, however. - </para> - </note> - <warning> - <para> - It is a bad idea to use magic quotes and - <function>ocibindbyname</function> simultaneously as no quoting - is needed on quoted variables and any quotes magically applied - will be written into your database as - <function>ocibindbyname</function> is not able to distinguish - magically added quotings from those added by intention. - </para> - </warning> - </refsect1> - </refentry> +<!-- $Revision: 1.18 $ --> +<refentry id="function.ocibindbyname"> + <refnamediv> + <refname>ocibindbyname</refname> + <refpurpose>&Alias; <function>oci_bind_by_name</function></refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <simpara> + &info.function.alias; + <function>oci_bind_by_name</function>. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/ocicancel.xml?r1=1.9&r2=1.10&ty=u Index: phpdoc/en/reference/oci8/functions/ocicancel.xml diff -u phpdoc/en/reference/oci8/functions/ocicancel.xml:1.9 phpdoc/en/reference/oci8/functions/ocicancel.xml:1.10 --- phpdoc/en/reference/oci8/functions/ocicancel.xml:1.9 Thu Apr 15 07:54:41 2004 +++ phpdoc/en/reference/oci8/functions/ocicancel.xml Tue Sep 6 16:18:29 2005 @@ -1,38 +1,20 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- -DO NOT TRANSLATE THIS FILE. -THE FUNCTION IT DESCRIBES WAS RENAMED AND THIS NAME IS DEPRECATED. -PLEASE, TRANSLATE THE APPROPRIATE NEW FILE. +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.10 $ --> +<refentry id="function.ocicancel"> + <refnamediv> + <refname>ocicancel</refname> + <refpurpose>&Alias; <function>oci_cancel</function></refpurpose> + </refnamediv> ---> -<!-- splitted from ./en/functions/oci8.xml, last change in rev 1.28 --> - <refentry id="function.ocicancel"> - <refnamediv> - <refname>ocicancel</refname> - <refpurpose>Cancel reading from cursor</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>ocicancel</methodname> - <methodparam><type>resource</type><parameter>stmt</parameter></methodparam> - </methodsynopsis> - <para> - If you do not want read more data from a cursor, then call - <function>ocicancel</function>. - </para> - <note> - <para> - This function was renamed to <function>oci_cancel</function> - after PHP >= 5.0.0. For downward compatibility - <function>ocicancel</function> can also be used. - This is deprecated, however. - </para> - </note> - </refsect1> - </refentry> + <refsect1 role="description"> + &reftitle.description; + <simpara> + &info.function.alias; + <function>oci_cancel</function>. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/ocicloselob.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc/en/reference/oci8/functions/ocicloselob.xml diff -u phpdoc/en/reference/oci8/functions/ocicloselob.xml:1.4 phpdoc/en/reference/oci8/functions/ocicloselob.xml:1.5 --- phpdoc/en/reference/oci8/functions/ocicloselob.xml:1.4 Thu Apr 15 07:54:41 2004 +++ phpdoc/en/reference/oci8/functions/ocicloselob.xml Tue Sep 6 16:18:29 2005 @@ -1,34 +1,20 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- -DO NOT TRANSLATE THIS FILE. -THE FUNCTION IT DESCRIBES WAS RENAMED AND THIS NAME IS DEPRECATED. -PLEASE, TRANSLATE THE APPROPRIATE NEW FILE. +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.5 $ --> +<refentry id="function.ocicloselob"> + <refnamediv> + <refname>ocicloselob</refname> + <refpurpose>&Alias; <xref linkend="function.oci-lob-close" /></refpurpose> + </refnamediv> ---> -<!-- splitted from ./en/functions/oci8.xml, last change in rev 1.23 --> - <refentry id="function.ocicloselob"> - <refnamediv> - <refname>ocicloselob</refname> - <refpurpose>Closes lob descriptor</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>ocicloselob</methodname> - <void /> - </methodsynopsis> - <note> - <para> - This function was renamed to <function>oci_lob_close</function> - after PHP >= 5.0.0. For downward compatibility - <function>ocicloselob</function> can also be used. - This is deprecated, however. - </para> - </note> - </refsect1> - </refentry> + <refsect1 role="description"> + &reftitle.description; + <simpara> + &info.function.alias; + <xref linkend="function.oci-lob-close" />. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/ocicollappend.xml?r1=1.9&r2=1.10&ty=u Index: phpdoc/en/reference/oci8/functions/ocicollappend.xml diff -u phpdoc/en/reference/oci8/functions/ocicollappend.xml:1.9 phpdoc/en/reference/oci8/functions/ocicollappend.xml:1.10 --- phpdoc/en/reference/oci8/functions/ocicollappend.xml:1.9 Thu Apr 15 07:54:41 2004 +++ phpdoc/en/reference/oci8/functions/ocicollappend.xml Tue Sep 6 16:18:29 2005 @@ -1,34 +1,20 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- -DO NOT TRANSLATE THIS FILE. -THE FUNCTION IT DESCRIBES WAS RENAMED AND THIS NAME IS DEPRECATED. -PLEASE, TRANSLATE THE APPROPRIATE NEW FILE. +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.10 $ --> +<refentry id="function.ocicollappend"> + <refnamediv> + <refname>ocicollappend</refname> + <refpurpose>&Alias; <xref linkend="function.oci-collection-append" /></refpurpose> + </refnamediv> ---> -<!-- splitted from ./en/functions/oci8.xml, last change in rev 1.23 --> - <refentry id="function.ocicollappend"> - <refnamediv> - <refname>ocicollappend</refname> - <refpurpose>Append an object to the collection</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>ocicollappend</methodname> - <methodparam><type>string</type><parameter>value</parameter></methodparam> - </methodsynopsis> - <note> - <para> - This function was renamed to <function>oci_collection_append</function> - after PHP >= 5.0.0. For downward compatibility - <function>ocicollappend</function> can also be used. - This is deprecated, however. - </para> - </note> - </refsect1> - </refentry> + <refsect1 role="description"> + &reftitle.description; + <simpara> + &info.function.alias; + <xref linkend="function.oci-collection-append" />. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/ocicollassign.xml?r1=1.10&r2=1.11&ty=u Index: phpdoc/en/reference/oci8/functions/ocicollassign.xml diff -u phpdoc/en/reference/oci8/functions/ocicollassign.xml:1.10 phpdoc/en/reference/oci8/functions/ocicollassign.xml:1.11 --- phpdoc/en/reference/oci8/functions/ocicollassign.xml:1.10 Fri Nov 12 06:02:29 2004 +++ phpdoc/en/reference/oci8/functions/ocicollassign.xml Tue Sep 6 16:18:29 2005 @@ -1,34 +1,20 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- -DO NOT TRANSLATE THIS FILE. -THE FUNCTION IT DESCRIBES WAS RENAMED AND THIS NAME IS DEPRECATED. -PLEASE, TRANSLATE THE APPROPRIATE NEW FILE. +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.11 $ --> +<refentry id="function.ocicollassign"> + <refnamediv> + <refname>ocicollassign</refname> + <refpurpose>&Alias; <xref linkend="function.oci-collection-assign" /></refpurpose> + </refnamediv> ---> -<!-- splitted from ./en/functions/oci8.xml, last change in rev 1.39 --> - <refentry id="function.ocicollassign"> - <refnamediv> - <refname>ocicollassign</refname> - <refpurpose>Assign a collection from another existing collection</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>ocicollassign</methodname> - <methodparam><type>OCI-Collection</type><parameter>from</parameter></methodparam> - </methodsynopsis> - <note> - <para> - This function was renamed to <function>oci_collection_assign</function> - after PHP >= 5.0.0. For downward compatibility - <function>ocicollassign</function> can also be used. - This is deprecated, however. - </para> - </note> - </refsect1> - </refentry> + <refsect1 role="description"> + &reftitle.description; + <simpara> + &info.function.alias; + <xref linkend="function.oci-collection-assign" />. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/ocicollassignelem.xml?r1=1.9&r2=1.10&ty=u Index: phpdoc/en/reference/oci8/functions/ocicollassignelem.xml diff -u phpdoc/en/reference/oci8/functions/ocicollassignelem.xml:1.9 phpdoc/en/reference/oci8/functions/ocicollassignelem.xml:1.10 --- phpdoc/en/reference/oci8/functions/ocicollassignelem.xml:1.9 Thu Apr 15 07:54:41 2004 +++ phpdoc/en/reference/oci8/functions/ocicollassignelem.xml Tue Sep 6 16:18:29 2005 @@ -1,35 +1,20 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- -DO NOT TRANSLATE THIS FILE. -THE FUNCTION IT DESCRIBES WAS RENAMED AND THIS NAME IS DEPRECATED. -PLEASE, TRANSLATE THE APPROPRIATE NEW FILE. +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.10 $ --> +<refentry id="function.ocicollassignelem"> + <refnamediv> + <refname>ocicollassignelem</refname> + <refpurpose>&Alias; <xref linkend="function.oci-collection-element-assign" /></refpurpose> + </refnamediv> ---> -<!-- splitted from ./en/functions/oci8.xml, last change in rev 1.23 --> - <refentry id="function.ocicollassignelem"> - <refnamediv> - <refname>ocicollassignelem</refname> - <refpurpose>Assign element val to collection at index ndx</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>ocicollassignelem</methodname> - <methodparam><type>int</type><parameter>ndx</parameter></methodparam> - <methodparam><type>string</type><parameter>val</parameter></methodparam> - </methodsynopsis> - <note> - <para> - This function was renamed to <function>oci_collection_element_assign</function> - after PHP >= 5.0.0. For downward compatibility - <function>ocicollassignelem</function> can also be used. - This is deprecated, however. - </para> - </note> - </refsect1> - </refentry> + <refsect1 role="description"> + &reftitle.description; + <simpara> + &info.function.alias; + <xref linkend="function.oci-collection-element-assign" />. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/ocicollgetelem.xml?r1=1.8&r2=1.9&ty=u Index: phpdoc/en/reference/oci8/functions/ocicollgetelem.xml diff -u phpdoc/en/reference/oci8/functions/ocicollgetelem.xml:1.8 phpdoc/en/reference/oci8/functions/ocicollgetelem.xml:1.9 --- phpdoc/en/reference/oci8/functions/ocicollgetelem.xml:1.8 Thu Apr 15 07:54:41 2004 +++ phpdoc/en/reference/oci8/functions/ocicollgetelem.xml Tue Sep 6 16:18:29 2005 @@ -1,34 +1,20 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- -DO NOT TRANSLATE THIS FILE. -THE FUNCTION IT DESCRIBES WAS RENAMED AND THIS NAME IS DEPRECATED. -PLEASE, TRANSLATE THE APPROPRIATE NEW FILE. +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.9 $ --> +<refentry id="function.ocicollgetelem"> + <refnamediv> + <refname>ocicollgetelem</refname> + <refpurpose>&Alias; <xref linkend="function.oci-collection-element-get" /></refpurpose> + </refnamediv> ---> -<!-- splitted from ./en/functions/oci8.xml, last change in rev 1.23 --> - <refentry id="function.ocicollgetelem"> - <refnamediv> - <refname>ocicollgetelem</refname> - <refpurpose>Retrieve the value at collection index ndx</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>string</type><methodname>ocicollgetelem</methodname> - <methodparam><type>int</type><parameter>ndx</parameter></methodparam> - </methodsynopsis> - <note> - <para> - This function was renamed to <function>oci_collection_element_get</function> - after PHP >= 5.0.0. For downward compatibility - <function>ocicollgetelem</function> can also be used. - This is deprecated, however. - </para> - </note> - </refsect1> - </refentry> + <refsect1 role="description"> + &reftitle.description; + <simpara> + &info.function.alias; + <xref linkend="function.oci-collection-element-get" />. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/ocicollmax.xml?r1=1.10&r2=1.11&ty=u Index: phpdoc/en/reference/oci8/functions/ocicollmax.xml diff -u phpdoc/en/reference/oci8/functions/ocicollmax.xml:1.10 phpdoc/en/reference/oci8/functions/ocicollmax.xml:1.11 --- phpdoc/en/reference/oci8/functions/ocicollmax.xml:1.10 Fri Aug 20 05:47:38 2004 +++ phpdoc/en/reference/oci8/functions/ocicollmax.xml Tue Sep 6 16:18:29 2005 @@ -1,34 +1,20 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- -DO NOT TRANSLATE THIS FILE. -THE FUNCTION IT DESCRIBES WAS RENAMED AND THIS NAME IS DEPRECATED. -PLEASE, TRANSLATE THE APPROPRIATE NEW FILE. +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.11 $ --> +<refentry id="function.ocicollmax"> + <refnamediv> + <refname>ocicollmax</refname> + <refpurpose>&Alias; <xref linkend="function.oci-collection-max" /></refpurpose> + </refnamediv> ---> -<!-- splitted from ./en/functions/oci8.xml, last change in rev 1.23 --> - <refentry id="function.ocicollmax"> - <refnamediv> - <refname>ocicollmax</refname> - <refpurpose>Gets the maximum number of elements in the collection</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>ocicollmax</methodname> - <void /> - </methodsynopsis> - <note> - <para> - This function was renamed to <function>oci_collection_max</function> - after PHP >= 5.0.0. For downward compatibility - <function>ocicollmax</function> can also be used. - This is deprecated, however. - </para> - </note> - </refsect1> - </refentry> + <refsect1 role="description"> + &reftitle.description; + <simpara> + &info.function.alias; + <xref linkend="function.oci-collection-max" />. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/ocicollsize.xml?r1=1.9&r2=1.10&ty=u Index: phpdoc/en/reference/oci8/functions/ocicollsize.xml diff -u phpdoc/en/reference/oci8/functions/ocicollsize.xml:1.9 phpdoc/en/reference/oci8/functions/ocicollsize.xml:1.10 --- phpdoc/en/reference/oci8/functions/ocicollsize.xml:1.9 Thu Apr 15 07:54:41 2004 +++ phpdoc/en/reference/oci8/functions/ocicollsize.xml Tue Sep 6 16:18:29 2005 @@ -1,34 +1,20 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- -DO NOT TRANSLATE THIS FILE. -THE FUNCTION IT DESCRIBES WAS RENAMED AND THIS NAME IS DEPRECATED. -PLEASE, TRANSLATE THE APPROPRIATE NEW FILE. +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.10 $ --> +<refentry id="function.ocicollsize"> + <refnamediv> + <refname>ocicollsize</refname> + <refpurpose>&Alias; <xref linkend="function.oci-collection-size" /></refpurpose> + </refnamediv> ---> -<!-- splitted from ./en/functions/oci8.xml, last change in rev 1.23 --> - <refentry id="function.ocicollsize"> - <refnamediv> - <refname>ocicollsize</refname> - <refpurpose>Return the size of a collection</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>ocicollsize</methodname> - <void /> - </methodsynopsis> - <note> - <para> - This function was renamed to <function>oci_collection_size</function> - after PHP >= 5.0.0. For downward compatibility - <function>ocicollsize</function> can also be used. - This is deprecated, however. - </para> - </note> - </refsect1> - </refentry> + <refsect1 role="description"> + &reftitle.description; + <simpara> + &info.function.alias; + <xref linkend="function.oci-collection-size" />. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/ocicolltrim.xml?r1=1.9&r2=1.10&ty=u Index: phpdoc/en/reference/oci8/functions/ocicolltrim.xml diff -u phpdoc/en/reference/oci8/functions/ocicolltrim.xml:1.9 phpdoc/en/reference/oci8/functions/ocicolltrim.xml:1.10 --- phpdoc/en/reference/oci8/functions/ocicolltrim.xml:1.9 Thu Apr 15 07:54:41 2004 +++ phpdoc/en/reference/oci8/functions/ocicolltrim.xml Tue Sep 6 16:18:29 2005 @@ -1,34 +1,20 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- -DO NOT TRANSLATE THIS FILE. -THE FUNCTION IT DESCRIBES WAS RENAMED AND THIS NAME IS DEPRECATED. -PLEASE, TRANSLATE THE APPROPRIATE NEW FILE. +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.10 $ --> +<refentry id="function.ocicolltrim"> + <refnamediv> + <refname>ocicolltrim</refname> + <refpurpose>&Alias; <xref linkend="function.oci-collection-trim" /></refpurpose> + </refnamediv> ---> -<!-- splitted from ./en/functions/oci8.xml, last change in rev 1.23 --> - <refentry id="function.ocicolltrim"> - <refnamediv> - <refname>ocicolltrim</refname> - <refpurpose>Trim num elements from the end of a collection</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>ocicolltrim</methodname> - <methodparam><type>int</type><parameter>num</parameter></methodparam> - </methodsynopsis> - <note> - <para> - This function was renamed to <function>oci_collection_trim</function> - after PHP >= 5.0.0. For downward compatibility - <function>ocicolltrim</function> can also be used. - This is deprecated, however. - </para> - </note> - </refsect1> - </refentry> + <refsect1 role="description"> + &reftitle.description; + <simpara> + &info.function.alias; + <xref linkend="function.oci-collection-trim" />. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/ocicolumnisnull.xml?r1=1.9&r2=1.10&ty=u Index: phpdoc/en/reference/oci8/functions/ocicolumnisnull.xml diff -u phpdoc/en/reference/oci8/functions/ocicolumnisnull.xml:1.9 phpdoc/en/reference/oci8/functions/ocicolumnisnull.xml:1.10 --- phpdoc/en/reference/oci8/functions/ocicolumnisnull.xml:1.9 Tue Aug 3 13:25:33 2004 +++ phpdoc/en/reference/oci8/functions/ocicolumnisnull.xml Tue Sep 6 16:18:29 2005 @@ -1,42 +1,20 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- -DO NOT TRANSLATE THIS FILE. -THE FUNCTION IT DESCRIBES WAS RENAMED AND THIS NAME IS DEPRECATED. -PLEASE, TRANSLATE THE APPROPRIATE NEW FILE. +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.10 $ --> +<refentry id="function.ocicolumnisnull"> + <refnamediv> + <refname>ocicolumnisnull</refname> + <refpurpose>&Alias; <function>oci_field_is_null</function></refpurpose> + </refnamediv> ---> -<!-- splitted from ./en/functions/oci8.xml, last change in rev 1.2 --> - <refentry id="function.ocicolumnisnull"> - <refnamediv> - <refname>ocicolumnisnull</refname> - <refpurpose>Test whether a result column is &null;</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>ocicolumnisnull</methodname> - <methodparam><type>resource</type><parameter>stmt</parameter></methodparam> - <methodparam><type>mixed</type><parameter>col</parameter></methodparam> - </methodsynopsis> - <para> - <function>ocicolumnisnull</function> returns &true; if the returned - column <parameter>column</parameter> in the result from the - statement <parameter>stmt</parameter> is &null;. You can either use - the column-number (1-Based) or the column-name, in uppercase, for the - <parameter>col</parameter> parameter. - </para> - <note> - <para> - This function was renamed to <function>oci_field_is_null</function> - after PHP >= 5.0.0. For downward compatibility - <function>ocicolumnisnull</function> can also be used. - This is deprecated, however. - </para> - </note> - </refsect1> - </refentry> + <refsect1 role="description"> + &reftitle.description; + <simpara> + &info.function.alias; + <function>oci_field_is_null</function>. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/ocicolumnname.xml?r1=1.9&r2=1.10&ty=u Index: phpdoc/en/reference/oci8/functions/ocicolumnname.xml diff -u phpdoc/en/reference/oci8/functions/ocicolumnname.xml:1.9 phpdoc/en/reference/oci8/functions/ocicolumnname.xml:1.10 --- phpdoc/en/reference/oci8/functions/ocicolumnname.xml:1.9 Thu Apr 15 07:54:41 2004 +++ phpdoc/en/reference/oci8/functions/ocicolumnname.xml Tue Sep 6 16:18:29 2005 @@ -1,73 +1,20 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- -DO NOT TRANSLATE THIS FILE. -THE FUNCTION IT DESCRIBES WAS RENAMED AND THIS NAME IS DEPRECATED. -PLEASE, TRANSLATE THE APPROPRIATE NEW FILE. +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.10 $ --> +<refentry id="function.ocicolumnname"> + <refnamediv> + <refname>ocicolumnname</refname> + <refpurpose>&Alias; <function>oci_field_name</function></refpurpose> + </refnamediv> ---> -<!-- splitted from ./en/functions/oci8.xml, last change in rev 1.15 --> - <refentry id="function.ocicolumnname"> - <refnamediv> - <refname>ocicolumnname</refname> - <refpurpose>Returns the name of a column</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>string</type><methodname>ocicolumnname</methodname> - <methodparam><type>resource</type><parameter>stmt</parameter></methodparam> - <methodparam><type>int</type><parameter>col</parameter></methodparam> - </methodsynopsis> - <simpara> - <function>ocicolumnname</function> returns the name of the column - corresponding to the column number (1-based) that is passed in. - </simpara> - <para> - <example> - <title><function>ocicolumnname</function> example</title> - <programlisting role="php"> -<![CDATA[ -<?php - $conn = OCILogon("scott", "tiger"); - $stmt = OCIParse($conn, "select * from emp"); - OCIExecute($stmt); - echo "<table border=\"1\">"; - echo "<tr>"; - echo "<th>Name</th>"; - echo "<th>Type</th>"; - echo "<th>Length</th>"; - echo "</tr>"; - $ncols = OCINumCols($stmt); - for ($i = 1; $i <= $ncols; $i++) { - $column_name = OCIColumnName($stmt, $i); - $column_type = OCIColumnType($stmt, $i); - $column_size = OCIColumnSize($stmt, $i); - echo "<tr>"; - echo "<td>$column_name</td>"; - echo "<td>$column_type</td>"; - echo "<td>$column_size</td>"; - echo "</tr>"; - } - echo "</table>\n"; - OCIFreeStatement($stmt); - OCILogoff($conn); -?> -]]> - </programlisting> - </example> - </para> - <note> - <para> - This function was renamed to <function>oci_field_name</function> - after PHP >= 5.0.0. For downward compatibility - <function>ocicolumnname</function> can also be used. - This is deprecated, however. - </para> - </note> - </refsect1> - </refentry> + <refsect1 role="description"> + &reftitle.description; + <simpara> + &info.function.alias; + <function>oci_field_name</function>. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/ocicolumnprecision.xml?r1=1.8&r2=1.9&ty=u Index: phpdoc/en/reference/oci8/functions/ocicolumnprecision.xml diff -u phpdoc/en/reference/oci8/functions/ocicolumnprecision.xml:1.8 phpdoc/en/reference/oci8/functions/ocicolumnprecision.xml:1.9 --- phpdoc/en/reference/oci8/functions/ocicolumnprecision.xml:1.8 Thu Apr 15 07:54:41 2004 +++ phpdoc/en/reference/oci8/functions/ocicolumnprecision.xml Tue Sep 6 16:18:29 2005 @@ -1,44 +1,20 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- -DO NOT TRANSLATE THIS FILE. -THE FUNCTION IT DESCRIBES WAS RENAMED AND THIS NAME IS DEPRECATED. -PLEASE, TRANSLATE THE APPROPRIATE NEW FILE. +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.9 $ --> +<refentry id="function.ocicolumnprecision"> + <refnamediv> + <refname>ocicolumnprecision</refname> + <refpurpose>&Alias; <function>oci_field_precision</function></refpurpose> + </refnamediv> ---> -<!-- splitted from ./en/functions/oci8.xml, last change in rev 1.23 --> - <refentry id="function.ocicolumnprecision"> - <refnamediv> - <refname>ocicolumnprecision</refname> - <refpurpose>Tell the precision of a column</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>ocicolumnprecision</methodname> - <methodparam><type>resource</type><parameter>stmt</parameter></methodparam> - <methodparam><type>int</type><parameter>col</parameter></methodparam> - </methodsynopsis> - <para> - Returns precision of the field with <parameter>col</parameter> index - (1-based). - </para> - <para> - For FLOAT columns precision is nonzero and scale is -127. - If precision is 0, then columnt is NUMBER. Else it's - NUMBER(precision, scale). - </para> - <note> - <para> - This function was renamed to <function>oci_field_precision</function> - after PHP >= 5.0.0. For downward compatibility - <function>ocicolumnprecision</function> can also be used. - This is deprecated, however. - </para> - </note> - </refsect1> - </refentry> + <refsect1 role="description"> + &reftitle.description; + <simpara> + &info.function.alias; + <function>oci_field_precision</function>. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/ocicolumnscale.xml?r1=1.8&r2=1.9&ty=u Index: phpdoc/en/reference/oci8/functions/ocicolumnscale.xml diff -u phpdoc/en/reference/oci8/functions/ocicolumnscale.xml:1.8 phpdoc/en/reference/oci8/functions/ocicolumnscale.xml:1.9 --- phpdoc/en/reference/oci8/functions/ocicolumnscale.xml:1.8 Thu Apr 15 07:54:41 2004 +++ phpdoc/en/reference/oci8/functions/ocicolumnscale.xml Tue Sep 6 16:18:29 2005 @@ -1,35 +1,20 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- -DO NOT TRANSLATE THIS FILE. -THE FUNCTION IT DESCRIBES WAS RENAMED AND THIS NAME IS DEPRECATED. -PLEASE, TRANSLATE THE APPROPRIATE NEW FILE. +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.9 $ --> +<refentry id="function.ocicolumnscale"> + <refnamediv> + <refname>ocicolumnscale</refname> + <refpurpose>&Alias; <function>oci_field_scale</function></refpurpose> + </refnamediv> ---> -<!-- splitted from ./en/functions/oci8.xml, last change in rev 1.23 --> - <refentry id="function.ocicolumnscale"> - <refnamediv> - <refname>ocicolumnscale</refname> - <refpurpose>Tell the scale of a column</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>ocicolumnscale</methodname> - <methodparam><type>resource</type><parameter>stmt</parameter></methodparam> - <methodparam><type>int</type><parameter>col</parameter></methodparam> - </methodsynopsis> - <note> - <para> - This function was renamed to <function>oci_field_scale</function> - after PHP >= 5.0.0. For downward compatibility - <function>ocicolumnscale</function> can also be used. - This is deprecated, however. - </para> - </note> - </refsect1> - </refentry> + <refsect1 role="description"> + &reftitle.description; + <simpara> + &info.function.alias; + <function>oci_field_scale</function>. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/ocicolumnsize.xml?r1=1.10&r2=1.11&ty=u Index: phpdoc/en/reference/oci8/functions/ocicolumnsize.xml diff -u phpdoc/en/reference/oci8/functions/ocicolumnsize.xml:1.10 phpdoc/en/reference/oci8/functions/ocicolumnsize.xml:1.11 --- phpdoc/en/reference/oci8/functions/ocicolumnsize.xml:1.10 Tue Aug 3 13:25:33 2004 +++ phpdoc/en/reference/oci8/functions/ocicolumnsize.xml Tue Sep 6 16:18:29 2005 @@ -1,75 +1,20 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- -DO NOT TRANSLATE THIS FILE. -THE FUNCTION IT DESCRIBES WAS RENAMED AND THIS NAME IS DEPRECATED. -PLEASE, TRANSLATE THE APPROPRIATE NEW FILE. +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.11 $ --> +<refentry id="function.ocicolumnsize"> + <refnamediv> + <refname>ocicolumnsize</refname> + <refpurpose>&Alias; <function>oci_field_size</function></refpurpose> + </refnamediv> ---> -<!-- splitted from ./en/functions/oci8.xml, last change in rev 1.15 --> - <refentry id="function.ocicolumnsize"> - <refnamediv> - <refname>ocicolumnsize</refname> - <refpurpose>Return result column size</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>ocicolumnsize</methodname> - <methodparam><type>resource</type><parameter>stmt</parameter></methodparam> - <methodparam><type>mixed</type><parameter>column</parameter></methodparam> - </methodsynopsis> - <para> - <function>ocicolumnsize</function> returns the size of the column - as given by Oracle. You can either use - the column-number (1-Based) or the column-name for the - <parameter>column</parameter> parameter. - </para> - <para> - <example> - <title><function>ocicolumnsize</function> example</title> - <programlisting role="php"> -<![CDATA[ -<?php - $conn = OCILogon("scott", "tiger"); - $stmt = OCIParse($conn, "select * from emp"); - OCIExecute($stmt); - echo "<table border=\"1\">"; - echo "<tr>"; - echo "<th>Name</th>"; - echo "<th>Type</th>"; - echo "<th>Length</th>"; - echo "</tr>"; - $ncols = OCINumCols($stmt); - for ($i = 1; $i <= $ncols; $i++) { - $column_name = OCIColumnName($stmt, $i); - $column_type = OCIColumnType($stmt, $i); - $column_size = OCIColumnSize($stmt, $i); - echo "<tr>"; - echo "<td>$column_name</td>"; - echo "<td>$column_type</td>"; - echo "<td>$column_size</td>"; - echo "</tr>"; - } - echo "</table>"; - OCIFreeStatement($stmt); - OCILogoff($conn); -?> -]]> - </programlisting> - </example> - </para> - <note> - <para> - This function was renamed to <function>oci_field_size</function> - after PHP >= 5.0.0. For downward compatibility - <function>ocicolumnsize</function> can also be used. - This is deprecated, however. - </para> - </note> - </refsect1> - </refentry> + <refsect1 role="description"> + &reftitle.description; + <simpara> + &info.function.alias; + <function>oci_field_size</function>. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/ocicolumntype.xml?r1=1.10&r2=1.11&ty=u Index: phpdoc/en/reference/oci8/functions/ocicolumntype.xml diff -u phpdoc/en/reference/oci8/functions/ocicolumntype.xml:1.10 phpdoc/en/reference/oci8/functions/ocicolumntype.xml:1.11 --- phpdoc/en/reference/oci8/functions/ocicolumntype.xml:1.10 Thu Apr 15 07:54:41 2004 +++ phpdoc/en/reference/oci8/functions/ocicolumntype.xml Tue Sep 6 16:18:29 2005 @@ -1,74 +1,20 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- -DO NOT TRANSLATE THIS FILE. -THE FUNCTION IT DESCRIBES WAS RENAMED AND THIS NAME IS DEPRECATED. -PLEASE, TRANSLATE THE APPROPRIATE NEW FILE. +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.11 $ --> +<refentry id="function.ocicolumntype"> + <refnamediv> + <refname>ocicolumntype</refname> + <refpurpose>&Alias; <function>oci_field_type</function></refpurpose> + </refnamediv> ---> -<!-- splitted from ./en/functions/oci8.xml, last change in rev 1.2 --> - <refentry id="function.ocicolumntype"> - <refnamediv> - <refname>ocicolumntype</refname> - <refpurpose>Returns the data type of a column</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>mixed</type><methodname>ocicolumntype</methodname> - <methodparam><type>resource</type><parameter>stmt</parameter></methodparam> - <methodparam><type>int</type><parameter>col</parameter></methodparam> - </methodsynopsis> - <simpara> - <function>ocicolumntype</function> returns the data type of the - column corresponding to the column number (1-based) that is passed - in. - </simpara> - <para> - <example> - <title><function>ocicolumntype</function> example</title> - <programlisting role="php"> -<![CDATA[ -<?php - $conn = OCILogon("scott", "tiger"); - $stmt = OCIParse($conn, "select * from emp"); - OCIExecute($stmt); - echo "<table border=\"1\">"; - echo "<tr>"; - echo "<th>Name</th>"; - echo "<th>Type</th>"; - echo "<th>Length</th>"; - echo "</tr>"; - $ncols = OCINumCols($stmt); - for ($i = 1; $i <= $ncols; $i++) { - $column_name = OCIColumnName($stmt, $i); - $column_type = OCIColumnType($stmt, $i); - $column_size = OCIColumnSize($stmt, $i); - echo "<tr>"; - echo "<td>$column_name</td>"; - echo "<td>$column_type</td>"; - echo "<td>$column_size</td>"; - echo "</tr>"; - } - echo "</table>\n"; - OCIFreeStatement($stmt); - OCILogoff($conn); -?> -]]> - </programlisting> - </example> - </para> - <note> - <para> - This function was renamed to <function>oci_field_type</function> - after PHP >= 5.0.0. For downward compatibility - <function>ocicolumntype</function> can also be used. - This is deprecated, however. - </para> - </note> - </refsect1> - </refentry> + <refsect1 role="description"> + &reftitle.description; + <simpara> + &info.function.alias; + <function>oci_field_type</function>. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/ocicolumntyperaw.xml?r1=1.10&r2=1.11&ty=u Index: phpdoc/en/reference/oci8/functions/ocicolumntyperaw.xml diff -u phpdoc/en/reference/oci8/functions/ocicolumntyperaw.xml:1.10 phpdoc/en/reference/oci8/functions/ocicolumntyperaw.xml:1.11 --- phpdoc/en/reference/oci8/functions/ocicolumntyperaw.xml:1.10 Wed Jul 21 10:32:09 2004 +++ phpdoc/en/reference/oci8/functions/ocicolumntyperaw.xml Tue Sep 6 16:18:29 2005 @@ -1,39 +1,20 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- -DO NOT TRANSLATE THIS FILE. -THE FUNCTION IT DESCRIBES WAS RENAMED AND THIS NAME IS DEPRECATED. -PLEASE, TRANSLATE THE APPROPRIATE NEW FILE. +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.11 $ --> +<refentry id="function.ocicolumntyperaw"> + <refnamediv> + <refname>ocicolumntyperaw</refname> + <refpurpose>&Alias; <function>oci_field_type_raw</function></refpurpose> + </refnamediv> ---> -<!-- splitted from ./en/functions/oci8.xml, last change in rev 1.23 --> - <refentry id="function.ocicolumntyperaw"> - <refnamediv> - <refname>ocicolumntyperaw</refname> - <refpurpose>Tell the raw oracle data type of a column</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>ocicolumntyperaw</methodname> - <methodparam><type>resource</type><parameter>stmt</parameter></methodparam> - <methodparam><type>int</type><parameter>col</parameter></methodparam> - </methodsynopsis> - <para> - <function>ocicolumntyperaw</function> returns Oracle's raw data type of the - field. - </para> - <note> - <para> - This function was renamed to <function>oci_field_type_raw</function> - after PHP >= 5.0.0. For downward compatibility - <function>ocicolumntyperaw</function> can also be used. - This is deprecated, however. - </para> - </note> - </refsect1> - </refentry> + <refsect1 role="description"> + &reftitle.description; + <simpara> + &info.function.alias; + <function>oci_field_type_raw</function>. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/ocicommit.xml?r1=1.16&r2=1.17&ty=u Index: phpdoc/en/reference/oci8/functions/ocicommit.xml diff -u phpdoc/en/reference/oci8/functions/ocicommit.xml:1.16 phpdoc/en/reference/oci8/functions/ocicommit.xml:1.17 --- phpdoc/en/reference/oci8/functions/ocicommit.xml:1.16 Fri May 14 11:25:52 2004 +++ phpdoc/en/reference/oci8/functions/ocicommit.xml Tue Sep 6 16:18:29 2005 @@ -1,74 +1,20 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.16 $ --> -<!-- - -DO NOT TRANSLATE THIS FILE. -THE FUNCTION IT DESCRIBES WAS RENAMED AND THIS NAME IS DEPRECATED. -PLEASE, TRANSLATE THE APPROPRIATE NEW FILE. - ---> -<!-- splitted from ./en/functions/oci8.xml, last change in rev 1.2 --> - <refentry id="function.ocicommit"> - <refnamediv> - <refname>ocicommit</refname> - <refpurpose>Commits outstanding transactions</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>ocicommit</methodname> - <methodparam><type>resource</type><parameter>connection</parameter></methodparam> - </methodsynopsis> - <para> - <function>ocicommit</function> commits all outstanding statements - for the active transaction on Oracle connection <parameter>connection</parameter>. - &return.success; - </para> - <para> - This example demonstrates how <function>ocicommit</function> is used. - <example> - <title><function>ocicommit</function> example</title> - <programlisting role="php"> -<![CDATA[ -<?php - // Login to Oracle server - $conn = OCILogon('scott', 'tiger'); - - // Parse SQL - $stmt = OCIParse($conn, "INSERT INTO employees (name, surname) VALUES ('Maxim', 'Maletsky')"); - // Execute statement - OCIExecute($stmt); - - // Commit transaction - $committed = OCICommit($conn); - - // Test whether commit was successful. If error occurred, return error message - if (!$committed) { - $error = OCIError($conn); - echo 'Commit failed. Oracle reports: ' . $error['message']; - } - - // Close connection - OCILogoff($conn); -?> -]]> - </programlisting> - </example> - </para> - <note> - <para> - This function was renamed to <function>oci_commit</function> - after PHP >= 5.0.0. For downward compatibility - <function>ocicommit</function> can also be used. - This is deprecated, however. - </para> - </note> - <simpara> - See also <function>ocirollback</function>. - </simpara> - </refsect1> - </refentry> +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.17 $ --> +<refentry id="function.ocicommit"> + <refnamediv> + <refname>ocicommit</refname> + <refpurpose>&Alias; <function>oci_commit</function></refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <simpara> + &info.function.alias; + <function>oci_commit</function>. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/ocidefinebyname.xml?r1=1.13&r2=1.14&ty=u Index: phpdoc/en/reference/oci8/functions/ocidefinebyname.xml diff -u phpdoc/en/reference/oci8/functions/ocidefinebyname.xml:1.13 phpdoc/en/reference/oci8/functions/ocidefinebyname.xml:1.14 --- phpdoc/en/reference/oci8/functions/ocidefinebyname.xml:1.13 Wed Nov 10 03:30:36 2004 +++ phpdoc/en/reference/oci8/functions/ocidefinebyname.xml Tue Sep 6 16:18:29 2005 @@ -1,83 +1,20 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.13 $ --> -<!-- - -DO NOT TRANSLATE THIS FILE. -THE FUNCTION IT DESCRIBES WAS RENAMED AND THIS NAME IS DEPRECATED. -PLEASE, TRANSLATE THE APPROPRIATE NEW FILE. - ---> -<!-- splitted from ./en/functions/oci8.xml, last change in rev 1.2 --> - <refentry id="function.ocidefinebyname"> - <refnamediv> - <refname>ocidefinebyname</refname> - <refpurpose> - Use a PHP variable for the define-step during a SELECT - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>ocidefinebyname</methodname> - <methodparam><type>resource</type><parameter>stmt</parameter></methodparam> - <methodparam><type>string</type><parameter>column_name</parameter></methodparam> - <methodparam><type>mixed</type><parameter role="reference">variable</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>type</parameter></methodparam> - </methodsynopsis> - <para> - <function>ocidefinebyname</function> binds PHP variables for fetches - of SQL-Columns. Be careful that Oracle uses ALL-UPPERCASE column-names, - whereby in your select you can also write lowercase. - <function>ocidefinebyname</function> expects - the <parameter>column_name</parameter> to be in uppercase. If you - define a variable that doesn't exists in your select statement, no - error will be given! - </para> - <para> - If you need to define an abstract datatype (LOB/ROWID/BFILE) you - need to allocate it first using - <function>ocinewdescriptor</function>. See also the - <function>ocibindbyname</function> function. - </para> - <example> - <title><function>ocidefinebyname</function> example</title> - <programlisting role="php"> -<![CDATA[ -<?php -/* OCIDefineByName example - thies at thieso dot net (980219) */ - -$conn = OCILogon("scott", "tiger"); - -$stmt = OCIParse($conn, "select empno, ename from emp"); -/* the define MUST be done BEFORE ociexecute! */ - -OCIDefineByName($stmt, "EMPNO", $empno); -OCIDefineByName($stmt, "ENAME", $ename); - -OCIExecute($stmt); - -while (OCIFetch($stmt)) { - echo "empno:" . $empno . "\n"; - echo "ename:" . $ename . "\n"; -} - -OCIFreeStatement($stmt); -OCILogoff($conn); -?> -]]> - </programlisting> - </example> - <note> - <para> - This function was renamed to <function>oci_define_by_name</function> - after PHP >= 5.0.0. For downward compatibility - <function>ocidefinebyname</function> can also be used. - This is deprecated, however. - </para> - </note> - </refsect1> - </refentry> +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.14 $ --> +<refentry id="function.ocidefinebyname"> + <refnamediv> + <refname>ocidefinebyname</refname> + <refpurpose>&Alias; <function>oci_define_by_name</function></refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <simpara> + &info.function.alias; + <function>oci_define_by_name</function>. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/ocierror.xml?r1=1.11&r2=1.12&ty=u Index: phpdoc/en/reference/oci8/functions/ocierror.xml diff -u phpdoc/en/reference/oci8/functions/ocierror.xml:1.11 phpdoc/en/reference/oci8/functions/ocierror.xml:1.12 --- phpdoc/en/reference/oci8/functions/ocierror.xml:1.11 Tue Nov 23 04:38:17 2004 +++ phpdoc/en/reference/oci8/functions/ocierror.xml Tue Sep 6 16:18:29 2005 @@ -1,52 +1,20 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- -DO NOT TRANSLATE THIS FILE. -THE FUNCTION IT DESCRIBES WAS RENAMED AND THIS NAME IS DEPRECATED. -PLEASE, TRANSLATE THE APPROPRIATE NEW FILE. +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.12 $ --> +<refentry id="function.ocierror"> + <refnamediv> + <refname>ocierror</refname> + <refpurpose>&Alias; <function>oci_error</function></refpurpose> + </refnamediv> ---> -<!-- splitted from ./en/functions/oci8.xml, last change in rev 1.2 --> - <refentry id="function.ocierror"> - <refnamediv> - <refname>ocierror</refname> - <refpurpose>Return the last error of stmt|conn|global</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>array</type><methodname>ocierror</methodname> - <methodparam choice="opt"><type>resource</type><parameter>stmt_or_conn_or_global</parameter></methodparam> - </methodsynopsis> - <simpara> - <function>ocierror</function> returns the last error found. If - the optional <parameter>stmt_or_conn_or_global</parameter> is not - provided, the last error encountered is returned. If no error is - found, <function>ocierror</function> returns - &false;. <function>ocierror</function> returns the error as an - associative array. In this array, <literal>code</literal> - consists the oracle error code and <literal>message</literal> - the oracle errorstring. - </simpara> - <note> - <title>As of PHP 4.3</title> - <simpara> - <literal>offset</literal> and <literal>sqltext</literal> will - also be included in the return array to indicate the location - of the error and the original SQL text which caused it. - </simpara> - </note> - <note> - <para> - This function was renamed to <function>oci_error</function> - after PHP >= 5.0.0. For downward compatibility - <function>ocierror</function> can also be used. - This is deprecated, however. - </para> - </note> - </refsect1> - </refentry> + <refsect1 role="description"> + &reftitle.description; + <simpara> + &info.function.alias; + <function>oci_error</function>. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/ociexecute.xml?r1=1.7&r2=1.8&ty=u Index: phpdoc/en/reference/oci8/functions/ociexecute.xml diff -u phpdoc/en/reference/oci8/functions/ociexecute.xml:1.7 phpdoc/en/reference/oci8/functions/ociexecute.xml:1.8 --- phpdoc/en/reference/oci8/functions/ociexecute.xml:1.7 Thu Apr 15 07:54:41 2004 +++ phpdoc/en/reference/oci8/functions/ociexecute.xml Tue Sep 6 16:18:29 2005 @@ -1,46 +1,20 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> -<!-- -DO NOT TRANSLATE THIS FILE. -THE FUNCTION IT DESCRIBES WAS RENAMED AND THIS NAME IS DEPRECATED. -PLEASE, TRANSLATE THE APPROPRIATE NEW FILE. +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.8 $ --> +<refentry id="function.ociexecute"> + <refnamediv> + <refname>ociexecute</refname> + <refpurpose>&Alias; <function>oci_execute</function></refpurpose> + </refnamediv> ---> -<!-- splitted from ./en/functions/oci8.xml, last change in rev 1.2 --> - <refentry id="function.ociexecute"> - <refnamediv> - <refname>ociexecute</refname> - <refpurpose>Execute a statement</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>ociexecute</methodname> - <methodparam><type>resource</type><parameter>stmt</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>mode</parameter></methodparam> - </methodsynopsis> - <para> - <function>ociexecute</function> executes a previously parsed - statement. (see <function>ociparse</function>). The optional - <parameter>mode</parameter> allows you to specify the - execution-mode (default is OCI_COMMIT_ON_SUCCESS). If you don't - want statements to be committed automatically specify OCI_DEFAULT as - your mode. - </para> - <note> - <para> - This function was renamed to <function>oci_execute</function> - after PHP >= 5.0.0. For downward compatibility - <function>ociexecute</function> can also be used. - This is deprecated, however. - </para> - </note> - <para> - &return.success; - </para> - </refsect1> - </refentry> + <refsect1 role="description"> + &reftitle.description; + <simpara> + &info.function.alias; + <function>oci_execute</function>. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/ocifetch.xml?r1=1.8&r2=1.9&ty=u Index: phpdoc/en/reference/oci8/functions/ocifetch.xml diff -u phpdoc/en/reference/oci8/functions/ocifetch.xml:1.8 phpdoc/en/reference/oci8/functions/ocifetch.xml:1.9 --- phpdoc/en/reference/oci8/functions/ocifetch.xml:1.8 Thu Apr 15 07:54:41 2004 +++ phpdoc/en/reference/oci8/functions/ocifetch.xml Tue Sep 6 16:18:29 2005 @@ -1,38 +1,20 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- -DO NOT TRANSLATE THIS FILE. -THE FUNCTION IT DESCRIBES WAS RENAMED AND THIS NAME IS DEPRECATED. -PLEASE, TRANSLATE THE APPROPRIATE NEW FILE. +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.9 $ --> +<refentry id="function.ocifetch"> + <refnamediv> + <refname>ocifetch</refname> + <refpurpose>&Alias; <function>oci_fetch</function></refpurpose> + </refnamediv> ---> -<!-- splitted from ./en/functions/oci8.xml, last change in rev 1.2 --> - <refentry id="function.ocifetch"> - <refnamediv> - <refname>ocifetch</refname> - <refpurpose>Fetches the next row into result-buffer</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>ocifetch</methodname> - <methodparam><type>resource</type><parameter>stmt</parameter></methodparam> - </methodsynopsis> - <para> - <function>ocifetch</function> fetches the next row (for SELECT - statements) into the internal result-buffer. &return.success; - </para> - <note> - <para> - This function was renamed to <function>oci_fetch</function> - after PHP >= 5.0.0. For downward compatibility - <function>ocifetch</function> can also be used. - This is deprecated, however. - </para> - </note> - </refsect1> - </refentry> + <refsect1 role="description"> + &reftitle.description; + <simpara> + &info.function.alias; + <function>oci_fetch</function>. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/ocifetchinto.xml?r1=1.13&r2=1.14&ty=u Index: phpdoc/en/reference/oci8/functions/ocifetchinto.xml diff -u phpdoc/en/reference/oci8/functions/ocifetchinto.xml:1.13 phpdoc/en/reference/oci8/functions/ocifetchinto.xml:1.14 --- phpdoc/en/reference/oci8/functions/ocifetchinto.xml:1.13 Wed Nov 10 03:30:37 2004 +++ phpdoc/en/reference/oci8/functions/ocifetchinto.xml Tue Sep 6 16:18:29 2005 @@ -5,7 +5,7 @@ THE FUNCTION IT DESCRIBES WAS DEPRECATED. --> -<!-- $Revision: 1.13 $ --> +<!-- $Revision: 1.14 $ --> <refentry id="function.ocifetchinto"> <refnamediv> <refname>ocifetchinto</refname> http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/ocifetchstatement.xml?r1=1.14&r2=1.15&ty=u Index: phpdoc/en/reference/oci8/functions/ocifetchstatement.xml diff -u phpdoc/en/reference/oci8/functions/ocifetchstatement.xml:1.14 phpdoc/en/reference/oci8/functions/ocifetchstatement.xml:1.15 --- phpdoc/en/reference/oci8/functions/ocifetchstatement.xml:1.14 Wed Nov 10 03:30:37 2004 +++ phpdoc/en/reference/oci8/functions/ocifetchstatement.xml Tue Sep 6 16:18:29 2005 @@ -1,44 +1,20 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.14 $ --> -<!-- -DO NOT TRANSLATE THIS FILE. -THE FUNCTION IT DESCRIBES WAS DEPRECATED. +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.15 $ --> +<refentry id="function.ocifetchistatement"> + <refnamediv> + <refname>ocifetchistatement</refname> + <refpurpose>&Alias; <function>oci_fetch_all</function></refpurpose> + </refnamediv> ---> -<!-- splitted from ./en/functions/oci8.xml, last change in rev 1.2 --> - <refentry id="function.ocifetchstatement"> - <refnamediv> - <refname>ocifetchstatement</refname> - <refpurpose>Fetch all rows of result data into an array</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>ocifetchstatement</methodname> - <methodparam><type>resource</type><parameter>stmt</parameter></methodparam> - <methodparam><type>array</type><parameter role="reference">output</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>skip</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>maxrows</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>flags</parameter></methodparam> - </methodsynopsis> - <note> - <para> - In PHP 5.0.0 this function became an alias for - <function>oci_fetch_all</function>. - This name still can be used, it was left as alias of - <function>oci_fetch_all</function> for downwards compatability. - This, however, is deprecated and not recommended. - </para> - </note> - <para> - See also <function>oci_fetch_array</function>, - <function>oci_fetch_assoc</function>, - <function>oci_fetch_object</function>, - <function>oci_fetch_row</function>. - </para> - </refsect1> - </refentry> + <refsect1 role="description"> + &reftitle.description; + <simpara> + &info.function.alias; + <function>oci_fetch_all</function>. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/ocifreecollection.xml?r1=1.9&r2=1.10&ty=u Index: phpdoc/en/reference/oci8/functions/ocifreecollection.xml diff -u phpdoc/en/reference/oci8/functions/ocifreecollection.xml:1.9 phpdoc/en/reference/oci8/functions/ocifreecollection.xml:1.10 --- phpdoc/en/reference/oci8/functions/ocifreecollection.xml:1.9 Thu Apr 15 07:54:41 2004 +++ phpdoc/en/reference/oci8/functions/ocifreecollection.xml Tue Sep 6 16:18:29 2005 @@ -1,34 +1,20 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- -DO NOT TRANSLATE THIS FILE. -THE FUNCTION IT DESCRIBES WAS RENAMED AND THIS NAME IS DEPRECATED. -PLEASE, TRANSLATE THE APPROPRIATE NEW FILE. +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.10 $ --> +<refentry id="function.ocifreecollection"> + <refnamediv> + <refname>ocifreecollection</refname> + <refpurpose>&Alias; <xref linkend="function.oci-collection-free" /></refpurpose> + </refnamediv> ---> -<!-- splitted from ./en/functions/oci8.xml, last change in rev 1.23 --> - <refentry id="function.ocifreecollection"> - <refnamediv> - <refname>ocifreecollection</refname> - <refpurpose>Deletes collection object</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>ocifreecollection</methodname> - <void /> - </methodsynopsis> - <note> - <para> - This function was renamed to <function>oci_free_collection</function> - after PHP >= 5.0.0. For downward compatibility - <function>ocifreecollection</function> can also be used. - This is deprecated, however. - </para> - </note> - </refsect1> - </refentry> + <refsect1 role="description"> + &reftitle.description; + <simpara> + &info.function.alias; + <xref linkend="function.oci-collection-free" />. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/ocifreecursor.xml?r1=1.7&r2=1.8&ty=u Index: phpdoc/en/reference/oci8/functions/ocifreecursor.xml diff -u phpdoc/en/reference/oci8/functions/ocifreecursor.xml:1.7 phpdoc/en/reference/oci8/functions/ocifreecursor.xml:1.8 --- phpdoc/en/reference/oci8/functions/ocifreecursor.xml:1.7 Thu Apr 15 07:54:41 2004 +++ phpdoc/en/reference/oci8/functions/ocifreecursor.xml Tue Sep 6 16:18:29 2005 @@ -1,40 +1,20 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> -<!-- -DO NOT TRANSLATE THIS FILE. -THE FUNCTION IT DESCRIBES WAS RENAMED AND THIS NAME IS DEPRECATED. -PLEASE, TRANSLATE THE APPROPRIATE NEW FILE. +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.8 $ --> +<refentry id="function.ocifreecursor"> + <refnamediv> + <refname>ocifreecursor</refname> + <refpurpose>&Alias; <function>oci_free_statement</function></refpurpose> + </refnamediv> ---> -<!-- splitted from ./en/functions/oci8.xml, last change in rev 1.11 --> - <refentry id="function.ocifreecursor"> - <refnamediv> - <refname>ocifreecursor</refname> - <refpurpose> - Free all resources associated with a cursor - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>ocifreecursor</methodname> - <methodparam><type>resource</type><parameter>stmt</parameter></methodparam> - </methodsynopsis> - <para> - <function>ocifreecursor</function> frees all resources associated with the - cursor <parameter>stmt</parameter>. &return.success; - </para> - <note> - <para> - This function was renamed to <function>oci_free_cursor</function> - after PHP >= 5.0.0. For downward compatibility - <function>ocifreecursor</function> can also be used. - This is deprecated, however. - </para> - </note> - </refsect1> - </refentry> + <refsect1 role="description"> + &reftitle.description; + <simpara> + &info.function.alias; + <function>oci_free_statement</function>. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/ocifreedesc.xml?r1=1.9&r2=1.10&ty=u Index: phpdoc/en/reference/oci8/functions/ocifreedesc.xml diff -u phpdoc/en/reference/oci8/functions/ocifreedesc.xml:1.9 phpdoc/en/reference/oci8/functions/ocifreedesc.xml:1.10 --- phpdoc/en/reference/oci8/functions/ocifreedesc.xml:1.9 Thu Apr 15 07:54:41 2004 +++ phpdoc/en/reference/oci8/functions/ocifreedesc.xml Tue Sep 6 16:18:30 2005 @@ -1,38 +1,20 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- -DO NOT TRANSLATE THIS FILE. -THE FUNCTION IT DESCRIBES WAS RENAMED AND THIS NAME IS DEPRECATED. -PLEASE, TRANSLATE THE APPROPRIATE NEW FILE. +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.10 $ --> +<refentry id="function.ocifreedesc"> + <refnamediv> + <refname>ocifreedesc</refname> + <refpurpose>&Alias; <xref linkend="function.oci-lob-free" /></refpurpose> + </refnamediv> ---> -<!-- splitted from ./en/functions/oci8.xml, last change in rev 1.2 --> - <refentry id="function.ocifreedesc"> - <refnamediv> - <refname>ocifreedesc</refname> - <refpurpose>Deletes a large object descriptor</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>ocifreedesc</methodname> - <void /> - </methodsynopsis> - <para> - <function>ocifreedesc</function> deletes a large object descriptor. - &return.success; - </para> - <note> - <para> - This function was renamed to <function>oci_free_descriptor</function> - after PHP >= 5.0.0. For downward compatibility - <function>ocifreedesc</function> can also be used. - This is deprecated, however. - </para> - </note> - </refsect1> - </refentry> + <refsect1 role="description"> + &reftitle.description; + <simpara> + &info.function.alias; + <xref linkend="function.oci-lob-free" />. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/ocifreestatement.xml?r1=1.8&r2=1.9&ty=u Index: phpdoc/en/reference/oci8/functions/ocifreestatement.xml diff -u phpdoc/en/reference/oci8/functions/ocifreestatement.xml:1.8 phpdoc/en/reference/oci8/functions/ocifreestatement.xml:1.9 --- phpdoc/en/reference/oci8/functions/ocifreestatement.xml:1.8 Thu Apr 15 07:54:42 2004 +++ phpdoc/en/reference/oci8/functions/ocifreestatement.xml Tue Sep 6 16:18:30 2005 @@ -1,40 +1,20 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- -DO NOT TRANSLATE THIS FILE. -THE FUNCTION IT DESCRIBES WAS RENAMED AND THIS NAME IS DEPRECATED. -PLEASE, TRANSLATE THE APPROPRIATE NEW FILE. +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.9 $ --> +<refentry id="function.ocifreestatement"> + <refnamediv> + <refname>ocifreestatement</refname> + <refpurpose>&Alias; <function>oci_free_statement</function></refpurpose> + </refnamediv> ---> -<!-- splitted from ./en/functions/oci8.xml, last change in rev 1.2 --> - <refentry id="function.ocifreestatement"> - <refnamediv> - <refname>ocifreestatement</refname> - <refpurpose> - Free all resources associated with a statement - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>ocifreestatement</methodname> - <methodparam><type>resource</type><parameter>stmt</parameter></methodparam> - </methodsynopsis> - <para> - <function>ocifreestatement</function> free all resources associated - with the statement <parameter>stmt</parameter>. &return.success; - </para> - <note> - <para> - This function was renamed to <function>oci_free_statement</function> - after PHP >= 5.0.0. For downward compatibility - <function>ocifreestatement</function> can also be used. - This is deprecated, however. - </para> - </note> - </refsect1> - </refentry> + <refsect1 role="description"> + &reftitle.description; + <simpara> + &info.function.alias; + <function>oci_free_statement</function>. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/ociinternaldebug.xml?r1=1.6&r2=1.7&ty=u Index: phpdoc/en/reference/oci8/functions/ociinternaldebug.xml diff -u phpdoc/en/reference/oci8/functions/ociinternaldebug.xml:1.6 phpdoc/en/reference/oci8/functions/ociinternaldebug.xml:1.7 --- phpdoc/en/reference/oci8/functions/ociinternaldebug.xml:1.6 Thu Apr 15 07:54:42 2004 +++ phpdoc/en/reference/oci8/functions/ociinternaldebug.xml Tue Sep 6 16:18:30 2005 @@ -1,41 +1,20 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- -DO NOT TRANSLATE THIS FILE. -THE FUNCTION IT DESCRIBES WAS RENAMED AND THIS NAME IS DEPRECATED. -PLEASE, TRANSLATE THE APPROPRIATE NEW FILE. +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.7 $ --> +<refentry id="function.ociinternaldebug"> + <refnamediv> + <refname>ociinternaldebug</refname> + <refpurpose>&Alias; <function>oci_internal_debug</function></refpurpose> + </refnamediv> ---> -<!-- splitted from ./en/functions/oci8.xml, last change in rev 1.2 --> - <refentry id="function.ociinternaldebug"> - <refnamediv> - <refname>ociinternaldebug</refname> - <refpurpose> - Enables or disables internal debug output - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>void</type><methodname>ociinternaldebug</methodname> - <methodparam><type>int</type><parameter>onoff</parameter></methodparam> - </methodsynopsis> - <simpara> - <function>ociinternaldebug</function> enables internal debug - output. Set <parameter>onoff</parameter> to 0 to turn debug - output off, 1 to turn it on. - </simpara> - <note> - <para> - This function was renamed to <function>oci_internal_debug</function> - after PHP >= 5.0.0. For downward compatibility - <function>ociinternaldebug</function> can also be used. - This is deprecated, however. - </para> - </note> - </refsect1> - </refentry> + <refsect1 role="description"> + &reftitle.description; + <simpara> + &info.function.alias; + <function>oci_internal_debug</function>. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/ociloadlob.xml?r1=1.8&r2=1.9&ty=u Index: phpdoc/en/reference/oci8/functions/ociloadlob.xml diff -u phpdoc/en/reference/oci8/functions/ociloadlob.xml:1.8 phpdoc/en/reference/oci8/functions/ociloadlob.xml:1.9 --- phpdoc/en/reference/oci8/functions/ociloadlob.xml:1.8 Thu Apr 15 07:54:42 2004 +++ phpdoc/en/reference/oci8/functions/ociloadlob.xml Tue Sep 6 16:18:30 2005 @@ -1,34 +1,20 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- -DO NOT TRANSLATE THIS FILE. -THE FUNCTION IT DESCRIBES WAS RENAMED AND THIS NAME IS DEPRECATED. -PLEASE, TRANSLATE THE APPROPRIATE NEW FILE. +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.9 $ --> +<refentry id="function.ociloadlob"> + <refnamediv> + <refname>ociloadlob</refname> + <refpurpose>&Alias; <xref linkend="function.oci-lob-load" /></refpurpose> + </refnamediv> ---> -<!-- splitted from ./en/functions/oci8.xml, last change in rev 1.23 --> - <refentry id="function.ociloadlob"> - <refnamediv> - <refname>ociloadlob</refname> - <refpurpose>Loads a large object</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>string</type><methodname>ociloadlob</methodname> - <void /> - </methodsynopsis> - <note> - <para> - This function was renamed to <function>oci_lob_load</function> - after PHP >= 5.0.0. For downward compatibility - <function>ociloadlob</function> can also be used. - This is deprecated, however. - </para> - </note> - </refsect1> - </refentry> + <refsect1 role="description"> + &reftitle.description; + <simpara> + &info.function.alias; + <xref linkend="function.oci-lob-load" />. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/ocilogoff.xml?r1=1.9&r2=1.10&ty=u Index: phpdoc/en/reference/oci8/functions/ocilogoff.xml diff -u phpdoc/en/reference/oci8/functions/ocilogoff.xml:1.9 phpdoc/en/reference/oci8/functions/ocilogoff.xml:1.10 --- phpdoc/en/reference/oci8/functions/ocilogoff.xml:1.9 Thu Apr 15 07:54:42 2004 +++ phpdoc/en/reference/oci8/functions/ocilogoff.xml Tue Sep 6 16:18:30 2005 @@ -1,45 +1,20 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- -DO NOT TRANSLATE THIS FILE. -THE FUNCTION IT DESCRIBES WAS RENAMED AND THIS NAME IS DEPRECATED. -PLEASE, TRANSLATE THE APPROPRIATE NEW FILE. +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.10 $ --> +<refentry id="function.ocilogoff"> + <refnamediv> + <refname>ocilogoff</refname> + <refpurpose>&Alias; <function>oci_close</function></refpurpose> + </refnamediv> ---> -<!-- splitted from ./en/functions/oci8.xml, last change in rev 1.2 --> - <refentry id="function.ocilogoff"> - <refnamediv> - <refname>ocilogoff</refname> - <refpurpose>Disconnects from Oracle server</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>ocilogoff</methodname> - <methodparam><type>resource</type><parameter>connection</parameter></methodparam> - </methodsynopsis> - <para> - <function>ocilogoff</function> closes the Oracle connection - <parameter>connection</parameter>. - </para> - <para> - Using <function>ocilogoff</function> isn't usually necessary, - as non-persistent open links are automatically closed at the end - of the script's execution. See also - <link linkend="language.types.resource.self-destruct">freeing - resources</link>. - </para> - <note> - <para> - This function was renamed to <function>oci_close</function> - after PHP >= 5.0.0. For downward compatibility - <function>ocilogoff</function> can also be used. - This is deprecated, however. - </para> - </note> - </refsect1> - </refentry> + <refsect1 role="description"> + &reftitle.description; + <simpara> + &info.function.alias; + <function>oci_close</function>. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/ocilogon.xml?r1=1.14&r2=1.15&ty=u Index: phpdoc/en/reference/oci8/functions/ocilogon.xml diff -u phpdoc/en/reference/oci8/functions/ocilogon.xml:1.14 phpdoc/en/reference/oci8/functions/ocilogon.xml:1.15 --- phpdoc/en/reference/oci8/functions/ocilogon.xml:1.14 Thu Jul 8 06:05:05 2004 +++ phpdoc/en/reference/oci8/functions/ocilogon.xml Tue Sep 6 16:18:30 2005 @@ -1,149 +1,20 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.14 $ --> -<!-- - -DO NOT TRANSLATE THIS FILE. -THE FUNCTION IT DESCRIBES WAS RENAMED AND THIS NAME IS DEPRECATED. -PLEASE, TRANSLATE THE APPROPRIATE NEW FILE. - ---> -<!-- splitted from ./en/functions/oci8.xml, last change in rev 1.2 --> - <refentry id="function.ocilogon"> - <refnamediv> - <refname>ocilogon</refname> - <refpurpose>Establishes a connection to Oracle</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>resource</type><methodname>ocilogon</methodname> - <methodparam><type>string</type><parameter>username</parameter></methodparam> - <methodparam><type>string</type><parameter>password</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>db</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>charset</parameter></methodparam> - </methodsynopsis> - <para> - <function>ocilogon</function> returns an connection identifier - needed for most other OCI calls. The optional third parameter - can either contain the name of the local Oracle instance or the - name of the entry in tnsnames.ora to which you want to connect. - If the optional third parameter is not specified, PHP uses the - environment variables ORACLE_SID (Oracle instance) or TWO_TASK - (tnsnames.ora) to determine which database to connect to. - </para> - &oci.charset; - <para>Connections are shared at the page level when using - <function>ocilogon</function>. This means that commits and - rollbacks apply to all open transactions in the page, even if you - have created multiple connections. - </para> - <para> - This example demonstrates how the connections are shared. - <example> - <title><function>ocilogon</function> example</title> - <programlisting role="php"> -<![CDATA[ -<?php -echo "<pre>"; -$db = ""; - -$c1 = ocilogon("scott", "tiger", $db); -$c2 = ocilogon("scott", "tiger", $db); - -function create_table($conn) -{ - $stmt = ociparse($conn, "create table scott.hallo (test varchar2(64))"); - ociexecute($stmt); - echo $conn . " created table\n\n"; -} - -function drop_table($conn) -{ - $stmt = ociparse($conn, "drop table scott.hallo"); - ociexecute($stmt); - echo $conn . " dropped table\n\n"; -} - -function insert_data($conn) -{ - $stmt = ociparse($conn, "insert into scott.hallo - values('$conn' || ' ' || to_char(sysdate,'DD-MON-YY HH24:MI:SS'))"); - ociexecute($stmt, OCI_DEFAULT); - echo $conn . " inserted hallo\n\n"; -} - -function delete_data($conn) -{ - $stmt = ociparse($conn, "delete from scott.hallo"); - ociexecute($stmt, OCI_DEFAULT); - echo $conn . " deleted hallo\n\n"; -} - -function commit($conn) -{ - ocicommit($conn); - echo $conn . " committed\n\n"; -} - -function rollback($conn) -{ - ocirollback($conn); - echo $conn . " rollback\n\n"; -} -function select_data($conn) -{ - $stmt = ociparse($conn, "select * from scott.hallo"); - ociexecute($stmt, OCI_DEFAULT); - echo $conn."----selecting\n\n"; - while (ocifetch($stmt)) { - echo $conn . " [" . ociresult($stmt, "TEST") . "]\n\n"; - } - echo $conn . "----done\n\n"; -} - -create_table($c1); -insert_data($c1); // Insert a row using c1 -insert_data($c2); // Insert a row using c2 - -select_data($c1); // Results of both inserts are returned -select_data($c2); - -rollback($c1); // Rollback using c1 - -select_data($c1); // Both inserts have been rolled back -select_data($c2); - -insert_data($c2); // Insert a row using c2 -commit($c2); // Commit using c2 - -select_data($c1); // Result of c2 insert is returned - -delete_data($c1); // Delete all rows in table using c1 -select_data($c1); // No rows returned -select_data($c2); // No rows returned -commit($c1); // Commit using c1 - -select_data($c1); // No rows returned -select_data($c2); // No rows returned - -drop_table($c1); -echo "</pre>"; -?> -]]> - </programlisting> - </example> - </para> - <note> - <para> - This function was renamed to <function>oci_connect</function> - after PHP >= 5.0.0. For downward compatibility - <function>ocilogon</function> can also be used. - This is deprecated, however. - </para> - </note> - </refsect1> - </refentry> +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.15 $ --> +<refentry id="function.ocilogon"> + <refnamediv> + <refname>ocilogon</refname> + <refpurpose>&Alias; <function>oci_connect</function></refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <simpara> + &info.function.alias; + <function>oci_connect</function>. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/ocinewcollection.xml?r1=1.10&r2=1.11&ty=u Index: phpdoc/en/reference/oci8/functions/ocinewcollection.xml diff -u phpdoc/en/reference/oci8/functions/ocinewcollection.xml:1.10 phpdoc/en/reference/oci8/functions/ocinewcollection.xml:1.11 --- phpdoc/en/reference/oci8/functions/ocinewcollection.xml:1.10 Fri Nov 12 06:02:29 2004 +++ phpdoc/en/reference/oci8/functions/ocinewcollection.xml Tue Sep 6 16:18:30 2005 @@ -1,36 +1,20 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- -DO NOT TRANSLATE THIS FILE. -THE FUNCTION IT DESCRIBES WAS RENAMED AND THIS NAME IS DEPRECATED. -PLEASE, TRANSLATE THE APPROPRIATE NEW FILE. +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.11 $ --> +<refentry id="function.ocinewcollection"> + <refnamediv> + <refname>ocinewcollection</refname> + <refpurpose>&Alias; <function>oci_new_collection</function></refpurpose> + </refnamediv> ---> -<!-- splitted from ./en/functions/oci8.xml, last change in rev 1.23 --> - <refentry id="function.ocinewcollection"> - <refnamediv> - <refname>ocinewcollection</refname> - <refpurpose>Initialize a new collection</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>OCI-Collection</type><methodname>ocinewcollection</methodname> - <methodparam><type>resource</type><parameter>connection</parameter></methodparam> - <methodparam><type>string</type><parameter>tdo</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>schema</parameter></methodparam> - </methodsynopsis> - <note> - <para> - This function was renamed to <function>oci_new_collection</function> - after PHP >= 5.0.0. For downward compatibility - <function>ocinewcollection</function> can also be used. - This is deprecated, however. - </para> - </note> - </refsect1> - </refentry> + <refsect1 role="description"> + &reftitle.description; + <simpara> + &info.function.alias; + <function>oci_new_collection</function>. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/ocinewcursor.xml?r1=1.10&r2=1.11&ty=u Index: phpdoc/en/reference/oci8/functions/ocinewcursor.xml diff -u phpdoc/en/reference/oci8/functions/ocinewcursor.xml:1.10 phpdoc/en/reference/oci8/functions/ocinewcursor.xml:1.11 --- phpdoc/en/reference/oci8/functions/ocinewcursor.xml:1.10 Wed Jun 9 02:22:18 2004 +++ phpdoc/en/reference/oci8/functions/ocinewcursor.xml Tue Sep 6 16:18:30 2005 @@ -1,110 +1,20 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- - -DO NOT TRANSLATE THIS FILE. -THE FUNCTION IT DESCRIBES WAS RENAMED AND THIS NAME IS DEPRECATED. -PLEASE, TRANSLATE THE APPROPRIATE NEW FILE. - ---> -<!-- splitted from ./en/functions/oci8.xml, last change in rev 1.2 --> - <refentry id="function.ocinewcursor"> - <refnamediv> - <refname>ocinewcursor</refname> - <refpurpose> - Return a new cursor (Statement-Handle) - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>resource</type><methodname>ocinewcursor</methodname> - <methodparam><type>resource</type><parameter>conn</parameter></methodparam> - </methodsynopsis> - <para> - <function>ocinewcursor</function> allocates a new statement handle - on the specified connection. - </para> - <para> - <example> - <title>Using a REF CURSOR from a stored procedure in Oracle</title> - <programlisting role="php"> -<![CDATA[ -<?php -// suppose your stored procedure info.output returns a ref cursor in :data - -$conn = OCILogon("scott", "tiger"); -$curs = OCINewCursor($conn); -$stmt = OCIParse($conn, "begin info.output(:data); end;"); -ocibindbyname($stmt, "data", $curs, -1, OCI_B_CURSOR); -ociexecute($stmt); -ociexecute($curs); - -while (OCIFetchInto($curs, $data)) { - var_dump($data); -} - -OCIFreeStatement($stmt); -OCIFreeCursor($curs); -OCILogoff($conn); -?> -]]> - </programlisting> - </example> - </para> - <para> - <example> - <title>Using a REF CURSOR in a select statement in Oracle</title> - <programlisting role="php"> -<![CDATA[ -<?php -echo "<html><body>"; -$conn = OCILogon("scott", "tiger"); -$count_cursor = "CURSOR(select count(empno) num_emps from emp " . - "where emp.deptno = dept.deptno) as EMPCNT from dept"; -$stmt = OCIParse($conn, "select deptno,dname,$count_cursor"); - -ociexecute($stmt); -echo "<table border=\"1\">"; -echo "<tr>"; -echo "<th>DEPT NAME</th>"; -echo "<th>DEPT #</th>"; -echo "<th># EMPLOYEES</th>"; -echo "</tr>"; - -while (OCIFetchInto($stmt, &$data, OCI_ASSOC)) { - echo "<tr>"; - $dname = $data["DNAME"]; - $deptno = $data["DEPTNO"]; - echo "<td>$dname</td>"; - echo "<td>$deptno</td>"; - ociexecute($data["EMPCNT"]); - while (OCIFetchInto($data["EMPCNT"], &$subdata, OCI_ASSOC)) { - $num_emps = $subdata["NUM_EMPS"]; - echo "<td>$num_emps</td>"; - } - echo "</tr>"; -} -echo "</table>"; -echo "</body></html>"; -OCIFreeStatement($stmt); -OCILogoff($conn); -?> -]]> - </programlisting> - </example> - </para> - <note> - <para> - This function was renamed to <function>oci_new_cursor</function> - after PHP >= 5.0.0. For downward compatibility - <function>ocinewcursor</function> can also be used. - This is deprecated, however. - </para> - </note> - </refsect1> - </refentry> +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.11 $ --> +<refentry id="function.ocinewcursor"> + <refnamediv> + <refname>ocinewcursor</refname> + <refpurpose>&Alias; <function>oci_new_cursor</function></refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <simpara> + &info.function.alias; + <function>oci_new_cursor</function>. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/ocinewdescriptor.xml?r1=1.14&r2=1.15&ty=u Index: phpdoc/en/reference/oci8/functions/ocinewdescriptor.xml diff -u phpdoc/en/reference/oci8/functions/ocinewdescriptor.xml:1.14 phpdoc/en/reference/oci8/functions/ocinewdescriptor.xml:1.15 --- phpdoc/en/reference/oci8/functions/ocinewdescriptor.xml:1.14 Fri Nov 12 06:02:29 2004 +++ phpdoc/en/reference/oci8/functions/ocinewdescriptor.xml Tue Sep 6 16:18:30 2005 @@ -1,156 +1,20 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.14 $ --> -<!-- - -DO NOT TRANSLATE THIS FILE. -THE FUNCTION IT DESCRIBES WAS RENAMED AND THIS NAME IS DEPRECATED. -PLEASE, TRANSLATE THE APPROPRIATE NEW FILE. - ---> -<!-- splitted from ./en/functions/oci8.xml, last change in rev 1.2 --> - <refentry id="function.ocinewdescriptor"> - <refnamediv> - <refname>ocinewdescriptor</refname> - <refpurpose> - Initialize a new empty LOB or FILE descriptor - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>OCI-Lob</type><methodname>ocinewdescriptor</methodname> - <methodparam><type>resource</type><parameter>connection</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>type</parameter></methodparam> - </methodsynopsis> - <para> - <function>ocinewdescriptor</function> allocates storage to hold - descriptors or LOB locators. Valid values for - <parameter>type</parameter> are <constant>OCI_D_FILE</constant>, - <constant>OCI_D_LOB</constant> and <constant>OCI_D_ROWID</constant>. - For LOB descriptors, the methods load, save, and savefile are - associated with the descriptor, for BFILE only the load method - exists. See the second example usage hints. - </para> - <para> - <example> - <title><function>ocinewdescriptor</function> example</title> - <programlisting role="php"> -<![CDATA[ -<?php - /* This script is designed to be called from a HTML form. - * It expects $user, $password, $table, $where, and $commitsize - * to be passed in from the form. The script then deletes - * the selected rows using the ROWID and commits after each - * set of $commitsize rows. (Use with care, there is no rollback) - */ - $conn = OCILogon($user, $password); - $stmt = OCIParse($conn, "select rowid from $table $where"); - $rowid = OCINewDescriptor($conn, OCI_D_ROWID); - OCIDefineByName($stmt, "ROWID", &$rowid); - OCIExecute($stmt); - while (OCIFetch($stmt)) { - $nrows = OCIRowCount($stmt); - $delete = OCIParse($conn, "delete from $table where ROWID = :rid"); - OCIBindByName($delete, ":rid", &$rowid, -1, OCI_B_ROWID); - OCIExecute($delete); - echo "$nrows\n"; - if (($nrows % $commitsize) == 0) { - OCICommit($conn); - } - } - $nrows = OCIRowCount($stmt); - echo "$nrows deleted...\n"; - OCIFreeStatement($stmt); - OCILogoff($conn); -?> -]]> - </programlisting> - <programlisting role="php"> -<![CDATA[ -<?php - /* This script demonstrates file upload to LOB columns - * The formfield used for this example looks like this - * <form action="upload.php" method="post" enctype="multipart/form-data"> - * <input type="file" name="lob_upload" /> - * ... - */ - if (!isset($lob_upload) || $lob_upload == 'none'){ -?> -<form action="upload.php" method="post" enctype="multipart/form-data"> -Upload file: <input type="file" name="lob_upload" /><br /> -<input type="submit" value="Upload" /> - <input type="reset" value="Reset" /> -</form> -<?php - } else { - // $lob_upload contains the temporary filename of the uploaded file - - // see also the features section on file upload, - // if you would like to use secure uploads - - $conn = OCILogon($user, $password); - $lob = OCINewDescriptor($conn, OCI_D_LOB); - $stmt = OCIParse($conn, "insert into $table (id, the_blob) - values(my_seq.NEXTVAL, EMPTY_BLOB()) returning the_blob into :the_blob"); - OCIBindByName($stmt, ':the_blob', &$lob, -1, OCI_B_BLOB); - OCIExecute($stmt, OCI_DEFAULT); - if ($lob->savefile($lob_upload)){ - OCICommit($conn); - echo "Blob successfully uploaded\n"; - }else{ - echo "Couldn't upload Blob\n"; - } - OCIFreeDesc($lob); - OCIFreeStatement($stmt); - OCILogoff($conn); - } -?> -]]> - </programlisting> - </example> - <example> - <title><function>ocinewdescriptor</function> second example</title> - <programlisting role="php"> -<![CDATA[ -<?php - /* Calling PL/SQL stored procedures which contain clobs as input - * parameters (PHP 4 >= 4.0.6). - * Example PL/SQL stored procedure signature is: - * - * PROCEDURE save_data - * Argument Name Type In/Out Default? - * ------------------------------ ----------------------- ------ -------- - * KEY NUMBER(38) IN - * DATA CLOB IN - * - */ - - $conn = OCILogon($user, $password); - $stmt = OCIParse($conn, "begin save_data(:key, :data); end;"); - $clob = OCINewDescriptor($conn, OCI_D_LOB); - OCIBindByName($stmt, ':key', $key); - OCIBindByName($stmt, ':data', $clob, -1, OCI_B_CLOB); - $clob->WriteTemporary($data); - OCIExecute($stmt, OCI_DEFAULT); - OCICommit($conn); - $clob->close(); - $clob->free(); - OCIFreeStatement($stmt); -?> -]]> - </programlisting> - </example> - </para> - <note> - <para> - This function was renamed to <function>oci_new_descriptor</function> - after PHP >= 5.0.0. For downward compatibility - <function>ocinewdescriptor</function> can also be used. - This is deprecated, however. - </para> - </note> - </refsect1> - </refentry> +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.15 $ --> +<refentry id="function.ocinewscriptor"> + <refnamediv> + <refname>ocinewscriptor</refname> + <refpurpose>&Alias; <function>oci_new_descriptor</function></refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <simpara> + &info.function.alias; + <function>oci_new_descriptor</function>. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/ocinlogon.xml?r1=1.13&r2=1.14&ty=u Index: phpdoc/en/reference/oci8/functions/ocinlogon.xml diff -u phpdoc/en/reference/oci8/functions/ocinlogon.xml:1.13 phpdoc/en/reference/oci8/functions/ocinlogon.xml:1.14 --- phpdoc/en/reference/oci8/functions/ocinlogon.xml:1.13 Thu Jul 8 06:05:05 2004 +++ phpdoc/en/reference/oci8/functions/ocinlogon.xml Tue Sep 6 16:18:30 2005 @@ -1,153 +1,20 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.13 $ --> -<!-- - -DO NOT TRANSLATE THIS FILE. -THE FUNCTION IT DESCRIBES WAS RENAMED AND THIS NAME IS DEPRECATED. -PLEASE, TRANSLATE THE APPROPRIATE NEW FILE. - ---> -<!-- splitted from ./en/functions/oci8.xml, last change in rev 1.15 --> - <refentry id="function.ocinlogon"> - <refnamediv> - <refname>ocinlogon</refname> - <refpurpose>Establishes a new connection to Oracle</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>resource</type><methodname>ocinlogon</methodname> - <methodparam><type>string</type><parameter>username</parameter></methodparam> - <methodparam><type>string</type><parameter>password</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>db</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>charset</parameter></methodparam> - </methodsynopsis> - <para> - <function>ocinlogon</function> creates a new connection to an - Oracle 8 database and logs on. The optional third parameter can - either contain the name of the local Oracle instance or the name - of the entry in tnsnames.ora to which you want to connect. If - the optional third parameter is not specified, PHP uses the - environment variables ORACLE_SID (Oracle instance) or TWO_TASK - (tnsnames.ora) to determine which database to connect to. - </para> - <para> - <function>ocinlogon</function> forces a new connection. This - should be used if you need to isolate a set of transactions. By - default, connections are shared at the page level if using - <function>ocilogon</function> or at the web server process level - if using <function>ociplogon</function>. If you have multiple - connections open using <function>ocinlogon</function>, all - commits and rollbacks apply to the specified connection only. - </para> - &oci.charset; - <para> - This example demonstrates how the connections are separated. - <example> - <title><function>ocinlogon</function> example</title> - <programlisting role="php"> -<![CDATA[ -<?php -echo "<html><pre>"; -$db = ""; - -$c1 = ocilogon("scott", "tiger", $db); -$c2 = ocinlogon("scott", "tiger", $db); - -function create_table($conn) -{ - $stmt = ociparse($conn, "create table scott.hallo (test -varchar2(64))"); - ociexecute($stmt); - echo $conn . " created table\n\n"; -} - -function drop_table($conn) -{ - $stmt = ociparse($conn, "drop table scott.hallo"); - ociexecute($stmt); - echo $conn . " dropped table\n\n"; -} - -function insert_data($conn) -{ - $stmt = ociparse($conn, "insert into scott.hallo - values('$conn' || ' ' || to_char(sysdate,'DD-MON-YY HH24:MI:SS'))"); - ociexecute($stmt, OCI_DEFAULT); - echo $conn . " inserted hallo\n\n"; -} - -function delete_data($conn) -{ - $stmt = ociparse($conn, "delete from scott.hallo"); - ociexecute($stmt, OCI_DEFAULT); - echo $conn . " deleted hallo\n\n"; -} - -function commit($conn) -{ - ocicommit($conn); - echo $conn . " committed\n\n"; -} - -function rollback($conn) -{ - ocirollback($conn); - echo $conn . " rollback\n\n"; -} -function select_data($conn) -{ - $stmt = ociparse($conn, "select * from scott.hallo"); - ociexecute($stmt, OCI_DEFAULT); - echo $conn . "----selecting\n\n"; - while (ocifetch($stmt)) { - echo $conn . " <" . ociresult($stmt, "TEST") . ">\n\n"; - } - echo $conn . "----done\n\n"; -} - -create_table($c1); -insert_data($c1); - -select_data($c1); -select_data($c2); - -rollback($c1); - -select_data($c1); -select_data($c2); - -insert_data($c2); -commit($c2); - -select_data($c1); - -delete_data($c1); -select_data($c1); -select_data($c2); -commit($c1); - -select_data($c1); -select_data($c2); - -drop_table($c1); -echo "</pre></html>"; -?> -]]> - </programlisting> - </example> - </para> - <note> - <para> - This function was renamed to <function>oci_new_connect</function> - after PHP >= 5.0.0. For downward compatibility - <function>ocinlogon</function> can also be used. - This is deprecated, however. - </para> - </note> - </refsect1> - </refentry> +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.14 $ --> +<refentry id="function.ocinlogon"> + <refnamediv> + <refname>ocinlogon</refname> + <refpurpose>&Alias; <function>oci_new_connect</function></refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <simpara> + &info.function.alias; + <function>oci_new_connect</function>. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/ocinumcols.xml?r1=1.10&r2=1.11&ty=u Index: phpdoc/en/reference/oci8/functions/ocinumcols.xml diff -u phpdoc/en/reference/oci8/functions/ocinumcols.xml:1.10 phpdoc/en/reference/oci8/functions/ocinumcols.xml:1.11 --- phpdoc/en/reference/oci8/functions/ocinumcols.xml:1.10 Thu Apr 15 07:54:42 2004 +++ phpdoc/en/reference/oci8/functions/ocinumcols.xml Tue Sep 6 16:18:30 2005 @@ -1,68 +1,20 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- -DO NOT TRANSLATE THIS FILE. -THE FUNCTION IT DESCRIBES WAS RENAMED AND THIS NAME IS DEPRECATED. -PLEASE, TRANSLATE THE APPROPRIATE NEW FILE. +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.11 $ --> +<refentry id="function.ocinumcols"> + <refnamediv> + <refname>ocinumcols</refname> + <refpurpose>&Alias; <function>oci_num_fields</function></refpurpose> + </refnamediv> ---> -<!-- splitted from ./en/functions/oci8.xml, last change in rev 1.2 --> - <refentry id="function.ocinumcols"> - <refnamediv> - <refname>ocinumcols</refname> - <refpurpose> - Return the number of result columns in a statement - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>ocinumcols</methodname> - <methodparam><type>resource</type><parameter>stmt</parameter></methodparam> - </methodsynopsis> - <para> - <function>ocinumcols</function> returns the number of columns in the - statement <parameter>stmt</parameter>. - </para> - <para> - <example> - <title><function>ocinumcols</function> example</title> - <programlisting role="php"> -<![CDATA[ -<?php - echo "<pre>\n"; - $conn = OCILogon("scott", "tiger"); - $stmt = OCIParse($conn, "select * from emp"); - OCIExecute($stmt); - while (OCIFetch($stmt)) { - echo "\n"; - $ncols = OCINumCols($stmt); - for ($i = 1; $i <= $ncols; $i++) { - $column_name = OCIColumnName($stmt, $i); - $column_value = OCIResult($stmt, $i); - echo $column_name . ': ' . $column_value . "\n"; - } - echo "\n"; - } - OCIFreeStatement($stmt); - OCILogoff($conn); - echo "</pre>"; -?> -]]> - </programlisting> - </example> - </para> - <note> - <para> - This function was renamed to <function>oci_num_fields</function> - after PHP >= 5.0.0. For downward compatibility - <function>ocinumcols</function> can also be used. - This is deprecated, however. - </para> - </note> - </refsect1> - </refentry> + <refsect1 role="description"> + &reftitle.description; + <simpara> + &info.function.alias; + <function>oci_num_fields</function>. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/ociparse.xml?r1=1.8&r2=1.9&ty=u Index: phpdoc/en/reference/oci8/functions/ociparse.xml diff -u phpdoc/en/reference/oci8/functions/ociparse.xml:1.8 phpdoc/en/reference/oci8/functions/ociparse.xml:1.9 --- phpdoc/en/reference/oci8/functions/ociparse.xml:1.8 Thu Apr 15 07:54:42 2004 +++ phpdoc/en/reference/oci8/functions/ociparse.xml Tue Sep 6 16:18:30 2005 @@ -1,43 +1,20 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- -DO NOT TRANSLATE THIS FILE. -THE FUNCTION IT DESCRIBES WAS RENAMED AND THIS NAME IS DEPRECATED. -PLEASE, TRANSLATE THE APPROPRIATE NEW FILE. +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.9 $ --> +<refentry id="function.ociparse"> + <refnamediv> + <refname>ociparse</refname> + <refpurpose>&Alias; <function>oci_parse</function></refpurpose> + </refnamediv> ---> -<!-- splitted from ./en/functions/oci8.xml, last change in rev 1.2 --> - <refentry id="function.ociparse"> - <refnamediv> - <refname>ociparse</refname> - <refpurpose>Parse a query and return an Oracle statement</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>resource</type><methodname>ociparse</methodname> - <methodparam><type>resource</type><parameter>conn</parameter></methodparam> - <methodparam><type>string</type><parameter>query</parameter></methodparam> - </methodsynopsis> - <para> - <function>ociparse</function> parses the - <parameter>query</parameter> using <parameter>conn</parameter>. - It returns the statement identity if the <parameter>query</parameter> - is valid, &false; if - not. The <parameter>query</parameter> can be any valid SQL - statement or PL/SQL block. - </para> - <note> - <para> - This function was renamed to <function>oci_parse</function> - after PHP >= 5.0.0. For downward compatibility - <function>ociparse</function> can also be used. - This is deprecated, however. - </para> - </note> - </refsect1> - </refentry> + <refsect1 role="description"> + &reftitle.description; + <simpara> + &info.function.alias; + <function>oci_parse</function>. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/ociplogon.xml?r1=1.9&r2=1.10&ty=u Index: phpdoc/en/reference/oci8/functions/ociplogon.xml diff -u phpdoc/en/reference/oci8/functions/ociplogon.xml:1.9 phpdoc/en/reference/oci8/functions/ociplogon.xml:1.10 --- phpdoc/en/reference/oci8/functions/ociplogon.xml:1.9 Thu Jul 8 06:05:05 2004 +++ phpdoc/en/reference/oci8/functions/ociplogon.xml Tue Sep 6 16:18:30 2005 @@ -1,50 +1,20 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- -DO NOT TRANSLATE THIS FILE. -THE FUNCTION IT DESCRIBES WAS RENAMED AND THIS NAME IS DEPRECATED. -PLEASE, TRANSLATE THE APPROPRIATE NEW FILE. +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.10 $ --> +<refentry id="function.ociplogon"> + <refnamediv> + <refname>ociplogon</refname> + <refpurpose>&Alias; <function>oci_pconnect</function></refpurpose> + </refnamediv> ---> -<!-- splitted from ./en/functions/oci8.xml, last change in rev 1.15 --> - <refentry id="function.ociplogon"> - <refnamediv> - <refname>ociplogon</refname> - <refpurpose> - Connect to an Oracle database using a persistent connection - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>resource</type><methodname>ociplogon</methodname> - <methodparam><type>string</type><parameter>username</parameter></methodparam> - <methodparam><type>string</type><parameter>password</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>db</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>charset</parameter></methodparam> - </methodsynopsis> - <para> - <function>ociplogon</function> creates a persistent connection to - an Oracle 8 database and logs on. The optional third parameter - can either contain the name of the local Oracle instance or the - name of the entry in tnsnames.ora to which you want to connect. - If the optional third parameter is not specified, PHP uses the - environment variables <varname>ORACLE_SID</varname> (Oracle instance) - or <varname>TWO_TASK</varname> - (tnsnames.ora) to determine which database to connect to. - </para> - &oci.charset; - <note> - <para> - This function was renamed to <function>oci_pconnect</function> - after PHP >= 5.0.0. For downward compatibility - <function>ociplogon</function> can also be used. - This is deprecated, however. - </para> - </note> - </refsect1> - </refentry> + <refsect1 role="description"> + &reftitle.description; + <simpara> + &info.function.alias; + <function>oci_pconnect</function>. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/ociresult.xml?r1=1.8&r2=1.9&ty=u Index: phpdoc/en/reference/oci8/functions/ociresult.xml diff -u phpdoc/en/reference/oci8/functions/ociresult.xml:1.8 phpdoc/en/reference/oci8/functions/ociresult.xml:1.9 --- phpdoc/en/reference/oci8/functions/ociresult.xml:1.8 Tue Aug 3 13:25:33 2004 +++ phpdoc/en/reference/oci8/functions/ociresult.xml Tue Sep 6 16:18:30 2005 @@ -1,46 +1,20 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- -DO NOT TRANSLATE THIS FILE. -THE FUNCTION IT DESCRIBES WAS RENAMED AND THIS NAME IS DEPRECATED. -PLEASE, TRANSLATE THE APPROPRIATE NEW FILE. +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.9 $ --> +<refentry id="function.ociresult"> + <refnamediv> + <refname>ociresult</refname> + <refpurpose>&Alias; <function>oci_result</function></refpurpose> + </refnamediv> ---> -<!-- splitted from ./en/functions/oci8.xml, last change in rev 1.2 --> - <refentry id="function.ociresult"> - <refnamediv> - <refname>ociresult</refname> - <refpurpose>Returns column value for fetched row</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>mixed</type><methodname>ociresult</methodname> - <methodparam><type>resource</type><parameter>statement</parameter></methodparam> - <methodparam><type>mixed</type><parameter>col</parameter></methodparam> - </methodsynopsis> - <para> - <function>ociresult</function> returns the data for column - <parameter>column</parameter> in the current row (see - <function>ocifetch</function>). <function>ociresult</function> will - return everything as strings except for abstract types (ROWIDs, - LOBs and FILEs). - </para> - <para> - You can either use the column-number (1-Based) or the column-name, - in uppercase, for the <parameter>col</parameter> parameter. - </para> - <note> - <para> - This function was renamed to <function>oci_result</function> - after PHP >= 5.0.0. For downward compatibility - <function>ociresult</function> can also be used. - This is deprecated, however. - </para> - </note> - </refsect1> - </refentry> + <refsect1 role="description"> + &reftitle.description; + <simpara> + &info.function.alias; + <function>oci_result</function>. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/ocirollback.xml?r1=1.7&r2=1.8&ty=u Index: phpdoc/en/reference/oci8/functions/ocirollback.xml diff -u phpdoc/en/reference/oci8/functions/ocirollback.xml:1.7 phpdoc/en/reference/oci8/functions/ocirollback.xml:1.8 --- phpdoc/en/reference/oci8/functions/ocirollback.xml:1.7 Thu Apr 15 07:54:42 2004 +++ phpdoc/en/reference/oci8/functions/ocirollback.xml Tue Sep 6 16:18:30 2005 @@ -1,39 +1,20 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> -<!-- -DO NOT TRANSLATE THIS FILE. -THE FUNCTION IT DESCRIBES WAS RENAMED AND THIS NAME IS DEPRECATED. -PLEASE, TRANSLATE THE APPROPRIATE NEW FILE. +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.8 $ --> +<refentry id="function.ocirollback"> + <refnamediv> + <refname>ocirollback</refname> + <refpurpose>&Alias; <function>oci_rollback</function></refpurpose> + </refnamediv> ---> -<!-- splitted from ./en/functions/oci8.xml, last change in rev 1.2 --> - <refentry id="function.ocirollback"> - <refnamediv> - <refname>ocirollback</refname> - <refpurpose>Rolls back outstanding transactions</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>ocirollback</methodname> - <methodparam><type>resource</type><parameter>connection</parameter></methodparam> - </methodsynopsis> - <para> - <function>ocirollback</function> rolls back all outstanding - statements for Oracle connection <parameter>connection</parameter>. - &return.success; - </para> - <note> - <para> - This function was renamed to <function>oci_rollback</function> - after PHP >= 5.0.0. For downward compatibility - <function>ocirollback</function> can also be used. - This is deprecated, however. - </para> - </note> - </refsect1> - </refentry> + <refsect1 role="description"> + &reftitle.description; + <simpara> + &info.function.alias; + <function>oci_rollback</function>. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/ocirowcount.xml?r1=1.11&r2=1.12&ty=u Index: phpdoc/en/reference/oci8/functions/ocirowcount.xml diff -u phpdoc/en/reference/oci8/functions/ocirowcount.xml:1.11 phpdoc/en/reference/oci8/functions/ocirowcount.xml:1.12 --- phpdoc/en/reference/oci8/functions/ocirowcount.xml:1.11 Tue Aug 3 13:25:33 2004 +++ phpdoc/en/reference/oci8/functions/ocirowcount.xml Tue Sep 6 16:18:30 2005 @@ -1,66 +1,20 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- -DO NOT TRANSLATE THIS FILE. -THE FUNCTION IT DESCRIBES WAS RENAMED AND THIS NAME IS DEPRECATED. -PLEASE, TRANSLATE THE APPROPRIATE NEW FILE. +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.12 $ --> +<refentry id="function.ocirowcount"> + <refnamediv> + <refname>ocirowcount</refname> + <refpurpose>&Alias; <function>oci_num_rows</function></refpurpose> + </refnamediv> ---> -<!-- splitted from ./en/functions/oci8.xml, last change in rev 1.2 --> - <refentry id="function.ocirowcount"> - <refnamediv> - <refname>ocirowcount</refname> - <refpurpose>Gets the number of affected rows</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>ocirowcount</methodname> - <methodparam><type>resource</type><parameter>stmt</parameter></methodparam> - </methodsynopsis> - <para> - <function>ocirowcount</function> returns the number of rows affected - for e.g. update-statements. This function will not tell you the number - of rows that a select will return! - </para> - <para> - <example> - <title><function>ocirowcount</function> example</title> - <programlisting role="php"> -<![CDATA[ -<?php - echo "<pre>"; - $conn = OCILogon("scott", "tiger"); - $stmt = OCIParse($conn, "create table emp2 as select * from emp"); - OCIExecute($stmt); - echo OCIRowCount($stmt) . " rows inserted.<br />"; - OCIFreeStatement($stmt); - $stmt = OCIParse($conn, "delete from emp2"); - OCIExecute($stmt); - echo OCIRowCount($stmt) . " rows deleted.<br />"; - OCICommit($conn); - OCIFreeStatement($stmt); - $stmt = OCIParse($conn, "drop table emp2"); - OCIExecute($stmt); - OCIFreeStatement($stmt); - OCILogOff($conn); - echo "</pre>"; -?> -]]> - </programlisting> - </example> - </para> - <note> - <para> - This function was renamed to <function>oci_num_rows</function> - after PHP >= 5.0.0. For downward compatibility - <function>ocirowcount</function> can also be used. - This is deprecated, however. - </para> - </note> - </refsect1> - </refentry> + <refsect1 role="description"> + &reftitle.description; + <simpara> + &info.function.alias; + <function>oci_num_rows</function>. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/ocisavelob.xml?r1=1.9&r2=1.10&ty=u Index: phpdoc/en/reference/oci8/functions/ocisavelob.xml diff -u phpdoc/en/reference/oci8/functions/ocisavelob.xml:1.9 phpdoc/en/reference/oci8/functions/ocisavelob.xml:1.10 --- phpdoc/en/reference/oci8/functions/ocisavelob.xml:1.9 Thu Apr 15 07:54:42 2004 +++ phpdoc/en/reference/oci8/functions/ocisavelob.xml Tue Sep 6 16:18:30 2005 @@ -1,34 +1,20 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- -DO NOT TRANSLATE THIS FILE. -THE FUNCTION IT DESCRIBES WAS RENAMED AND THIS NAME IS DEPRECATED. -PLEASE, TRANSLATE THE APPROPRIATE NEW FILE. +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.10 $ --> +<refentry id="function.ocisavelob"> + <refnamediv> + <refname>ocisavelob</refname> + <refpurpose>&Alias; <xref linkend="function.oci-lob-save" /></refpurpose> + </refnamediv> ---> -<!-- splitted from ./en/functions/oci8.xml, last change in rev 1.23 --> - <refentry id="function.ocisavelob"> - <refnamediv> - <refname>ocisavelob</refname> - <refpurpose>Saves a large object </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>ocisavelob</methodname> - <void /> - </methodsynopsis> - <note> - <para> - This function was renamed to <function>oci_lob_save</function> - after PHP >= 5.0.0. For downward compatibility - <function>ocisavelob</function> can also be used. - This is deprecated, however. - </para> - </note> - </refsect1> - </refentry> + <refsect1 role="description"> + &reftitle.description; + <simpara> + &info.function.alias; + <xref linkend="function.oci-lob-save" />. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/ocisavelobfile.xml?r1=1.9&r2=1.10&ty=u Index: phpdoc/en/reference/oci8/functions/ocisavelobfile.xml diff -u phpdoc/en/reference/oci8/functions/ocisavelobfile.xml:1.9 phpdoc/en/reference/oci8/functions/ocisavelobfile.xml:1.10 --- phpdoc/en/reference/oci8/functions/ocisavelobfile.xml:1.9 Thu Apr 15 07:54:42 2004 +++ phpdoc/en/reference/oci8/functions/ocisavelobfile.xml Tue Sep 6 16:18:30 2005 @@ -1,34 +1,20 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- -DO NOT TRANSLATE THIS FILE. -THE FUNCTION IT DESCRIBES WAS RENAMED AND THIS NAME IS DEPRECATED. -PLEASE, TRANSLATE THE APPROPRIATE NEW FILE. +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.10 $ --> +<refentry id="function.ocisavelobfile"> + <refnamediv> + <refname>ocisavelobfile</refname> + <refpurpose>&Alias; <xref linkend="function.oci-lob-import" /></refpurpose> + </refnamediv> ---> -<!-- splitted from ./en/functions/oci8.xml, last change in rev 1.23 --> - <refentry id="function.ocisavelobfile"> - <refnamediv> - <refname>ocisavelobfile</refname> - <refpurpose>Saves a large object file</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>ocisavelobfile</methodname> - <void /> - </methodsynopsis> - <note> - <para> - This function was renamed to <function>oci_lob_import</function> - after PHP >= 5.0.0. For downward compatibility - <function>ocisavelobfile</function> can also be used. - This is deprecated, however. - </para> - </note> - </refsect1> - </refentry> + <refsect1 role="description"> + &reftitle.description; + <simpara> + &info.function.alias; + <xref linkend="function.oci-lob-import" />. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/ociserverversion.xml?r1=1.8&r2=1.9&ty=u Index: phpdoc/en/reference/oci8/functions/ociserverversion.xml diff -u phpdoc/en/reference/oci8/functions/ociserverversion.xml:1.8 phpdoc/en/reference/oci8/functions/ociserverversion.xml:1.9 --- phpdoc/en/reference/oci8/functions/ociserverversion.xml:1.8 Thu Apr 15 07:54:42 2004 +++ phpdoc/en/reference/oci8/functions/ociserverversion.xml Tue Sep 6 16:18:30 2005 @@ -1,49 +1,20 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- -DO NOT TRANSLATE THIS FILE. -THE FUNCTION IT DESCRIBES WAS RENAMED AND THIS NAME IS DEPRECATED. -PLEASE, TRANSLATE THE APPROPRIATE NEW FILE. +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.9 $ --> +<refentry id="function.ociserverversion"> + <refnamediv> + <refname>ociserverversion</refname> + <refpurpose>&Alias; <function>oci_server_version</function></refpurpose> + </refnamediv> ---> -<!-- splitted from ./en/functions/oci8.xml, last change in rev 1.2 --> - <refentry id="function.ociserverversion"> - <refnamediv> - <refname>ociserverversion</refname> - <refpurpose>Return a string containing server version - information</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>string</type><methodname>ociserverversion</methodname> - <methodparam><type>resource</type><parameter>conn</parameter></methodparam> - </methodsynopsis> - <para> - <example> - <title><function>ociserverversion</function> example</title> - <programlisting role="php"> -<![CDATA[ -<?php - $conn = OCILogon("scott", "tiger"); - echo "Server Version: " . OCIServerVersion($conn); - OCILogOff($conn); -?> -]]> - </programlisting> - </example> - </para> - <note> - <para> - This function was renamed to <function>oci_server_version</function> - after PHP >= 5.0.0. For downward compatibility - <function>ociserverversion</function> can also be used. - This is deprecated, however. - </para> - </note> - </refsect1> - </refentry> + <refsect1 role="description"> + &reftitle.description; + <simpara> + &info.function.alias; + <function>oci_server_version</function>. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/ocisetprefetch.xml?r1=1.7&r2=1.8&ty=u Index: phpdoc/en/reference/oci8/functions/ocisetprefetch.xml diff -u phpdoc/en/reference/oci8/functions/ocisetprefetch.xml:1.7 phpdoc/en/reference/oci8/functions/ocisetprefetch.xml:1.8 --- phpdoc/en/reference/oci8/functions/ocisetprefetch.xml:1.7 Thu Apr 15 07:54:42 2004 +++ phpdoc/en/reference/oci8/functions/ocisetprefetch.xml Tue Sep 6 16:18:30 2005 @@ -1,39 +1,20 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> -<!-- -DO NOT TRANSLATE THIS FILE. -THE FUNCTION IT DESCRIBES WAS RENAMED AND THIS NAME IS DEPRECATED. -PLEASE, TRANSLATE THE APPROPRIATE NEW FILE. +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.8 $ --> +<refentry id="function.ocisetprefetch"> + <refnamediv> + <refname>ocisetprefetch</refname> + <refpurpose>&Alias; <function>oci_set_prefetch</function></refpurpose> + </refnamediv> ---> -<!-- splitted from ./en/functions/oci8.xml, last change in rev 1.23 --> - <refentry id="function.ocisetprefetch"> - <refnamediv> - <refname>ocisetprefetch</refname> - <refpurpose>Sets number of rows to be prefetched</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>ocisetprefetch</methodname> - <methodparam><type>resource</type><parameter>stmt</parameter></methodparam> - <methodparam><type>int</type><parameter>rows</parameter></methodparam> - </methodsynopsis> - <para> - Sets the number of top level rows to be prefetched to <parameter>rows</parameter>. - The default value for <parameter>rows</parameter> is 1 row. - </para> - <note> - <para> - This function was renamed to <function>oci_set_prefetch</function> - after PHP >= 5.0.0. For downward compatibility - <function>ocisetprefetch</function> can also be used. - This is deprecated, however. - </para> - </note> - </refsect1> - </refentry> + <refsect1 role="description"> + &reftitle.description; + <simpara> + &info.function.alias; + <function>oci_set_prefetch</function>. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/ocistatementtype.xml?r1=1.10&r2=1.11&ty=u Index: phpdoc/en/reference/oci8/functions/ocistatementtype.xml diff -u phpdoc/en/reference/oci8/functions/ocistatementtype.xml:1.10 phpdoc/en/reference/oci8/functions/ocistatementtype.xml:1.11 --- phpdoc/en/reference/oci8/functions/ocistatementtype.xml:1.10 Thu Apr 15 07:54:42 2004 +++ phpdoc/en/reference/oci8/functions/ocistatementtype.xml Tue Sep 6 16:18:30 2005 @@ -1,69 +1,20 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- -DO NOT TRANSLATE THIS FILE. -THE FUNCTION IT DESCRIBES WAS RENAMED AND THIS NAME IS DEPRECATED. -PLEASE, TRANSLATE THE APPROPRIATE NEW FILE. +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.11 $ --> +<refentry id="function.ocistatementtype"> + <refnamediv> + <refname>ocistatementtype</refname> + <refpurpose>&Alias; <function>oci_statement_type</function></refpurpose> + </refnamediv> ---> -<!-- splitted from ./en/functions/oci8.xml, last change in rev 1.2 --> - <refentry id="function.ocistatementtype"> - <refnamediv> - <refname>ocistatementtype</refname> - <refpurpose>Return the type of an OCI statement</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>string</type><methodname>ocistatementtype</methodname> - <methodparam><type>resource</type><parameter>stmt</parameter></methodparam> - </methodsynopsis> - <para> - <function>ocistatementtype</function> returns one of the following - values: - <orderedlist> - <listitem><simpara><literal>SELECT</literal></simpara></listitem> - <listitem><simpara><literal>UPDATE</literal></simpara></listitem> - <listitem><simpara><literal>DELETE</literal></simpara></listitem> - <listitem><simpara><literal>INSERT</literal></simpara></listitem> - <listitem><simpara><literal>CREATE</literal></simpara></listitem> - <listitem><simpara><literal>DROP</literal></simpara></listitem> - <listitem><simpara><literal>ALTER</literal></simpara></listitem> - <listitem><simpara><literal>BEGIN</literal></simpara></listitem> - <listitem><simpara><literal>DECLARE</literal></simpara></listitem> - <listitem><simpara><literal>UNKNOWN</literal></simpara></listitem> - </orderedlist></para> - <para> - <example> - <title><function>ocistatementtype</function> examples</title> - <programlisting role="php"> -<![CDATA[ -<?php - $conn = OCILogon("scott", "tiger"); - $sql = "delete from emp where deptno = 10"; - - $stmt = OCIParse($conn, $sql); - if (OCIStatementType($stmt) == "DELETE") { - die("You are not allowed to delete from this table<br />"); - } - - OCILogoff($conn); -?> -]]> - </programlisting> - </example> - </para> - <note> - <para> - This function was renamed to <function>oci_statement_type</function> - after PHP >= 5.0.0. For downward compatibility - <function>ocistatementtype</function> can also be used. - This is deprecated, however. - </para> - </note> - </refsect1> - </refentry> + <refsect1 role="description"> + &reftitle.description; + <simpara> + &info.function.alias; + <function>oci_statement_type</function>. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/ociwritelobtofile.xml?r1=1.9&r2=1.10&ty=u Index: phpdoc/en/reference/oci8/functions/ociwritelobtofile.xml diff -u phpdoc/en/reference/oci8/functions/ociwritelobtofile.xml:1.9 phpdoc/en/reference/oci8/functions/ociwritelobtofile.xml:1.10 --- phpdoc/en/reference/oci8/functions/ociwritelobtofile.xml:1.9 Thu Apr 15 07:54:42 2004 +++ phpdoc/en/reference/oci8/functions/ociwritelobtofile.xml Tue Sep 6 16:18:30 2005 @@ -1,36 +1,20 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- -DO NOT TRANSLATE THIS FILE. -THE FUNCTION IT DESCRIBES WAS RENAMED AND THIS NAME IS DEPRECATED. -PLEASE, TRANSLATE THE APPROPRIATE NEW FILE. +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.10 $ --> +<refentry id="function.ociwritelobtofile"> + <refnamediv> + <refname>ociwritelobtofile</refname> + <refpurpose>&Alias; <xref linkend="function.oci-lob-export" /></refpurpose> + </refnamediv> ---> -<!-- splitted from ./en/functions/oci8.xml, last change in rev 1.23 --> - <refentry id="function.ociwritelobtofile"> - <refnamediv> - <refname>ociwritelobtofile</refname> - <refpurpose>Saves a large object file</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>ociwritelobtofile</methodname> - <methodparam choice="opt"><type>string</type><parameter>filename</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>start</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam> - </methodsynopsis> - <note> - <para> - This function was renamed to <function>oci_lob_export</function> - after PHP >= 5.0.0. For downward compatibility - <function>ociwritelobtofile</function> can also be used. - This is deprecated, however. - </para> - </note> - </refsect1> - </refentry> + <refsect1 role="description"> + &reftitle.description; + <simpara> + &info.function.alias; + <xref linkend="function.oci-lob-export" />. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/ociwritetemporarylob.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc/en/reference/oci8/functions/ociwritetemporarylob.xml diff -u phpdoc/en/reference/oci8/functions/ociwritetemporarylob.xml:1.4 phpdoc/en/reference/oci8/functions/ociwritetemporarylob.xml:1.5 --- phpdoc/en/reference/oci8/functions/ociwritetemporarylob.xml:1.4 Thu Apr 15 07:54:42 2004 +++ phpdoc/en/reference/oci8/functions/ociwritetemporarylob.xml Tue Sep 6 16:18:30 2005 @@ -1,35 +1,20 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- -DO NOT TRANSLATE THIS FILE. -THE FUNCTION IT DESCRIBES WAS RENAMED AND THIS NAME IS DEPRECATED. -PLEASE, TRANSLATE THE APPROPRIATE NEW FILE. +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.5 $ --> +<refentry id="function.ociwritetemporarylob"> + <refnamediv> + <refname>ociwritetemporarylob</refname> + <refpurpose>&Alias; <xref linkend="function.oci-lob-writetemporary" /></refpurpose> + </refnamediv> ---> -<!-- splitted from ./en/functions/oci8.xml, last change in rev 1.23 --> - <refentry id="function.ociwritetemporarylob"> - <refnamediv> - <refname>ociwritetemporarylob</refname> - <refpurpose>Writes temporary blob</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>ociwritetemporarylob</methodname> - <methodparam><type>string</type><parameter>var</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>lob_type</parameter></methodparam> - </methodsynopsis> - <note> - <para> - This function was renamed to <function>oci_lob_write_temporary</function> - after PHP >= 5.0.0. For downward compatibility - <function>ociwritetemporarylob</function> can also be used. - This is deprecated, however. - </para> - </note> - </refsect1> - </refentry> + <refsect1 role="description"> + &reftitle.description; + <simpara> + &info.function.alias; + <xref linkend="function.oci-lob-writetemporary" />. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/co.php/phpdoc/en/reference/oci8/ini.xml?r=1.1&p=1 Index: phpdoc/en/reference/oci8/ini.xml +++ phpdoc/en/reference/oci8/ini.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <section id="oci8.configuration"> &reftitle.runtime; &extension.runtime; <para> <table> <title>OCI8 Configuration Options</title> <tgroup cols="4"> <thead> <row> <entry>Name</entry> <entry>Default</entry> <entry>Changeable</entry> <entry>Changelog</entry> </row> </thead> <tbody> <row> <entry>oci8.privileged_connect</entry> <entry>"0"</entry> <entry>PHP_INI_SYSTEM</entry> <entry>Became available in oci8 module version 1.1</entry> </row> <row> <entry>oci8.max_persistent</entry> <entry>"-1"</entry> <entry>PHP_INI_SYSTEM</entry> <entry>Became available in oci8 module version 1.1</entry> </row> <row> <entry>oci8.persistent_timeout</entry> <entry>"-1"</entry> <entry>PHP_INI_SYSTEM</entry> <entry>Became available in oci8 module version 1.1</entry> </row> <row> <entry>oci8.ping_interval</entry> <entry>"60"</entry> <entry>PHP_INI_SYSTEM</entry> <entry>Became available in oci8 module version 1.1</entry> </row> <row> <entry>oci8.statement_cache_size</entry> <entry>"20"</entry> <entry>PHP_INI_SYSTEM</entry> <entry>Became available in oci8 module version 1.1</entry> </row> <row> <entry>oci8.default_prefetch</entry> <entry>"10"</entry> <entry>PHP_INI_SYSTEM</entry> <entry>Became available in oci8 module version 1.1</entry> </row> <row> <entry>oci8.old_oci_close_semantics</entry> <entry>"0"</entry> <entry>PHP_INI_SYSTEM</entry> <entry>Became available in oci8 module version 1.1</entry> </row> </tbody> </tgroup> </table> </para> &ini.descriptions.title; <para> <variablelist> <varlistentry id="ini.oci8.privileged_connect"> <term> <parameter>oci8.privileged_connect</parameter> <type>boolean</type> </term> <listitem> <para> This option enables privileged connections using external credentials (<constant>OCI_SYSOPER</constant>, <constant>OCI_SYSDBA</constant>). </para> </listitem> </varlistentry> <varlistentry id="ini.oci8.max_persistent"> <term> <parameter>oci8.max_persistent</parameter> <type>int</type> </term> <listitem> <para> The maximum number of persistent OCI8 connections per process. Setting this option to -1 means that there is no limit. </para> </listitem> </varlistentry> <varlistentry id="ini.oci8.persistent_timeout"> <term> <parameter>oci8.persistent_timeout</parameter> <type>int</type> </term> <listitem> <para> The maximum length of time (in seconds) that a given process is allowed to maintain an idle persistent connection. Setting this option to -1 means that idle persistent connections will be maintained forever. </para> </listitem> </varlistentry> <varlistentry id="ini.oci8.ping_interval"> <term> <parameter>oci8.ping_interval</parameter> <type>int</type> </term> <listitem> <para> The length of time (in seconds) that must pass before issuing a ping during <function>oci_pconnect</function>. When set to 0, persistent connections will be pinged every time they are reused. To disable pings completely, set this option to -1. </para> <note> <simpara> Disabling pings will cause <function>oci_pconnect</function> calls to operate at the highest efficiency, but may cause PHP to not detect faulty connections, such as those caused by network partitions, or if the Oracle server has gone down since PHP connected, until later in the script. Consult the <function>oci_pconnect</function> documentation for more information. </simpara> </note> </listitem> </varlistentry> <varlistentry id="ini.oci8.statement_cache_size"> <term> <parameter>oci8.statement_cache_size</parameter> <type>int</type> </term> <listitem> <para> This option enables statement caching, and specifies how many statements to cache. To disable statement caching just set this option to 0. </para> <note> <simpara> A larger cache can result in improved performance, at the cost of increased memory usage. </simpara> </note> </listitem> </varlistentry> <varlistentry id="ini.oci8.default_prefetch"> <term> <parameter>oci8.default_prefetch</parameter> <type>int</type> </term> <listitem> <para> This option enables statement prefetching and sets the default number of rows that will be fetched automatically after statement execution. </para> <note> <simpara> A larger prefetch can result in improved performance, at the cost of increased memory usage. </simpara> </note> </listitem> </varlistentry> <varlistentry id="ini.oci8.old_oci_close_semantics"> <term> <parameter>oci8.old_oci_close_semantics</parameter> <type>boolean</type> </term> <listitem> <para> This option controls <function>oci_close</function> behaviour. Enabling it means that <function>oci_close</function> will do nothing; the connection will not be closed until the end of the script. This is for backward compatibility only. If you find that you need to enable this setting, you are <emphasis>strongly encouraged</emphasis> to remove the <function>oci_close</function> calls from your application instead of enabling this option. </para> </listitem> </varlistentry> </variablelist> </para> </section> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->