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_vector.html" title="Chapter 4. Db_vector" /> 11 <link rel="prev" href="stldb_vectorpop_front.html" title="pop_front" /> 12 <link rel="next" href="stldb_vectorerase.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_vectorpop_front.html">Prev</a> </td> 24 <th width="60%" align="center">Chapter 4. 25 Db_vector </th> 26 <td width="20%" align="right"> <a accesskey="n" href="stldb_vectorerase.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_vectorinsert"></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(iterator pos, 52 const T &x) 53 </pre> 54 <div class="sect3" lang="en" xml:lang="en"> 55 <div class="titlepage"></div> 56 <p>Insert x before position pos. </p> 57 <p></p> 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="id1547908"></a> 64Parameters</h4> 65 </div> 66 </div> 67 </div> 68 <div class="sect4" lang="en" xml:lang="en"> 69 <div class="titlepage"> 70 <div> 71 <div> 72 <h5 class="title"><a id="id1547864"></a> 73 x </h5> 74 </div> 75 </div> 76 </div> 77 <p>The element to insert. </p> 78 </div> 79 <div class="sect4" lang="en" xml:lang="en"> 80 <div class="titlepage"> 81 <div> 82 <div> 83 <h5 class="title"><a id="id1547809"></a> 84 pos </h5> 85 </div> 86 </div> 87 </div> 88 <p>The position before which to insert. </p> 89 </div> 90 </div> 91 <pre class="programlisting"> 92void insert(iterator pos, size_type n, 93 const T &x) 94 </pre> 95 <div class="sect3" lang="en" xml:lang="en"> 96 <div class="titlepage"></div> 97 <p>Insert n number of elements x before position pos. </p> 98 <p></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="id1547867"></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="id1547872"></a> 114 x </h5> 115 </div> 116 </div> 117 </div> 118 <p>The element 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="id1548013"></a> 125 pos </h5> 126 </div> 127 </div> 128 </div> 129 <p>The position before which to insert. </p> 130 </div> 131 <div class="sect4" lang="en" xml:lang="en"> 132 <div class="titlepage"> 133 <div> 134 <div> 135 <h5 class="title"><a id="id1547790"></a> 136 n </h5> 137 </div> 138 </div> 139 </div> 140 <p>The number of elements to insert. </p> 141 </div> 142 </div> 143 <pre class="programlisting"> 144void insert(iterator pos, InputIterator first, 145 InputIterator 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 elements in range [first, last) into this vector before position pos. </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="id1547754"></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="id1547973"></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="id1547846"></a> 177 pos </h5> 178 </div> 179 </div> 180 </div> 181 <p>The position before which to insert. </p> 182 </div> 183 <div class="sect4" lang="en" xml:lang="en"> 184 <div class="titlepage"> 185 <div> 186 <div> 187 <h5 class="title"><a id="id1548057"></a> 188 first </h5> 189 </div> 190 </div> 191 </div> 192 <p>The closed boundary of the range. </p> 193 </div> 194 </div> 195 <pre class="programlisting"> 196void insert(iterator pos, const_iterator first, 197 const_iterator last) 198 </pre> 199 <div class="sect3" lang="en" xml:lang="en"> 200 <div class="titlepage"></div> 201 <p>Range insertion. </p> 202 <p>Insert elements in range [first, last) into this vector before position pos. </p> 203 </div> 204 <div class="sect3" lang="en" xml:lang="en"> 205 <div class="titlepage"> 206 <div> 207 <div> 208 <h4 class="title"><a id="id1547811"></a> 209Parameters</h4> 210 </div> 211 </div> 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="id1548025"></a> 218 last </h5> 219 </div> 220 </div> 221 </div> 222 <p>The open boundary of the range. </p> 223 </div> 224 <div class="sect4" lang="en" xml:lang="en"> 225 <div class="titlepage"> 226 <div> 227 <div> 228 <h5 class="title"><a id="id1547825"></a> 229 pos </h5> 230 </div> 231 </div> 232 </div> 233 <p>The position before which to insert. </p> 234 </div> 235 <div class="sect4" lang="en" xml:lang="en"> 236 <div class="titlepage"> 237 <div> 238 <div> 239 <h5 class="title"><a id="id1547613"></a> 240 first </h5> 241 </div> 242 </div> 243 </div> 244 <p>The closed boundary of the range. </p> 245 </div> 246 </div> 247 </div> 248 <div class="sect2" lang="en" xml:lang="en"> 249 <div class="titlepage"> 250 <div> 251 <div> 252 <h3 class="title"><a id="id1548026"></a> 253Group: Insert functions</h3> 254 </div> 255 </div> 256 </div> 257 <p>The iterator pos in the functions must be a read-write iterator, can't be read only.</p> 258 <div class="simplesect" lang="en" xml:lang="en"> 259 <div class="titlepage"></div> 260 <p><a class="ulink" href="http://www.cplusplus.com/reference/stl/vector/insert.html" target="_top">http://www.cplusplus.com/reference/stl/vector/insert.html</a> </p> 261 </div> 262 <p> 263</p> 264 </div> 265 <div class="sect2" lang="en" xml:lang="en"> 266 <div class="titlepage"> 267 <div> 268 <div> 269 <h3 class="title"><a id="id1547961"></a> 270Class</h3> 271 </div> 272 </div> 273 </div> 274 <p> 275 <a class="link" href="db_vector.html" title="Chapter 4. Db_vector"> 276 db_vector</a> 277 </p> 278 </div> 279 </div> 280 <div class="navfooter"> 281 <hr /> 282 <table width="100%" summary="Navigation footer"> 283 <tr> 284 <td width="40%" align="left"><a accesskey="p" href="stldb_vectorpop_front.html">Prev</a> </td> 285 <td width="20%" align="center"> 286 <a accesskey="u" href="db_vector.html">Up</a> 287 </td> 288 <td width="40%" align="right"> <a accesskey="n" href="stldb_vectorerase.html">Next</a></td> 289 </tr> 290 <tr> 291 <td width="40%" align="left" valign="top"> 292pop_front 293 </td> 294 <td width="20%" align="center"> 295 <a accesskey="h" href="index.html">Home</a> 296 </td> 297 <td width="40%" align="right" valign="top"> 298erase 299</td> 300 </tr> 301 </table> 302 </div> 303 </body> 304</html> 305