|
Server : Apache/2.2.17 (Unix) mod_ssl/2.2.17 OpenSSL/0.9.8e-fips-rhel5 DAV/2 PHP/5.2.17 System : Linux localhost 2.6.18-419.el5 #1 SMP Fri Feb 24 22:47:42 UTC 2017 x86_64 User : nobody ( 99) PHP Version : 5.2.17 Disable Function : NONE Directory : /usr/share/doc/db4-devel-4.3.29/ref/am/ |
Upload File : |
<!--$Id: cursor.so,v 10.21 2003/10/18 19:15:52 bostic Exp $--> <!--Copyright 1997-2004 by Sleepycat Software, Inc.--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB Reference Guide: Cursor operations</title> <meta name="description" content="Berkeley DB: An embedded database programmatic toolkit."> <meta name="keywords" content="embedded,database,programmatic,toolkit,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,Java,C,C++"> </head> <body bgcolor=white> <a name="2"><!--meow--></a> <table width="100%"><tr valign=top> <td><h3><dl><dt>Berkeley DB Reference Guide:<dd>Access Methods</dl></h3></td> <td align=right><a href="../am/second.html"><img src="../../images/prev.gif" alt="Prev"></a><a href="../toc.html"><img src="../../images/ref.gif" alt="Ref"></a><a href="../am/curget.html"><img src="../../images/next.gif" alt="Next"></a> </td></tr></table> <p> <h3 align=center>Cursor operations</h3> <p>A database cursor refers to a single key/data pair in the database. It supports traversal of the database and is the only way to access individual duplicate data items. Cursors are used for operating on collections of records, for iterating over a database, and for saving handles to individual records, so that they can be modified after they have been read.</p> <p>The <a href="../../api_c/db_cursor.html">DB->cursor</a> method opens a cursor into a database. Upon return the cursor is uninitialized, cursor positioning occurs as part of the first cursor operation.</p> <p>Once a database cursor has been opened, records may be retrieved (<a href="../../api_c/dbc_get.html">DBcursor->c_get</a>), stored (<a href="../../api_c/dbc_put.html">DBcursor->c_put</a>), and deleted (<a href="../../api_c/dbc_del.html">DBcursor->c_del</a>).</p> <p>Additional operations supported by the cursor handle include duplication (<a href="../../api_c/dbc_dup.html">DBcursor->c_dup</a>), equality join (<a href="../../api_c/db_join.html">DB->join</a>), and a count of duplicate data items (<a href="../../api_c/dbc_count.html">DBcursor->c_count</a>). Cursors are eventually closed using <a href="../../api_c/dbc_close.html">DBcursor->c_close</a>.</p> <!--$Id: m4.methods,v 1.3 2004/11/03 15:52:01 bostic Exp $--> <table border=1 align=center> <tr><th>Database Cursors and Related Methods</th><th>Description</th></tr> <!--Db::cursor--><tr><td><a href="../../api_c/db_cursor.html">DB->cursor</a></td><td>Create a cursor handle</td></tr> <!--DbCursor::close--><tr><td><a href="../../api_c/dbc_close.html">DBcursor->c_close</a></td><td>Close a cursor</td></tr> <!--DbCursor::count--><tr><td><a href="../../api_c/dbc_count.html">DBcursor->c_count</a></td><td>Return count of duplicates</td></tr> <!--DbCursor::del--><tr><td><a href="../../api_c/dbc_del.html">DBcursor->c_del</a></td><td>Delete by cursor</td></tr> <!--DbCursor::dup--><tr><td><a href="../../api_c/dbc_dup.html">DBcursor->c_dup</a></td><td>Duplicate a cursor</td></tr> <!--DbCursor::get--><tr><td><a href="../../api_c/dbc_get.html">DBcursor->c_get</a>, <a href="../../api_c/dbc_get.html">DBcursor->c_pget</a></td><td>Retrieve by cursor</td></tr> <!--DbCursor::put--><tr><td><a href="../../api_c/dbc_put.html">DBcursor->c_put</a></td><td>Store by cursor</td></tr> </table> <table width="100%"><tr><td><br></td><td align=right><a href="../am/second.html"><img src="../../images/prev.gif" alt="Prev"></a><a href="../toc.html"><img src="../../images/ref.gif" alt="Ref"></a><a href="../am/curget.html"><img src="../../images/next.gif" alt="Next"></a> </td></tr></table> <p><font size=1><a href="../../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> </body> </html>