File: oci-fetch-all.xml

package info (click to toggle)
php-doc 20061001-1
  • links: PTS
  • area: non-free
  • in suites: etch, etch-m68k
  • size: 45,764 kB
  • ctags: 1,611
  • sloc: xml: 502,485; php: 7,645; cpp: 500; makefile: 297; perl: 161; sh: 141; awk: 28
file content (126 lines) | stat: -rw-r--r-- 3,778 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.7 $ -->
  <refentry id="function.oci-fetch-all">
   <refnamediv>
    <refname>oci_fetch_all</refname>
    <refpurpose>Fetches all rows of result data into an array</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>int</type><methodname>oci_fetch_all</methodname>
      <methodparam><type>resource</type><parameter>statement</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>
    <para> 
     <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 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
     rows to read, starting at the <parameter>skip</parameter>th row
     (default to -1, meaning all the rows).
    </para>
    &database.fetch-null;
    <para>
     Parameter <parameter>flags</parameter> can be any combination of 
     the following: 
     <simplelist>
      <member>
       <constant>OCI_FETCHSTATEMENT_BY_ROW</constant>
      </member>
      <member>
       <constant>OCI_FETCHSTATEMENT_BY_COLUMN</constant> (default value)
      </member>
      <member>
       <constant>OCI_NUM</constant>
      </member>
      <member>
       <constant>OCI_ASSOC</constant>
      </member>
     </simplelist>
    </para> 
    <para>
     <example>
      <title><function>oci_fetch_all</function> example</title>
      <programlisting role="php">
<![CDATA[
<?php
/* oci_fetch_all example mbritton at verinet dot com (990624) */

$conn = oci_connect("scott", "tiger");

$stmt = oci_parse($conn, "select * from emp");

oci_execute($stmt);

$nrows = oci_fetch_all($stmt, $results);
if ($nrows > 0) {
   echo "<table border=\"1\">\n";
   echo "<tr>\n";
   foreach ($results as $key => $val) {
      echo "<th>$key</th>\n";
   }
   echo "</tr>\n";
   
   for ($i = 0; $i < $nrows; $i++) {
      echo "<tr>\n";
      foreach ($results as $data) {
         echo "<td>$data[$i]</td>\n";
      }
      echo "</tr>\n";
   }
   echo "</table>\n";
} else {
   echo "No data found<br />\n";
}      
echo "$nrows Records Selected<br />\n";
 
oci_free_statement($stmt);
oci_close($conn);
?>
]]>
      </programlisting>
     </example>
    </para>
    &oci.datatypes;
    <para>
     <function>oci_fetch_all</function> returns &false; in case of error.
    </para>
    <note>
     <para>
      In PHP versions before 5.0.0 you must use <function>ocifetchstatement</function> instead. 
      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>
   </refsect1>
  </refentry>

<!-- 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
-->