1<?xml version="1.0" encoding="UTF-8" standalone="no"?> 2<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 3<html xmlns="http://www.w3.org/1999/xhtml"> 4 <head> 5 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> 6 <title>Chapter 3. The Dbc Handle</title> 7 <link rel="stylesheet" href="apiReference.css" type="text/css" /> 8 <meta name="generator" content="DocBook XSL Stylesheets V1.73.2" /> 9 <link rel="start" href="index.html" title="Berkeley DB C++ API Reference" /> 10 <link rel="up" href="index.html" title="Berkeley DB C++ API Reference" /> 11 <link rel="prev" href="dbverify.html" title="Db::verify()" /> 12 <link rel="next" href="dbcursor.html" title="Db::cursor()" /> 13 </head> 14 <body> 15 <div class="navheader"> 16 <table width="100%" summary="Navigation header"> 17 <tr> 18 <th colspan="3" align="center">Chapter 3. 19 The Dbc Handle 20 </th> 21 </tr> 22 <tr> 23 <td width="20%" align="left"><a accesskey="p" href="dbverify.html">Prev</a> </td> 24 <th width="60%" align="center"> </th> 25 <td width="20%" align="right"> <a accesskey="n" href="dbcursor.html">Next</a></td> 26 </tr> 27 </table> 28 <hr /> 29 </div> 30 <div class="chapter" lang="en" xml:lang="en"> 31 <div class="titlepage"> 32 <div> 33 <div> 34 <h2 class="title"><a id="dbc"></a>Chapter 3. 35 The Dbc Handle 36 </h2> 37 </div> 38 </div> 39 </div> 40 <p> 41 A Dbc object is a handle for a cursor into a Berkeley 42 DB database. 43 </p> 44 <p> 45 Dbc handles are not free-threaded. Cursor 46 handles may be shared by multiple threads if access is 47 serialized by the application. 48 </p> 49 <p> 50 You create a Dbc using the 51 <a class="xref" href="dbcursor.html" title="Db::cursor()">Db::cursor()</a> 52 method. 53 </p> 54 <p> 55 If the cursor is to be used to perform operations on behalf 56 of a transaction, the cursor must be opened and closed 57 within the context of that single transaction. 58 </p> 59 <p> 60 Once <a class="xref" href="dbcclose.html" title="Dbc::close()">Dbc::close()</a> has 61 been called, the handle may not be accessed again, 62 regardless of the method's return. 63 </p> 64 <div class="sect1" lang="en" xml:lang="en"> 65 <div class="titlepage"> 66 <div> 67 <div> 68 <h2 class="title" style="clear: both"><a id="dbclist"></a>Database Cursors and Related Methods</h2> 69 </div> 70 </div> 71 </div> 72 <div class="navtable"> 73 <table border="1" width="80%"> 74 <thead> 75 <tr> 76 <th>Database Cursors and Related Methods</th> 77 <th>Description</th> 78 </tr> 79 </thead> 80 <tbody> 81 <tr> 82 <td> 83 <a class="xref" href="dbcursor.html" title="Db::cursor()">Db::cursor()</a> 84 </td> 85 <td>Create a cursor handle</td> 86 </tr> 87 <tr> 88 <td> 89 <a class="xref" href="dbcclose.html" title="Dbc::close()">Dbc::close()</a> 90 </td> 91 <td>Close a cursor handle</td> 92 </tr> 93 <tr> 94 <td> 95 <a class="xref" href="dbccmp.html" title="Dbc::cmp()">Dbc::cmp()</a> 96 </td> 97 <td>Compare two cursors for equality.</td> 98 </tr> 99 <tr> 100 <td> 101 <a class="xref" href="dbccount.html" title="Dbc::count()">Dbc::count()</a> 102 </td> 103 <td>Return count of duplicates for current key</td> 104 </tr> 105 <tr> 106 <td> 107 <a class="xref" href="dbcdel.html" title="Dbc::del()">Dbc::del()</a> 108 </td> 109 <td>Delete current key/data pair</td> 110 </tr> 111 <tr> 112 <td> 113 <a class="xref" href="dbcdup.html" title="Dbc::dup()">Dbc::dup()</a> 114 </td> 115 <td>Duplicate the cursor handle</td> 116 </tr> 117 <tr> 118 <td> 119 <a class="xref" href="dbcget.html" title="Dbc::get()">Dbc::get()</a> 120 </td> 121 <td>Retrieve by cursor</td> 122 </tr> 123 <tr> 124 <td> 125 <a class="xref" href="dbcput.html" title="Dbc::put()">Dbc::put()</a> 126 </td> 127 <td>Store by cursor</td> 128 </tr> 129 <tr> 130 <td><a class="xref" href="dbcset_priority.html" title="Dbc::set_priority()">Dbc::set_priority()</a>, <a class="xref" href="dbcget_priority.html" title="Dbc::get_priority()">Dbc::get_priority()</a></td> 131 <td>Set/get the cursor's cache priority</td> 132 </tr> 133 </tbody> 134 </table> 135 </div> 136 </div> 137 </div> 138 <div class="navfooter"> 139 <hr /> 140 <table width="100%" summary="Navigation footer"> 141 <tr> 142 <td width="40%" align="left"><a accesskey="p" href="dbverify.html">Prev</a> </td> 143 <td width="20%" align="center"> </td> 144 <td width="40%" align="right"> <a accesskey="n" href="dbcursor.html">Next</a></td> 145 </tr> 146 <tr> 147 <td width="40%" align="left" valign="top">Db::verify() </td> 148 <td width="20%" align="center"> 149 <a accesskey="h" href="index.html">Home</a> 150 </td> 151 <td width="40%" align="right" valign="top"> Db::cursor()</td> 152 </tr> 153 </table> 154 </div> 155 </body> 156</html> 157