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_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_NEXT.html" title="DB_MULTIPLE_NEXT" /> 12 <link rel="next" href="DB_MULTIPLE_RECNO_NEXT.html" title="DB_MULTIPLE_RECNO_NEXT" /> 13 </head> 14 <body> 15 <div class="navheader"> 16 <table width="100%" summary="Navigation header"> 17 <tr> 18 <th colspan="3" align="center">DB_MULTIPLE_KEY_NEXT</th> 19 </tr> 20 <tr> 21 <td width="20%" align="left"><a accesskey="p" href="DB_MULTIPLE_NEXT.html">Prev</a>��</td> 22 <th width="60%" align="center">Chapter��4.�� 23 The DBT Handle 24 </th> 25 <td width="20%" align="right">��<a accesskey="n" href="DB_MULTIPLE_RECNO_NEXT.html">Next</a></td> 26 </tr> 27 </table> 28 <hr /> 29 </div> 30 <div class="sect1" lang="en" xml:lang="en"> 31 <div class="titlepage"> 32 <div> 33 <div> 34 <h2 class="title" style="clear: both"><a id="DB_MULTIPLE_KEY_NEXT"></a>DB_MULTIPLE_KEY_NEXT</h2> 35 </div> 36 </div> 37 </div> 38 <pre class="programlisting">#include <db.h> 39 40DB_MULTIPLE_KEY_NEXT(void *pointer, DBT *data, 41 void *retkey, size_t retklen, void *retdata, size_t retdlen); </pre> 42 <p> 43 If either of the 44 <a class="link" href="dbcget.html#dbcget_DB_MULTIPLE">DB_MULTIPLE</a> 45 or 46 <a class="link" href="dbcget.html#dbcget_DB_MULTIPLE_KEY">DB_MULTIPLE_KEY</a> 47 flags were specified to the <a class="xref" href="dbget.html" title="DB->get()">DB->get()</a> or 48 <a class="xref" href="dbcget.html" title="DBcursor->get()">DBcursor->get()</a> methods, the data 49 <a class="link" href="dbt.html" title="Chapter��4.�� The DBT Handle">DBT</a> returned by those interfaces will 50 refer to a buffer that is filled with data. Access to that data is through the 51 DB_MULTIPLE_* macros. 52 </p> 53 <p> 54 Returns the next <a class="link" href="dbt.html" title="Chapter��4.�� The DBT Handle">DBT</a> in the bulk 55 retrieval set. Use this macro with <a class="link" href="dbt.html" title="Chapter��4.�� The DBT Handle">DBT</a> 56 structures obtained from a database that uses the Btree or Hash 57 access methods. 58 </p> 59 <div class="sect2" lang="en" xml:lang="en"> 60 <div class="titlepage"> 61 <div> 62 <div> 63 <h3 class="title"><a id="id1658481"></a>Parameters</h3> 64 </div> 65 </div> 66 </div> 67 <div class="sect3" lang="en" xml:lang="en"> 68 <div class="titlepage"> 69 <div> 70 <div> 71 <h4 class="title"><a id="id1658572"></a>pointer</h4> 72 </div> 73 </div> 74 </div> 75 <p> 76 The <span class="bold"><strong>pointer</strong></span> parameter is a variable 77 that must have been initialized by a call to 78 <a class="xref" href="DB_MULTIPLE_INIT.html" title="DB_MULTIPLE_INIT">DB_MULTIPLE_INIT</a>. 79 </p> 80 <p> 81 This parameter is set to NULL if there are no more key/data pairs in 82 the returned set. 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="id1658364"></a>data</h4> 90 </div> 91 </div> 92 </div> 93 <p> 94 The <span class="bold"><strong>data</strong></span> parameter is a 95 <a class="link" href="dbt.html" title="Chapter��4.�� The DBT Handle">DBT</a> structure returned from a 96 successful call to <a class="xref" href="dbcget.html" title="DBcursor->get()">DBcursor->get()</a> with the Btree or Hash 97 access methods for which the 98 <a class="link" href="dbcget.html#dbcget_DB_MULTIPLE_KEY">DB_MULTIPLE_KEY</a> 99 flag was specified. 100 </p> 101 <p> 102 The <span class="bold"><strong>data</strong></span> parameter must have been initialized by 103 a call to <a class="xref" href="DB_MULTIPLE_INIT.html" title="DB_MULTIPLE_INIT">DB_MULTIPLE_INIT</a>. 104 </p> 105 </div> 106 <div class="sect3" lang="en" xml:lang="en"> 107 <div class="titlepage"> 108 <div> 109 <div> 110 <h4 class="title"><a id="id1658669"></a>retkey</h4> 111 </div> 112 </div> 113 </div> 114 <p> 115 The <span class="bold"><strong>retkey</strong></span> parameter is set 116 to the next key element in the returned set. 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="id1658618"></a>retklen</h4> 124 </div> 125 </div> 126 </div> 127 <p> 128 The <span class="bold"><strong>retklen</strong></span> parameter is set to 129 the length, in bytes, of the next key element. 130 </p> 131 </div> 132 <div class="sect3" lang="en" xml:lang="en"> 133 <div class="titlepage"> 134 <div> 135 <div> 136 <h4 class="title"><a id="id1658774"></a>retdata</h4> 137 </div> 138 </div> 139 </div> 140 <p> 141 The <span class="bold"><strong>retdata</strong></span> parameter is set 142 to the next data element in the returned set. 143 </p> 144 </div> 145 <div class="sect3" lang="en" xml:lang="en"> 146 <div class="titlepage"> 147 <div> 148 <div> 149 <h4 class="title"><a id="id1658788"></a>retdlen</h4> 150 </div> 151 </div> 152 </div> 153 <p> 154 The <span class="bold"><strong>retdlen</strong></span> parameter is set to 155 the length, in bytes, of the next data element. 156 </p> 157 </div> 158 </div> 159 <div class="sect2" lang="en" xml:lang="en"> 160 <div class="titlepage"> 161 <div> 162 <div> 163 <h3 class="title"><a id="id1658803"></a>Class</h3> 164 </div> 165 </div> 166 </div> 167 <p> 168 <a class="link" href="dbt.html" title="Chapter��4.�� The DBT Handle">DBT</a> 169 </p> 170 </div> 171 <div class="sect2" lang="en" xml:lang="en"> 172 <div class="titlepage"> 173 <div> 174 <div> 175 <h3 class="title"><a id="id1658684"></a>See Also</h3> 176 </div> 177 </div> 178 </div> 179 <p> 180 <a class="xref" href="dbt.html#dbtlist" title="DBT and Bulk Operations">DBT and Bulk Operations</a> 181 </p> 182 </div> 183 </div> 184 <div class="navfooter"> 185 <hr /> 186 <table width="100%" summary="Navigation footer"> 187 <tr> 188 <td width="40%" align="left"><a accesskey="p" href="DB_MULTIPLE_NEXT.html">Prev</a>��</td> 189 <td width="20%" align="center"> 190 <a accesskey="u" href="dbt.html">Up</a> 191 </td> 192 <td width="40%" align="right">��<a accesskey="n" href="DB_MULTIPLE_RECNO_NEXT.html">Next</a></td> 193 </tr> 194 <tr> 195 <td width="40%" align="left" valign="top">DB_MULTIPLE_NEXT��</td> 196 <td width="20%" align="center"> 197 <a accesskey="h" href="index.html">Home</a> 198 </td> 199 <td width="40%" align="right" valign="top">��DB_MULTIPLE_RECNO_NEXT</td> 200 </tr> 201 </table> 202 </div> 203 </body> 204</html> 205