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_set.html" title="Chapter 7. Db_set" /> 11 <link rel="prev" href="stldb_setdstr_db_set.html" title="~db_set" /> 12 <link rel="next" href="stldb_setoperator_assign.html" title="operator=" /> 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_setdstr_db_set.html">Prev</a> </td> 24 <th width="60%" align="center">Chapter 7. 25 Db_set </th> 26 <td width="20%" align="right"> <a accesskey="n" href="stldb_setoperator_assign.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_setinsert"></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"> 51insert(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/data pair 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="id1555865"></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="id1555941"></a> 72 x </h5> 73 </div> 74 </div> 75 </div> 76 <p>The key/data pair 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="id1555866"></a> 84Return Value</h4> 85 </div> 86 </div> 87 </div> 88 <p>A pair P, if insert OK, i.e. the inserted key wasn't in the container, P.first will be the iterator positioned on the inserted key/data pair, and P.second is true; otherwise P.first is an invalid iterator equal to that returned by <a class="link" href="stldb_mapend.html" title="end">end()</a> 89 and P.second is false. </p> 90 </div> 91 <pre class="programlisting"> 92void insert(const_iterator &first, 93 const_iterator &last) 94 </pre> 95 <div class="sect3" lang="en" xml:lang="en"> 96 <div class="titlepage"></div> 97 <p>Range insertion. </p> 98 <p>Insert a range [first, last) of key/data pairs into this container. </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="id1555644"></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="id1555928"></a> 114 last </h5> 115 </div> 116 </div> 117 </div> 118 <p>The open boundary of the range. </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="id1556076"></a> 125 first </h5> 126 </div> 127 </div> 128 </div> 129 <p>The closed boundary of the range. </p> 130 </div> 131 </div> 132 <pre class="programlisting"> 133void insert(iterator &first, 134 iterator &last) 135 </pre> 136 <div class="sect3" lang="en" xml:lang="en"> 137 <div class="titlepage"></div> 138 <p>Range insertion. </p> 139 <p>Insert a range [first, last) of key/data pairs into this container. </p> 140 </div> 141 <div class="sect3" lang="en" xml:lang="en"> 142 <div class="titlepage"> 143 <div> 144 <div> 145 <h4 class="title"><a id="id1555916"></a> 146Parameters</h4> 147 </div> 148 </div> 149 </div> 150 <div class="sect4" lang="en" xml:lang="en"> 151 <div class="titlepage"> 152 <div> 153 <div> 154 <h5 class="title"><a id="id1556041"></a> 155 last </h5> 156 </div> 157 </div> 158 </div> 159 <p>The open boundary of the range. </p> 160 </div> 161 <div class="sect4" lang="en" xml:lang="en"> 162 <div class="titlepage"> 163 <div> 164 <div> 165 <h5 class="title"><a id="id1555828"></a> 166 first </h5> 167 </div> 168 </div> 169 </div> 170 <p>The closed boundary of the range. </p> 171 </div> 172 </div> 173 <pre class="programlisting"> 174iterator insert(iterator position, 175 const value_type &x) 176 </pre> 177 <div class="sect3" lang="en" xml:lang="en"> 178 <div class="titlepage"></div> 179 <p>Insert with hint position. </p> 180 <p>We ignore the hint position because Berkeley DB knows better where to insert. </p> 181 </div> 182 <div class="sect3" lang="en" xml:lang="en"> 183 <div class="titlepage"> 184 <div> 185 <div> 186 <h4 class="title"><a id="id1555930"></a> 187Parameters</h4> 188 </div> 189 </div> 190 </div> 191 <div class="sect4" lang="en" xml:lang="en"> 192 <div class="titlepage"> 193 <div> 194 <div> 195 <h5 class="title"><a id="id1556058"></a> 196 position </h5> 197 </div> 198 </div> 199 </div> 200 <p>The hint position. </p> 201 </div> 202 <div class="sect4" lang="en" xml:lang="en"> 203 <div class="titlepage"> 204 <div> 205 <div> 206 <h5 class="title"><a id="id1555639"></a> 207 x </h5> 208 </div> 209 </div> 210 </div> 211 <p>The key/data pair to insert. </p> 212 </div> 213 </div> 214 <div class="sect3" lang="en" xml:lang="en"> 215 <div class="titlepage"> 216 <div> 217 <div> 218 <h4 class="title"><a id="id1556126"></a> 219Return Value</h4> 220 </div> 221 </div> 222 </div> 223 <p>The iterator positioned on the inserted key/data pair, or an invalid iterator if the key was already in the container. </p> 224 </div> 225 <pre class="programlisting"> 226void insert(InputIterator first, 227 InputIterator last) 228 </pre> 229 <div class="sect3" lang="en" xml:lang="en"> 230 <div class="titlepage"></div> 231 <p>Range insertion. </p> 232 <p>Insert a range [first, last) of key/data pairs into this container. </p> 233 </div> 234 <div class="sect3" lang="en" xml:lang="en"> 235 <div class="titlepage"> 236 <div> 237 <div> 238 <h4 class="title"><a id="id1555115"></a> 239Parameters</h4> 240 </div> 241 </div> 242 </div> 243 <div class="sect4" lang="en" xml:lang="en"> 244 <div class="titlepage"> 245 <div> 246 <div> 247 <h5 class="title"><a id="id1555973"></a> 248 last </h5> 249 </div> 250 </div> 251 </div> 252 <p>The open boundary of the range. </p> 253 </div> 254 <div class="sect4" lang="en" xml:lang="en"> 255 <div class="titlepage"> 256 <div> 257 <div> 258 <h5 class="title"><a id="id1556170"></a> 259 first </h5> 260 </div> 261 </div> 262 </div> 263 <p>The closed boundary of the range. </p> 264 </div> 265 </div> 266 </div> 267 <div class="sect2" lang="en" xml:lang="en"> 268 <div class="titlepage"> 269 <div> 270 <div> 271 <h3 class="title"><a id="id1555860"></a> 272Group: Insert Functions</h3> 273 </div> 274 </div> 275 </div> 276 <div class="simplesect" lang="en" xml:lang="en"> 277 <div class="titlepage"></div> 278 <p><a class="ulink" href="http://www.cplusplus.com/reference/stl/set/insert/" target="_top">http://www.cplusplus.com/reference/stl/set/insert/</a> </p> 279 </div> 280 <p> 281</p> 282 </div> 283 <div class="sect2" lang="en" xml:lang="en"> 284 <div class="titlepage"> 285 <div> 286 <div> 287 <h3 class="title"><a id="id1555604"></a> 288Class</h3> 289 </div> 290 </div> 291 </div> 292 <p> 293 <a class="link" href="db_set.html" title="Chapter 7. Db_set"> 294 db_set</a> 295 </p> 296 </div> 297 </div> 298 <div class="navfooter"> 299 <hr /> 300 <table width="100%" summary="Navigation footer"> 301 <tr> 302 <td width="40%" align="left"><a accesskey="p" href="stldb_setdstr_db_set.html">Prev</a> </td> 303 <td width="20%" align="center"> 304 <a accesskey="u" href="db_set.html">Up</a> 305 </td> 306 <td width="40%" align="right"> <a accesskey="n" href="stldb_setoperator_assign.html">Next</a></td> 307 </tr> 308 <tr> 309 <td width="40%" align="left" valign="top"> 310~db_set 311 </td> 312 <td width="20%" align="center"> 313 <a accesskey="h" href="index.html">Home</a> 314 </td> 315 <td width="40%" align="right" valign="top"> 316operator= 317</td> 318 </tr> 319 </table> 320 </div> 321 </body> 322</html> 323