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_map.html" title="Chapter 5. Db_map" /> 11 <link rel="prev" href="stldb_mapdstr_db_map.html" title="~db_map" /> 12 <link rel="next" href="stldb_mapbegin.html" title="begin" /> 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_mapdstr_db_map.html">Prev</a> </td> 24 <th width="60%" align="center">Chapter 5. 25 Db_map </th> 26 <td width="20%" align="right"> <a accesskey="n" href="stldb_mapbegin.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_mapinsert"></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="id1550816"></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="id1550855"></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="id1550670"></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 sitting on the inserted key/data pair, and P.second is true; otherwise P.first is an invalid iterator and P.second is false. </p> 89 </div> 90 <pre class="programlisting"> 91iterator insert(iterator position, 92 const value_type &x) 93 </pre> 94 <div class="sect3" lang="en" xml:lang="en"> 95 <div class="titlepage"></div> 96 <p>Insert with hint position. </p> 97 <p>We ignore the hint position because Berkeley DB knows better where to insert. </p> 98 </div> 99 <div class="sect3" lang="en" xml:lang="en"> 100 <div class="titlepage"> 101 <div> 102 <div> 103 <h4 class="title"><a id="id1550844"></a> 104Parameters</h4> 105 </div> 106 </div> 107 </div> 108 <div class="sect4" lang="en" xml:lang="en"> 109 <div class="titlepage"> 110 <div> 111 <div> 112 <h5 class="title"><a id="id1550885"></a> 113 position </h5> 114 </div> 115 </div> 116 </div> 117 <p>The hint position. </p> 118 </div> 119 <div class="sect4" lang="en" xml:lang="en"> 120 <div class="titlepage"> 121 <div> 122 <div> 123 <h5 class="title"><a id="id1550705"></a> 124 x </h5> 125 </div> 126 </div> 127 </div> 128 <p>The key/data pair to insert. </p> 129 </div> 130 </div> 131 <div class="sect3" lang="en" xml:lang="en"> 132 <div class="titlepage"> 133 <div> 134 <div> 135 <h4 class="title"><a id="id1550785"></a> 136Return Value</h4> 137 </div> 138 </div> 139 </div> 140 <p>The iterator sitting on the inserted key/data pair, or an invalid iterator if the key was already in the container. </p> 141 </div> 142 <pre class="programlisting"> 143void insert(const db_map_base_iterator< kdt, realddt, ddt > &first, 144 const db_map_base_iterator< kdt, realddt, 145 ddt > &last) 146 </pre> 147 <div class="sect3" lang="en" xml:lang="en"> 148 <div class="titlepage"></div> 149 <p>Range insertion. </p> 150 <p>Insert a range [first, last) of key/data pairs into this container. </p> 151 </div> 152 <div class="sect3" lang="en" xml:lang="en"> 153 <div class="titlepage"> 154 <div> 155 <div> 156 <h4 class="title"><a id="id1550748"></a> 157Parameters</h4> 158 </div> 159 </div> 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="id1550903"></a> 166 last </h5> 167 </div> 168 </div> 169 </div> 170 <p>The open boundary of the range. </p> 171 </div> 172 <div class="sect4" lang="en" xml:lang="en"> 173 <div class="titlepage"> 174 <div> 175 <div> 176 <h5 class="title"><a id="id1551011"></a> 177 first </h5> 178 </div> 179 </div> 180 </div> 181 <p>The closed boundary of the range. </p> 182 </div> 183 </div> 184 <pre class="programlisting"> 185void insert(InputIterator first, 186 InputIterator last) 187 </pre> 188 <div class="sect3" lang="en" xml:lang="en"> 189 <div class="titlepage"></div> 190 <p>Range insertion. </p> 191 <p>Insert a range [first, last) of key/data pairs into this container. </p> 192 </div> 193 <div class="sect3" lang="en" xml:lang="en"> 194 <div class="titlepage"> 195 <div> 196 <div> 197 <h4 class="title"><a id="id1549823"></a> 198Parameters</h4> 199 </div> 200 </div> 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="id1550653"></a> 207 last </h5> 208 </div> 209 </div> 210 </div> 211 <p>The open boundary of the range. </p> 212 </div> 213 <div class="sect4" lang="en" xml:lang="en"> 214 <div class="titlepage"> 215 <div> 216 <div> 217 <h5 class="title"><a id="id1550656"></a> 218 first </h5> 219 </div> 220 </div> 221 </div> 222 <p>The closed boundary of the range. </p> 223 </div> 224 </div> 225 </div> 226 <div class="sect2" lang="en" xml:lang="en"> 227 <div class="titlepage"> 228 <div> 229 <div> 230 <h3 class="title"><a id="id1550833"></a> 231Group: Insert Functions</h3> 232 </div> 233 </div> 234 </div> 235 <p>They have similiar usage as their C++ STL equivalents.</p> 236 <p>Note that when secondary index is enabled, each <a class="link" href="db_container.html" title="Chapter 3. Db_container">db_container</a> 237 can create a <a class="link" href="db_multimap.html" title="Chapter 6. Db_multimap">db_multimap</a> 238 secondary container, but the insert function is not functional for secondary containers. </p> 239 <div class="simplesect" lang="en" xml:lang="en"> 240 <div class="titlepage"></div> 241 <p><a class="ulink" href="http://www.cplusplus.com/reference/stl/map/insert/" target="_top">http://www.cplusplus.com/reference/stl/map/insert/</a> </p> 242 </div> 243 <p> 244</p> 245 </div> 246 <div class="sect2" lang="en" xml:lang="en"> 247 <div class="titlepage"> 248 <div> 249 <div> 250 <h3 class="title"><a id="id1550181"></a> 251Class</h3> 252 </div> 253 </div> 254 </div> 255 <p> 256 <a class="link" href="db_map.html" title="Chapter 5. Db_map"> 257 db_map</a> 258 </p> 259 </div> 260 </div> 261 <div class="navfooter"> 262 <hr /> 263 <table width="100%" summary="Navigation footer"> 264 <tr> 265 <td width="40%" align="left"><a accesskey="p" href="stldb_mapdstr_db_map.html">Prev</a> </td> 266 <td width="20%" align="center"> 267 <a accesskey="u" href="db_map.html">Up</a> 268 </td> 269 <td width="40%" align="right"> <a accesskey="n" href="stldb_mapbegin.html">Next</a></td> 270 </tr> 271 <tr> 272 <td width="40%" align="left" valign="top"> 273~db_map 274 </td> 275 <td width="20%" align="center"> 276 <a accesskey="h" href="index.html">Home</a> 277 </td> 278 <td width="40%" align="right" valign="top"> 279begin 280</td> 281 </tr> 282 </table> 283 </div> 284 </body> 285</html> 286