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_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_KEY_NEXT.html" title="DB_MULTIPLE_KEY_NEXT" /> 12 <link rel="next" href="DB_MULTIPLE_WRITE_INIT.html" title="DB_MULTIPLE_WRITE_INIT" /> 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_RECNO_NEXT</th> 19 </tr> 20 <tr> 21 <td width="20%" align="left"><a accesskey="p" href="DB_MULTIPLE_KEY_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_WRITE_INIT.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_RECNO_NEXT"></a>DB_MULTIPLE_RECNO_NEXT</h2> 35 </div> 36 </div> 37 </div> 38 <pre class="programlisting">#include <db.h> 39 40DB_MULTIPLE_RECNO_NEXT(void *pointer, DBT *data, 41 db_recno_t recno, 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 Queue or Recno 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="id1658658"></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="id1658811"></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="id1658849"></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 Queue or Recno 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="id1658852"></a>recno</h4> 111 </div> 112 </div> 113 </div> 114 <p> 115 The <span class="bold"><strong>recno</strong></span> parameter is set 116 to the record number of the next record in the 117 returned set. 118 </p> 119 </div> 120 <div class="sect3" lang="en" xml:lang="en"> 121 <div class="titlepage"> 122 <div> 123 <div> 124 <h4 class="title"><a id="id1658988"></a>retdata</h4> 125 </div> 126 </div> 127 </div> 128 <p> 129 The <span class="bold"><strong>retdata</strong></span> 130 parameter is set to the next data element in the returned set. 131 Deleted records are not included in the results. 132 </p> 133 </div> 134 <div class="sect3" lang="en" xml:lang="en"> 135 <div class="titlepage"> 136 <div> 137 <div> 138 <h4 class="title"><a id="id1659023"></a>retdlen</h4> 139 </div> 140 </div> 141 </div> 142 <p> 143 The <span class="bold"><strong>retdlen</strong></span> parameter is set to 144 the length, in bytes, of the next data element. 145 </p> 146 </div> 147 </div> 148 <div class="sect2" lang="en" xml:lang="en"> 149 <div class="titlepage"> 150 <div> 151 <div> 152 <h3 class="title"><a id="id1659038"></a>Class</h3> 153 </div> 154 </div> 155 </div> 156 <p> 157 <a class="link" href="dbt.html" title="Chapter��4.�� The DBT Handle">DBT</a> 158 </p> 159 </div> 160 <div class="sect2" lang="en" xml:lang="en"> 161 <div class="titlepage"> 162 <div> 163 <div> 164 <h3 class="title"><a id="id1658643"></a>See Also</h3> 165 </div> 166 </div> 167 </div> 168 <p> 169 <a class="xref" href="dbt.html#dbtlist" title="DBT and Bulk Operations">DBT and Bulk Operations</a> 170 </p> 171 </div> 172 </div> 173 <div class="navfooter"> 174 <hr /> 175 <table width="100%" summary="Navigation footer"> 176 <tr> 177 <td width="40%" align="left"><a accesskey="p" href="DB_MULTIPLE_KEY_NEXT.html">Prev</a>��</td> 178 <td width="20%" align="center"> 179 <a accesskey="u" href="dbt.html">Up</a> 180 </td> 181 <td width="40%" align="right">��<a accesskey="n" href="DB_MULTIPLE_WRITE_INIT.html">Next</a></td> 182 </tr> 183 <tr> 184 <td width="40%" align="left" valign="top">DB_MULTIPLE_KEY_NEXT��</td> 185 <td width="20%" align="center"> 186 <a accesskey="h" href="index.html">Home</a> 187 </td> 188 <td width="40%" align="right" valign="top">��DB_MULTIPLE_WRITE_INIT</td> 189 </tr> 190 </table> 191 </div> 192 </body> 193</html> 194