Debian Codegraph @

docs/api_reference/TCL/dbc_dup.html

raw
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>dbc dup</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 TCL API Reference" />
10 <link rel="up" href="tclapi.html" title="Chapter 1.  Berkeley DB Tcl APIs" />
11 <link rel="prev" href="dbc_del.html" title="dbc del" />
12 <link rel="next" href="dbc_get.html" title="dbc get" />
13 </head>
14 <body>
15 <div xmlns="" class="navheader">
16 <div class="libver">
17 <p>Library Version 11.2.5.3</p>
18 </div>
19 <table width="100%" summary="Navigation header">
20 <tr>
21 <th colspan="3" align="center"><span xmlns="http://www.w3.org/1999/xhtml" class="emphasis"><em>dbc</em></span> dup</th>
22 </tr>
23 <tr>
24 <td width="20%" align="left"><a accesskey="p" href="dbc_del.html">Prev</a> </td>
25 <th width="60%" align="center">Chapter 1. 
26 Berkeley DB Tcl APIs
27 </th>
28 <td width="20%" align="right"> <a accesskey="n" href="dbc_get.html">Next</a></td>
29 </tr>
30 </table>
31 <hr />
32 </div>
33 <div class="sect1" lang="en" xml:lang="en">
34 <div class="titlepage">
35 <div>
36 <div>
37 <h2 class="title" style="clear: both"><a id="dbc_dup"></a><span class="emphasis"><em>dbc</em></span> dup</h2>
38 </div>
39 </div>
40 </div>
41 <pre class="programlisting">dbc dup
42 [-position] </pre>
43 <p>
44 The <span class="emphasis"><em>dbc</em></span> <span class="bold"><strong>dup</strong></span>
45 command duplicates the cursor, creates a new cursor that uses the same
46 transaction and locker ID as the original cursor. This is useful when
47 an application is using locking and requires two or more cursors in
48 the same thread of control.
49 </p>
50 <p>
51 The options are as follows:
52 </p>
53 <div class="itemizedlist">
54 <ul type="disc">
55 <li>
56 <p>
57 <span class="bold"><strong>-position</strong></span>
58 </p>
59 <p>
60 The newly created cursor is initialized to refer to the same position
61 in the database as the original cursor and hold the same locks. If the
62 <span class="bold"><strong>-position</strong></span> flag is not specified, the
63 created cursor is uninitialized and will behave like a cursor newly
64 created using the <span class="emphasis"><em>db</em></span> <span class="bold"><strong>cursor</strong></span> command.
65 </p>
66 </li>
67 </ul>
68 </div>
69 <p>
70 The <span class="emphasis"><em>dbc</em></span> <span class="bold"><strong>dup</strong></span>
71 command returns 0 on success, and in the case of error, a Tcl error is
72 thrown.
73 </p>
74 </div>
75 <div class="navfooter">
76 <hr />
77 <table width="100%" summary="Navigation footer">
78 <tr>
79 <td width="40%" align="left"><a accesskey="p" href="dbc_del.html">Prev</a> </td>
80 <td width="20%" align="center">
81 <a accesskey="u" href="tclapi.html">Up</a>
82 </td>
83 <td width="40%" align="right"> <a accesskey="n" href="dbc_get.html">Next</a></td>
84 </tr>
85 <tr>
86 <td width="40%" align="left" valign="top"><span class="emphasis"><em>dbc</em></span> del </td>
87 <td width="20%" align="center">
88 <a accesskey="h" href="index.html">Home</a>
89 </td>
90 <td width="40%" align="right" valign="top"> <span class="emphasis"><em>dbc</em></span> get</td>
91 </tr>
92 </table>
93 </div>
94 </body>
95 </html>