Debian Codegraph @

docs/api_reference/C/DB_MULTIPLE_RECNO_RESERVE_NEXT.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>DB_MULTIPLE_RECNO_RESERVE_NEXT</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="dbt.html" title="Chapter 4.  The DBT Handle" />
11 <link rel="prev" href="DB_MULTIPLE_RECNO_WRITE_NEXT.html" title="DB_MULTIPLE_RECNO_WRITE_NEXT" />
12 <link rel="next" href="env.html" title="Chapter 5.  The DB_ENV Handle" />
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">DB_MULTIPLE_RECNO_RESERVE_NEXT</th>
22 </tr>
23 <tr>
24 <td width="20%" align="left"><a accesskey="p" href="DB_MULTIPLE_RECNO_WRITE_NEXT.html">Prev</a> </td>
25 <th width="60%" align="center">Chapter 4. 
26 The DBT Handle
27 </th>
28 <td width="20%" align="right"> <a accesskey="n" href="env.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="DB_MULTIPLE_RECNO_RESERVE_NEXT"></a>DB_MULTIPLE_RECNO_RESERVE_NEXT</h2>
38 </div>
39 </div>
40 </div>
41 <pre class="programlisting">#include &lt;db.h&gt;
42
43 DB_MULTIPLE_RECNO_RESERVE_NEXT(void *pointer, DBT *dbt, db_recno_t recno,
44 void *ddest, size_t dlen); </pre>
45 <p>
46 Reserves space for a record number / data pair in a bulk buffer.
47 </p>
48 <div class="sect2" lang="en" xml:lang="en">
49 <div class="titlepage">
50 <div>
51 <div>
52 <h3 class="title"><a id="idp51219536"></a>Parameters</h3>
53 </div>
54 </div>
55 </div>
56 <div class="sect3" lang="en" xml:lang="en">
57 <div class="titlepage">
58 <div>
59 <div>
60 <h4 class="title"><a id="idp51211896"></a>pointer</h4>
61 </div>
62 </div>
63 </div>
64 <p>
65 The <span class="bold"><strong>pointer</strong></span> parameter
66 is a variable that must have been initialized by a call
67 to <a class="xref" href="DB_MULTIPLE_RECNO_WRITE_INIT.html" title="DB_MULTIPLE_RECNO_WRITE_INIT">DB_MULTIPLE_RECNO_WRITE_INIT</a>.
68 </p>
69 </div>
70 <div class="sect3" lang="en" xml:lang="en">
71 <div class="titlepage">
72 <div>
73 <div>
74 <h4 class="title"><a id="idp51213712"></a>dbt</h4>
75 </div>
76 </div>
77 </div>
78 <p>
79 The <span class="bold"><strong>dbt</strong></span> parameter is
80 a <a class="link" href="dbt.html" title="Chapter 4.  The DBT Handle">DBT</a> structure
81 initialized with
82 <a class="xref" href="DB_MULTIPLE_RECNO_WRITE_INIT.html" title="DB_MULTIPLE_RECNO_WRITE_INIT">DB_MULTIPLE_RECNO_WRITE_INIT</a>.
83 </p>
84 </div>
85 <div class="sect3" lang="en" xml:lang="en">
86 <div class="titlepage">
87 <div>
88 <div>
89 <h4 class="title"><a id="idp51214896"></a>recno</h4>
90 </div>
91 </div>
92 </div>
93 <p>
94 The record number to be copied into the bulk buffer.
95 </p>
96 <p>
97 This parameter is set to 0 if the data item does not
98 fit in the buffer.
99 </p>
100 </div>
101 <div class="sect3" lang="en" xml:lang="en">
102 <div class="titlepage">
103 <div>
104 <div>
105 <h4 class="title"><a id="idp51234720"></a>ddest</h4>
106 </div>
107 </div>
108 </div>
109 <p>
110 The <span class="bold"><strong>ddest</strong></span> parameter is
111 set to the location reserved in the bulk buffer for the
112 data item.
113 </p>
114 <p>
115 This parameter is set to NULL if the data item does not
116 fit in the buffer.
117 </p>
118 </div>
119 <div class="sect3" lang="en" xml:lang="en">
120 <div class="titlepage">
121 <div>
122 <div>
123 <h4 class="title"><a id="idp51221176"></a>dlen</h4>
124 </div>
125 </div>
126 </div>
127 <p>
128 The number of bytes to be reserved.
129 </p>
130 </div>
131 </div>
132 <div class="sect2" lang="en" xml:lang="en">
133 <div class="titlepage">
134 <div>
135 <div>
136 <h3 class="title"><a id="idp51203288"></a>Class</h3>
137 </div>
138 </div>
139 </div>
140 <p>
141 <a class="link" href="dbt.html" title="Chapter 4.  The DBT Handle">DBT</a>
142 </p>
143 </div>
144 <div class="sect2" lang="en" xml:lang="en">
145 <div class="titlepage">
146 <div>
147 <div>
148 <h3 class="title"><a id="idp51220872"></a>See Also</h3>
149 </div>
150 </div>
151 </div>
152 <p>
153 <a class="xref" href="dbt.html#dbtlist" title="DBT and Bulk Operations">DBT and Bulk Operations</a>
154 </p>
155 </div>
156 </div>
157 <div class="navfooter">
158 <hr />
159 <table width="100%" summary="Navigation footer">
160 <tr>
161 <td width="40%" align="left"><a accesskey="p" href="DB_MULTIPLE_RECNO_WRITE_NEXT.html">Prev</a> </td>
162 <td width="20%" align="center">
163 <a accesskey="u" href="dbt.html">Up</a>
164 </td>
165 <td width="40%" align="right"> <a accesskey="n" href="env.html">Next</a></td>
166 </tr>
167 <tr>
168 <td width="40%" align="left" valign="top">DB_MULTIPLE_RECNO_WRITE_NEXT </td>
169 <td width="20%" align="center">
170 <a accesskey="h" href="index.html">Home</a>
171 </td>
172 <td width="40%" align="right" valign="top"> Chapter 5. 
173 The DB_ENV Handle
174 </td>
175 </tr>
176 </table>
177 </div>
178 </body>
179 </html>