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>Chapter 8. Db_multiset</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++ Standard Template Library API Reference" /> 10 <link rel="up" href="index.html" title="Berkeley DB C++ Standard Template Library API Reference" /> 11 <link rel="prev" href="stldb_setoperator_ueq.html" title="operator!=" /> 12 <link rel="next" href="stldb_multisetdstr_db_multiset.html" title="~db_multiset" /> 13 </head> 14 <body> 15 <div class="navheader"> 16 <table width="100%" summary="Navigation header"> 17 <tr> 18 <th colspan="3" align="center">Chapter 8. 19 Db_multiset </th> 20 </tr> 21 <tr> 22 <td width="20%" align="left"><a accesskey="p" href="stldb_setoperator_ueq.html">Prev</a> </td> 23 <th width="60%" align="center"> </th> 24 <td width="20%" align="right"> <a accesskey="n" href="stldb_multisetdstr_db_multiset.html">Next</a></td> 25 </tr> 26 </table> 27 <hr /> 28 </div> 29 <div class="chapter" lang="en" xml:lang="en"> 30 <div class="titlepage"> 31 <div> 32 <div> 33 <h2 class="title"><a id="db_multiset"></a>Chapter 8. 34 Db_multiset </h2> 35 </div> 36 </div> 37 </div> 38 <p>This class is the combination of std::multiset and hash_multiset. </p> 39 <p>By setting database handles of DB_BTREE or DB_HASH type respectively, you will be using the equivalent of std::multiset or hash_multiset respectively. This container stores the key in the key element of a key/data pair in the underlying database, but doesn't store anything in the data element. Database and environment handle requirement: The requirement to these handles is the same as that to <a class="link" href="db_multimap.html" title="Chapter 6. Db_multimap">db_multimap</a> 40. </p> 41 <h4><a id="id1555976"></a> 42See Also 43</h4> 44 <p> </p> 45 <p><a class="link" href="db_multimap.html" title="Chapter 6. Db_multimap">db_multimap</a> 46 <a class="link" href="db_map.html" title="Chapter 5. Db_map">db_map</a> 47 <a class="link" href="db_container.html" title="Chapter 3. Db_container">db_container</a> 48 <a class="link" href="db_set.html" title="Chapter 7. Db_set">db_set</a> 49 </p> 50 <div class="sect2" lang="en" xml:lang="en"> 51 <div class="titlepage"> 52 <div> 53 <div> 54 <h3 class="title"><a id="id1556389"></a> 55Class Template Parameters</h3> 56 </div> 57 </div> 58 </div> 59 <div class="sect3" lang="en" xml:lang="en"> 60 <div class="titlepage"> 61 <div> 62 <div> 63 <h4 class="title"><a id="id1556414"></a> 64kdt</h4> 65 </div> 66 </div> 67 </div> 68 <p>The key data type. </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="id1556439"></a> 75value_type_sub</h4> 76 </div> 77 </div> 78 </div> 79 <p>If kdt is a class/struct type, do not specify anything in this parameter; Otherwise specify ElementHolder<kdt>. </p> 80 </div> 81 </div> 82 <h4><a id="id1556454"></a> Public Members </h4> 83 <div class="informaltable"> 84 <table border="1" width="80%"> 85 <colgroup> 86 <col /> 87 <col /> 88 </colgroup> 89 <thead> 90 <tr> 91 <th>Member</th> 92 <th>Description</th> 93 </tr> 94 </thead> 95 <tbody> 96 <tr> 97 <td> 98<a class="xref" href="db_multiset.html#stldb_multisetdb_multiset" title="db_multiset"> 99db_multiset 100</a> 101</td> 102 <td> 103 <p>Create a std::multiset/hash_multiset equivalent associative container. </p> </td> 104 </tr> 105 <tr> 106 <td> 107<a class="xref" href="stldb_multisetdstr_db_multiset.html" title="~db_multiset"> 108~db_multiset 109</a> 110</td> 111 <td> 112 </td> 113 </tr> 114 <tr> 115 <td> 116<a class="xref" href="stldb_multisetinsert.html" title="insert"> 117insert 118</a> 119</td> 120 <td> 121 <p>Insert a single key if the key is not in the container. </p> </td> 122 </tr> 123 <tr> 124 <td> 125<a class="xref" href="stldb_multiseterase.html" title="erase"> 126erase 127</a> 128</td> 129 <td> 130 <p>Erase elements by key. </p> </td> 131 </tr> 132 <tr> 133 <td> 134<a class="xref" href="stldb_multisetoperator_assign.html" title="operator="> 135operator= 136</a> 137</td> 138 <td> 139 <p>Container content assignment operator. </p> </td> 140 </tr> 141 <tr> 142 <td> 143<a class="xref" href="stldb_multisetswap.html" title="swap"> 144swap 145</a> 146</td> 147 <td> 148 <p>Swap content with another container. </p> </td> 149 </tr> 150 <tr> 151 <td> 152<a class="xref" href="stldb_multisetoperator_eq.html" title="operator=="> 153operator== 154</a> 155</td> 156 <td> 157 <p>Container content equality compare operator. </p> </td> 158 </tr> 159 <tr> 160 <td> 161<a class="xref" href="stldb_multisetoperator_ueq.html" title="operator!="> 162operator!= 163</a> 164</td> 165 <td> 166 <p>Inequality comparison operator. </p> </td> 167 </tr> 168 </tbody> 169 </table> 170 </div> 171 <h4><a id="id1556778"></a> 172Group</h4> 173 <p> 174<a class="xref" href="dbstl_containers.html" title="Chapter 2. Dbstl Container Classes"> 175 Dbstl Container Classes </a> 176</p> 177 <p> 178</p> 179 <div class="sect1" lang="en" xml:lang="en"> 180 <div class="titlepage"> 181 <div> 182 <div> 183 <h2 class="title" style="clear: both"><a id="stldb_multisetdb_multiset"></a> 184db_multiset 185</h2> 186 </div> 187 </div> 188 </div> 189 <div class="sect2" lang="en" xml:lang="en"> 190 <div class="titlepage"> 191 <div> 192 <div> 193 <h3 class="title"><a id="func_details"></a> 194Function Details</h3> 195 </div> 196 </div> 197 </div> 198 <pre class="programlisting"> 199db_multiset(Db *dbp=NULL, 200 DbEnv *envp=NULL) 201 </pre> 202 <div class="sect3" lang="en" xml:lang="en"> 203 <div class="titlepage"></div> 204 <p>Create a std::multiset/hash_multiset equivalent associative container. </p> 205 <p>See the handle requirement in class details to pass correct database/environment handles. </p> 206 </div> 207 <div class="sect3" lang="en" xml:lang="en"> 208 <div class="titlepage"> 209 <div> 210 <div> 211 <h4 class="title"><a id="id1556386"></a> 212Parameters</h4> 213 </div> 214 </div> 215 </div> 216 <div class="sect4" lang="en" xml:lang="en"> 217 <div class="titlepage"> 218 <div> 219 <div> 220 <h5 class="title"><a id="id1556591"></a> 221 dbp </h5> 222 </div> 223 </div> 224 </div> 225 <p>The database handle. </p> 226 </div> 227 <div class="sect4" lang="en" xml:lang="en"> 228 <div class="titlepage"> 229 <div> 230 <div> 231 <h5 class="title"><a id="id1556795"></a> 232 envp </h5> 233 </div> 234 </div> 235 </div> 236 <p>The database environment handle. </p> 237 </div> 238 </div> 239 <div class="sect3" lang="en" xml:lang="en"> 240 <div class="titlepage"> 241 <div> 242 <div> 243 <h4 class="title"><a id="id1556699"></a> 244See Also</h4> 245 </div> 246 </div> 247 </div> 248 <p> 249 </p> 250 <p><a class="link" href="stldb_multimapdb_multimap.html" title="db_multimap">db_multimap(Db*, DbEnv*)</a> 251 </p> 252 <p> </p> 253 </div> 254 <pre class="programlisting"> 255db_multiset(Db *dbp, DbEnv *envp, InputIterator first, 256 InputIterator last) 257 </pre> 258 <div class="sect3" lang="en" xml:lang="en"> 259 <div class="titlepage"></div> 260 <p>Iteration constructor. </p> 261 <p>Iterates between first and last, copying each of the elements in the range into this container. Create a std::multi/hash_multiset equivalent associative container. Insert a range of elements into the database. The range is [first, last), which contains elements that can be converted to type ddt automatically. This function supports auto-commit. See the handle requirement in class details to pass correct database/environment handles. </p> 262 </div> 263 <div class="sect3" lang="en" xml:lang="en"> 264 <div class="titlepage"> 265 <div> 266 <div> 267 <h4 class="title"><a id="id1556332"></a> 268Parameters</h4> 269 </div> 270 </div> 271 </div> 272 <div class="sect4" lang="en" xml:lang="en"> 273 <div class="titlepage"> 274 <div> 275 <div> 276 <h5 class="title"><a id="id1556276"></a> 277 dbp </h5> 278 </div> 279 </div> 280 </div> 281 <p>The database handle. </p> 282 </div> 283 <div class="sect4" lang="en" xml:lang="en"> 284 <div class="titlepage"> 285 <div> 286 <div> 287 <h5 class="title"><a id="id1556611"></a> 288 envp </h5> 289 </div> 290 </div> 291 </div> 292 <p>The database environment handle. </p> 293 </div> 294 <div class="sect4" lang="en" xml:lang="en"> 295 <div class="titlepage"> 296 <div> 297 <div> 298 <h5 class="title"><a id="id1556278"></a> 299 last </h5> 300 </div> 301 </div> 302 </div> 303 <p>The open boundary of the range. </p> 304 </div> 305 <div class="sect4" lang="en" xml:lang="en"> 306 <div class="titlepage"> 307 <div> 308 <div> 309 <h5 class="title"><a id="id1556922"></a> 310 first </h5> 311 </div> 312 </div> 313 </div> 314 <p>The closed boundary of the range. </p> 315 </div> 316 </div> 317 <div class="sect3" lang="en" xml:lang="en"> 318 <div class="titlepage"> 319 <div> 320 <div> 321 <h4 class="title"><a id="id1556704"></a> 322See Also</h4> 323 </div> 324 </div> 325 </div> 326 <p> 327 </p> 328 <p><a class="link" href="stldb_multimapdb_multimap.html" title="db_multimap">db_multimap(Db*, DbEnv*, InputIterator, InputIterator)</a> 329 </p> 330 <p> </p> 331 </div> 332 <pre class="programlisting"> 333db_multiset(const self &x) 334 </pre> 335 <div class="sect3" lang="en" xml:lang="en"> 336 <div class="titlepage"></div> 337 <p>Copy constructor. </p> 338 <p>Create a database and insert all key/data pairs in x into this container. x's data members are not copied. This function supports auto-commit. </p> 339 </div> 340 <div class="sect3" lang="en" xml:lang="en"> 341 <div class="titlepage"> 342 <div> 343 <div> 344 <h4 class="title"><a id="id1556636"></a> 345Parameters</h4> 346 </div> 347 </div> 348 </div> 349 <div class="sect4" lang="en" xml:lang="en"> 350 <div class="titlepage"> 351 <div> 352 <div> 353 <h5 class="title"><a id="id1556941"></a> 354 x </h5> 355 </div> 356 </div> 357 </div> 358 <p>The source container to initialize this container. </p> 359 </div> 360 </div> 361 <div class="sect3" lang="en" xml:lang="en"> 362 <div class="titlepage"> 363 <div> 364 <div> 365 <h4 class="title"><a id="id1556654"></a> 366See Also</h4> 367 </div> 368 </div> 369 </div> 370 <p> 371 </p> 372 <p>db_multimap(const db_multimap&) <a class="link" href="stldb_containerdb_container.html" title="db_container">db_container(const db_container&)</a> 373 </p> 374 <p> </p> 375 </div> 376 </div> 377 <div class="sect2" lang="en" xml:lang="en"> 378 <div class="titlepage"> 379 <div> 380 <div> 381 <h3 class="title"><a id="id1556923"></a> 382Class</h3> 383 </div> 384 </div> 385 </div> 386 <p> 387 <a class="link" href="db_multiset.html" title="Chapter 8. Db_multiset"> 388 db_multiset</a> 389 </p> 390 </div> 391 </div> 392 </div> 393 <div class="navfooter"> 394 <hr /> 395 <table width="100%" summary="Navigation footer"> 396 <tr> 397 <td width="40%" align="left"><a accesskey="p" href="stldb_setoperator_ueq.html">Prev</a> </td> 398 <td width="20%" align="center"> </td> 399 <td width="40%" align="right"> <a accesskey="n" href="stldb_multisetdstr_db_multiset.html">Next</a></td> 400 </tr> 401 <tr> 402 <td width="40%" align="left" valign="top"> 403operator!= 404 </td> 405 <td width="20%" align="center"> 406 <a accesskey="h" href="index.html">Home</a> 407 </td> 408 <td width="40%" align="right" valign="top"> 409~db_multiset 410</td> 411 </tr> 412 </table> 413 </div> 414 </body> 415</html> 416