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>insert</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="db_multiset.html" title="Chapter 8. Db_multiset" /> 11 <link rel="prev" href="stldb_multisetdstr_db_multiset.html" title="~db_multiset" /> 12 <link rel="next" href="stldb_multiseterase.html" title="erase" /> 13 </head> 14 <body> 15 <div class="navheader"> 16 <table width="100%" summary="Navigation header"> 17 <tr> 18 <th colspan="3" align="center"> 19insert 20</th> 21 </tr> 22 <tr> 23 <td width="20%" align="left"><a accesskey="p" href="stldb_multisetdstr_db_multiset.html">Prev</a> </td> 24 <th width="60%" align="center">Chapter 8. 25 Db_multiset </th> 26 <td width="20%" align="right"> <a accesskey="n" href="stldb_multiseterase.html">Next</a></td> 27 </tr> 28 </table> 29 <hr /> 30 </div> 31 <div class="sect1" lang="en" xml:lang="en"> 32 <div class="titlepage"> 33 <div> 34 <div> 35 <h2 class="title" style="clear: both"><a id="stldb_multisetinsert"></a> 36insert 37</h2> 38 </div> 39 </div> 40 </div> 41 <div class="sect2" lang="en" xml:lang="en"> 42 <div class="titlepage"> 43 <div> 44 <div> 45 <h3 class="title"><a id="func_details"></a> 46Function Details</h3> 47 </div> 48 </div> 49 </div> 50 <pre class="programlisting"> 51iterator insert(const value_type &x) 52 </pre> 53 <div class="sect3" lang="en" xml:lang="en"> 54 <div class="titlepage"></div> 55 <p>Insert a single key if the key is not in the container. </p> 56 <p></p> 57 </div> 58 <div class="sect3" lang="en" xml:lang="en"> 59 <div class="titlepage"> 60 <div> 61 <div> 62 <h4 class="title"><a id="id1556589"></a> 63Parameters</h4> 64 </div> 65 </div> 66 </div> 67 <div class="sect4" lang="en" xml:lang="en"> 68 <div class="titlepage"> 69 <div> 70 <div> 71 <h5 class="title"><a id="id1556995"></a> 72 x </h5> 73 </div> 74 </div> 75 </div> 76 <p>The key to insert. </p> 77 </div> 78 </div> 79 <div class="sect3" lang="en" xml:lang="en"> 80 <div class="titlepage"> 81 <div> 82 <div> 83 <h4 class="title"><a id="id1556969"></a> 84Return Value</h4> 85 </div> 86 </div> 87 </div> 88 <p>An iterator positioned on the newly inserted key. If the key x already exists, an invalid iterator equal to that returned by <a class="link" href="stldb_mapend.html" title="end">end()</a> 89 function is returned. </p> 90 </div> 91 <pre class="programlisting"> 92iterator insert(iterator position, 93 const value_type &x) 94 </pre> 95 <div class="sect3" lang="en" xml:lang="en"> 96 <div class="titlepage"></div> 97 <p>Insert a single key with hint if the key is not in the container. </p> 98 <p>The hint position is ignored because Berkeley DB controls where to insert the key. </p> 99 </div> 100 <div class="sect3" lang="en" xml:lang="en"> 101 <div class="titlepage"> 102 <div> 103 <div> 104 <h4 class="title"><a id="id1556681"></a> 105Parameters</h4> 106 </div> 107 </div> 108 </div> 109 <div class="sect4" lang="en" xml:lang="en"> 110 <div class="titlepage"> 111 <div> 112 <div> 113 <h5 class="title"><a id="id1556762"></a> 114 x </h5> 115 </div> 116 </div> 117 </div> 118 <p>The key to insert. </p> 119 </div> 120 <div class="sect4" lang="en" xml:lang="en"> 121 <div class="titlepage"> 122 <div> 123 <div> 124 <h5 class="title"><a id="id1556684"></a> 125 position </h5> 126 </div> 127 </div> 128 </div> 129 <p>The hint insert position, ignored. </p> 130 </div> 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="id1557014"></a> 137Return Value</h4> 138 </div> 139 </div> 140 </div> 141 <p>An iterator positioned on the newly inserted key. If the key x already exists, an invalid iterator equal to that returned by <a class="link" href="stldb_mapend.html" title="end">end()</a> 142 function is returned. </p> 143 </div> 144 <pre class="programlisting"> 145void insert(InputIterator first, 146 InputIterator last) 147 </pre> 148 <div class="sect3" lang="en" xml:lang="en"> 149 <div class="titlepage"></div> 150 <p>Range insertion. </p> 151 <p>Insert a range [first, last) of key/data pairs into this container. </p> 152 </div> 153 <div class="sect3" lang="en" xml:lang="en"> 154 <div class="titlepage"> 155 <div> 156 <div> 157 <h4 class="title"><a id="id1556641"></a> 158Parameters</h4> 159 </div> 160 </div> 161 </div> 162 <div class="sect4" lang="en" xml:lang="en"> 163 <div class="titlepage"> 164 <div> 165 <div> 166 <h5 class="title"><a id="id1557026"></a> 167 last </h5> 168 </div> 169 </div> 170 </div> 171 <p>The open boundary of the range. </p> 172 </div> 173 <div class="sect4" lang="en" xml:lang="en"> 174 <div class="titlepage"> 175 <div> 176 <div> 177 <h5 class="title"><a id="id1556959"></a> 178 first </h5> 179 </div> 180 </div> 181 </div> 182 <p>The closed boundary of the range. </p> 183 </div> 184 </div> 185 <pre class="programlisting"> 186void insert(db_set_iterator< kdt, value_type_sub > &first, 187 db_set_iterator< kdt, 188 value_type_sub > &last) 189 </pre> 190 <div class="sect3" lang="en" xml:lang="en"> 191 <div class="titlepage"></div> 192 <p>Range insertion. </p> 193 <p>Insert a range [first, last) of key/data pairs into this container. </p> 194 </div> 195 <div class="sect3" lang="en" xml:lang="en"> 196 <div class="titlepage"> 197 <div> 198 <div> 199 <h4 class="title"><a id="id1556518"></a> 200Parameters</h4> 201 </div> 202 </div> 203 </div> 204 <div class="sect4" lang="en" xml:lang="en"> 205 <div class="titlepage"> 206 <div> 207 <div> 208 <h5 class="title"><a id="id1556686"></a> 209 last </h5> 210 </div> 211 </div> 212 </div> 213 <p>The open boundary of the range. </p> 214 </div> 215 <div class="sect4" lang="en" xml:lang="en"> 216 <div class="titlepage"> 217 <div> 218 <div> 219 <h5 class="title"><a id="id1557130"></a> 220 first </h5> 221 </div> 222 </div> 223 </div> 224 <p>The closed boundary of the range. </p> 225 </div> 226 </div> 227 <pre class="programlisting"> 228void insert(db_set_base_iterator< kdt > &first, 229 db_set_base_iterator< kdt > &last) 230 </pre> 231 <div class="sect3" lang="en" xml:lang="en"> 232 <div class="titlepage"></div> 233 <p>Range insertion. </p> 234 <p>Insert a range [first, last) of key/data pairs into this container. </p> 235 </div> 236 <div class="sect3" lang="en" xml:lang="en"> 237 <div class="titlepage"> 238 <div> 239 <div> 240 <h4 class="title"><a id="id1556869"></a> 241Parameters</h4> 242 </div> 243 </div> 244 </div> 245 <div class="sect4" lang="en" xml:lang="en"> 246 <div class="titlepage"> 247 <div> 248 <div> 249 <h5 class="title"><a id="id1557028"></a> 250 last </h5> 251 </div> 252 </div> 253 </div> 254 <p>The open boundary of the range. </p> 255 </div> 256 <div class="sect4" lang="en" xml:lang="en"> 257 <div class="titlepage"> 258 <div> 259 <div> 260 <h5 class="title"><a id="id1557194"></a> 261 first </h5> 262 </div> 263 </div> 264 </div> 265 <p>The closed boundary of the range. </p> 266 </div> 267 </div> 268 </div> 269 <div class="sect2" lang="en" xml:lang="en"> 270 <div class="titlepage"> 271 <div> 272 <div> 273 <h3 class="title"><a id="id1556875"></a> 274Group: Insert Functions</h3> 275 </div> 276 </div> 277 </div> 278 <div class="simplesect" lang="en" xml:lang="en"> 279 <div class="titlepage"></div> 280 <p><a class="ulink" href="http://www.cplusplus.com/reference/stl/multiset/insert/" target="_top">http://www.cplusplus.com/reference/stl/multiset/insert/</a> </p> 281 </div> 282 <p> 283</p> 284 </div> 285 <div class="sect2" lang="en" xml:lang="en"> 286 <div class="titlepage"> 287 <div> 288 <div> 289 <h3 class="title"><a id="id1557307"></a> 290Class</h3> 291 </div> 292 </div> 293 </div> 294 <p> 295 <a class="link" href="db_multiset.html" title="Chapter 8. Db_multiset"> 296 db_multiset</a> 297 </p> 298 </div> 299 </div> 300 <div class="navfooter"> 301 <hr /> 302 <table width="100%" summary="Navigation footer"> 303 <tr> 304 <td width="40%" align="left"><a accesskey="p" href="stldb_multisetdstr_db_multiset.html">Prev</a> </td> 305 <td width="20%" align="center"> 306 <a accesskey="u" href="db_multiset.html">Up</a> 307 </td> 308 <td width="40%" align="right"> <a accesskey="n" href="stldb_multiseterase.html">Next</a></td> 309 </tr> 310 <tr> 311 <td width="40%" align="left" valign="top"> 312~db_multiset 313 </td> 314 <td width="20%" align="center"> 315 <a accesskey="h" href="index.html">Home</a> 316 </td> 317 <td width="40%" align="right" valign="top"> 318erase 319</td> 320 </tr> 321 </table> 322 </div> 323 </body> 324</html> 325