Edit D:\app\Administrator\product\11.2.0\dbhome_1\oc4j\j2ee\oc4j_applications\applications\em\em\online_help\tdddg\tdddg_subprograms040.htm

Edit D:\app\Administrator\product\11.2.0\dbhome_1\oc4j\j2ee\oc4j_applications\applications\em\em\online_help\tdddg\tdddg_subprograms040.htm

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<script src="./callback.js" type="text/javascript"></script>
<noscript>Your browser does not support JavaScript. This help page requires JavaScript to render correctly.</noscript>
</head>
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
<meta http-equiv="Content-Style-Type" content="text/css" />
<meta http-equiv="Content-Script-Type" content="text/javascript" />

<meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 5.1.1 Build 005" />
<meta name="date" content="2009-04-21T9:46:24Z" />
<meta name="robots" content="noarchive" />
<meta name="doctitle" content="Using a Cursor Variable to Retrieve Result Set Rows One at a Time" />
<meta name="relnum" content="11g Release 2 (11.2)" />
<meta name="partnum" content="E10766-01" />
<link rel="copyright" href="./dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
<link rel="stylesheet" href="./dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
<link rel="prev" href="tdddg_subprograms039.htm" title="Previous" type="text/html" />
<link rel="next" href="tdddg_subprograms041.htm" title="Next" type="text/html" />
<title>Using a Cursor Variable to Retrieve Result Set Rows One at a Time</title>
</head>
<body>
<div class="zz-skip-header"><a href="#BEGIN">Skip Headers</a></div>
<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
<col width="86%" />
<col width="*" />
<tr valign="bottom">
<td align="left"></td>
<td align="center"><a href="tdddg_subprograms039.htm"><img width="24" height="24" src="./dcommon/gifs/leftnav.gif" alt="Previous" /><br />
<span class="icon">Previous</span></a>&nbsp;</td>
<td align="center"><a href="tdddg_subprograms041.htm"><img width="24" height="24" src="./dcommon/gifs/rightnav.gif" alt="Next" /><br />
<span class="icon">Next</span></a></td>
</tr>
</table>
<p><a id="BABEHCAJ" name="BABEHCAJ"></a><a id="TDDDG99954" name="TDDDG99954"></a></p>
<div class="sect2">
<h1>Using a Cursor Variable to Retrieve Result Set Rows One at a Time</h1>
<a name="BEGIN" id="BEGIN"></a>
<p><a id="sthref488" name="sthref488"></a>The following procedure uses each of the necessary statements in its simplest form, but provides references to their complete syntax.</p>
<a id="TDDDG239" name="TDDDG239"></a>
<p class="subhead2">To use a cursor variable to retrieve result set rows one at a time:</p>
<ol>
<li>
<p>In the declarative part:</p>
<ol>
<li>
<p>Declare the <code>REF</code> <code>CURSOR</code> type:</p>
<pre xml:space="preserve" class="oac_no_warn">
TYPE <span class="italic">cursor_type</span> IS REF CURSOR [ RETURN <code><span class="codeinlineitalic">return_type</span></code> ];
</pre>
<p>For complete <code>REF</code> <code>CURSOR</code> type declaration syntax, see <a href="javascript:open('http://www.oracle.com/pls/db112/lookup?id=LNPLS01312','newWindow').focus()"><span class="italic">Oracle Database PL/SQL Language Reference</span></a>.</p>
</li>
<li>
<p>Declare a cursor variable of that type:</p>
<pre xml:space="preserve" class="oac_no_warn">
<span class="italic">cursor_variable cursor_type</span>;
</pre>
<p>For complete cursor variable declaration syntax, see <a href="javascript:open('http://www.oracle.com/pls/db112/lookup?id=LNPLS01312','newWindow').focus()"><span class="italic">Oracle Database PL/SQL Language Reference</span></a>.</p>
</li>
<li>
<p>Declare a record to hold the row returned by the cursor:</p>
<pre xml:space="preserve" class="oac_no_warn">
<span class="italic">record_name</span> <code><span class="codeinlineitalic">return_type</span></code>;
</pre>
<p>For complete information about record declaration syntax, see <a href="javascript:open('http://www.oracle.com/pls/db112/lookup?id=LNPLS01338','newWindow').focus()"><span class="italic">Oracle Database PL/SQL Language Reference</span></a>.</p>
</li>
</ol>
</li>
<li>
<p>In the executable part:</p>
<ol>
<li>
<p>Open the cursor variable for a specific query:</p>
<pre xml:space="preserve" class="oac_no_warn">
OPEN <span class="italic">cursor_variable</span> FOR <span class="italic">query</span>;
</pre>
<p>For complete information about <code>OPEN</code> <code>FOR</code> statement syntax, see <a href="javascript:open('http://www.oracle.com/pls/db112/lookup?id=LNPLS01333','newWindow').focus()"><span class="italic">Oracle Database PL/SQL Language Reference</span></a>.</p>
</li>
<li>
<p>Fetch rows from the cursor variable (rows from the result set) one at a time, using a <code>LOOP</code> statement that has syntax similar to this:</p>
<pre xml:space="preserve" class="oac_no_warn">
LOOP
  FETCH <span class="italic">cursor_variable</span> INTO <span class="italic">record_name</span>;
  EXIT WHEN <span class="italic">cursor_variable</span>%NOTFOUND;
  -- Process row that is in <span class="italic">record_name</span>:
  <span class="italic">statement</span>;
  [ <span class="italic">statement</span>; ]...
END LOOP;
</pre>
<p>For complete information about <code>FETCH</code> statement syntax, see <a href="javascript:open('http://www.oracle.com/pls/db112/lookup?id=LNPLS01320','newWindow').focus()"><span class="italic">Oracle Database PL/SQL Language Reference</span></a>.</p>
</li>
<li>
<p>Close the cursor variable:</p>
<pre xml:space="preserve" class="oac_no_warn">
CLOSE <span class="italic">cursor_variable</span>;
</pre>
<p>Alternatively, you can open the cursor variable for another query, which closes it for the current query.</p>
<p>For complete information about <code>CLOSE</code> statement syntax, see <a href="javascript:open('http://www.oracle.com/pls/db112/lookup?id=LNPLS01305','newWindow').focus()"><span class="italic">Oracle Database PL/SQL Language Reference</span></a>.</p>
</li>
</ol>
</li>
</ol>
<div class="helpinfonotealso">
<h2>Related Topics</h2>
<p><a href="tdddg_subprograms041.htm#BABBEABD">Tutorial: Using a Cursor Variable to Retrieve Result Set Rows One at a Time</a></p>
<p><a href="tdddg_subprograms032.htm#CIHHCJDI">Using Records and Cursors</a></p>
</div>
</div>


<div class="footer">
<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
<col width="86%" />
<col width="*" />
<tr>
<td align="left"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;1996, 2009,&nbsp;Oracle&nbsp;and/or&nbsp;its&nbsp;affiliates.&nbsp;All&nbsp;rights&nbsp;reserved.</span><br />
<a href="./dcommon/html/cpyr.htm"><span class="copyrightlogo">Legal Notices</span></a></td>
<td align="center"><a href="tdddg_subprograms039.htm"><img width="24" height="24" src="./dcommon/gifs/leftnav.gif" alt="Previous" /><br />
<span class="icon">Previous</span></a>&nbsp;</td>
<td align="center"><a href="tdddg_subprograms041.htm"><img width="24" height="24" src="./dcommon/gifs/rightnav.gif" alt="Next" /><br />
<span class="icon">Next</span></a></td>
</tr>
</table>
</div>

</body>
</html>

Ms-Dos/Windows Unix Write backup

jsp File Browser version 1.2 by www.vonloesch.de