docs/api_reference/C/DB_MULTIPLE_KEY_WRITE_NEXT.html

   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_KEY_WRITE_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_RESERVE_NEXT.html" title="DB_MULTIPLE_RESERVE_NEXT" />
  12     <link rel="next" href="DB_MULTIPLE_KEY_RESERVE_NEXT.html" title="DB_MULTIPLE_KEY_RESERVE_NEXT" />
  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_KEY_WRITE_NEXT</th>
  22         </tr>
  23         <tr>
  24           <td width="20%" align="left"><a accesskey="p" href="DB_MULTIPLE_RESERVE_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="DB_MULTIPLE_KEY_RESERVE_NEXT.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_KEY_WRITE_NEXT"></a>DB_MULTIPLE_KEY_WRITE_NEXT</h2>
  38           </div>
  39         </div>
  40       </div>
  41       <pre class="programlisting">#include &lt;db.h&gt;
  42
  43 DB_MULTIPLE_KEY_WRITE_NEXT(void *pointer, DBT *dbt,
  44     void *key, size_t klen, void *data, size_t dlen); </pre>
  45       <p>
  46             Appends a key / data pair to the 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="idp59161880"></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="idp59142072"></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_WRITE_INIT.html" title="DB_MULTIPLE_WRITE_INIT">DB_MULTIPLE_WRITE_INIT</a>.
  68                      </p>
  69           <p>
  70                          This parameter is set to NULL if the data item does not
  71                          fit in the buffer.
  72                      </p>
  73         </div>
  74         <div class="sect3" lang="en" xml:lang="en">
  75           <div class="titlepage">
  76             <div>
  77               <div>
  78                 <h4 class="title"><a id="idp59165560"></a>dbt</h4>
  79               </div>
  80             </div>
  81           </div>
  82           <p>
  83                         The <span class="bold"><strong>dbt</strong></span> parameter is
  84                         a <a class="link" href="dbt.html" title="Chapter 4.  The DBT Handle">DBT</a> structure
  85                         initialized with
  86                         <a class="xref" href="DB_MULTIPLE_WRITE_INIT.html" title="DB_MULTIPLE_WRITE_INIT">DB_MULTIPLE_WRITE_INIT</a>.
  87                      </p>
  88         </div>
  89         <div class="sect3" lang="en" xml:lang="en">
  90           <div class="titlepage">
  91             <div>
  92               <div>
  93                 <h4 class="title"><a id="idp59158616"></a>key</h4>
  94               </div>
  95             </div>
  96           </div>
  97           <p>
  98                          A pointer to the bytes for the key to be copied into the bulk 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="idp59165160"></a>klen</h4>
 106               </div>
 107             </div>
 108           </div>
 109           <p>
 110                          The number of bytes to be copied for the key.
 111                      </p>
 112         </div>
 113         <div class="sect3" lang="en" xml:lang="en">
 114           <div class="titlepage">
 115             <div>
 116               <div>
 117                 <h4 class="title"><a id="idp59185576"></a>data</h4>
 118               </div>
 119             </div>
 120           </div>
 121           <p>
 122                          A pointer to the bytes for the data item to be copied
 123                          into the bulk buffer.
 124                      </p>
 125         </div>
 126         <div class="sect3" lang="en" xml:lang="en">
 127           <div class="titlepage">
 128             <div>
 129               <div>
 130                 <h4 class="title"><a id="idp59186008"></a>dlen</h4>
 131               </div>
 132             </div>
 133           </div>
 134           <p>
 135                          The number of bytes to be copied for the data item.
 136                      </p>
 137         </div>
 138       </div>
 139       <div class="sect2" lang="en" xml:lang="en">
 140         <div class="titlepage">
 141           <div>
 142             <div>
 143               <h3 class="title"><a id="idp59176872"></a>Class</h3>
 144             </div>
 145           </div>
 146         </div>
 147         <p>
 148                 <a class="link" href="dbt.html" title="Chapter 4.  The DBT Handle">DBT</a>
 149             </p>
 150       </div>
 151       <div class="sect2" lang="en" xml:lang="en">
 152         <div class="titlepage">
 153           <div>
 154             <div>
 155               <h3 class="title"><a id="idp59141968"></a>See Also</h3>
 156             </div>
 157           </div>
 158         </div>
 159         <p>
 160                      <a class="xref" href="dbt.html#dbtlist" title="DBT and Bulk Operations">DBT and Bulk Operations</a>
 161                 </p>
 162       </div>
 163     </div>
 164     <div class="navfooter">
 165       <hr />
 166       <table width="100%" summary="Navigation footer">
 167         <tr>
 168           <td width="40%" align="left"><a accesskey="p" href="DB_MULTIPLE_RESERVE_NEXT.html">Prev</a> </td>
 169           <td width="20%" align="center">
 170             <a accesskey="u" href="dbt.html">Up</a>
 171           </td>
 172           <td width="40%" align="right"> <a accesskey="n" href="DB_MULTIPLE_KEY_RESERVE_NEXT.html">Next</a></td>
 173         </tr>
 174         <tr>
 175           <td width="40%" align="left" valign="top">DB_MULTIPLE_RESERVE_NEXT </td>
 176           <td width="20%" align="center">
 177             <a accesskey="h" href="index.html">Home</a>
 178           </td>
 179           <td width="40%" align="right" valign="top"> DB_MULTIPLE_KEY_RESERVE_NEXT</td>
 180         </tr>
 181       </table>
 182     </div>
 183   </body>
 184 </html>