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>splice</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_vectorreverse.html" title="reverse" /> 12 <link rel="next" href="stldb_vectorsize.html" title="size" /> 13 </head> 14 <body> 15 <div class="navheader"> 16 <table width="100%" summary="Navigation header"> 17 <tr> 18 <th colspan="3" align="center"> 19splice 20</th> 21 </tr> 22 <tr> 23 <td width="20%" align="left"><a accesskey="p" href="stldb_vectorreverse.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_vectorsize.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_vectorsplice"></a> 36splice 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"> 51void splice(iterator position, 52 self &x) 53 </pre> 54 <div class="sect3" lang="en" xml:lang="en"> 55 <div class="titlepage"></div> 56 <p>Moves elements from list x into this list. </p> 57 <p>Moves all elements in list x into this list container at the specified position, effectively inserting the specified elements into the container and removing them from x. This function supports auto-commit. </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="id1548796"></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="id1548649"></a> 73 position </h5> 74 </div> 75 </div> 76 </div> 77 <p>Position within the container where the elements of x are inserted. </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="id1548558"></a> 84 x </h5> 85 </div> 86 </div> 87 </div> 88 <p>The other list container to splice from. </p> 89 </div> 90 </div> 91 <div class="sect3" lang="en" xml:lang="en"> 92 <div class="titlepage"> 93 <div> 94 <div> 95 <h4 class="title"><a id="id1548851"></a> 96See Also</h4> 97 </div> 98 </div> 99 </div> 100 <p> 101 </p> 102 <p><a class="ulink" href="http://www.cplusplus.com/reference/stl/list/splice/" target="_top">http://www.cplusplus.com/reference/stl/list/splice/</a> </p> 103 <p> </p> 104 </div> 105 <pre class="programlisting"> 106void splice(iterator position, self &x, 107 iterator i) 108 </pre> 109 <div class="sect3" lang="en" xml:lang="en"> 110 <div class="titlepage"></div> 111 <p>Moves elements from list x into this list. </p> 112 <p>Moves elements at position i of list x into this list container at the specified position, effectively inserting the specified elements into the container and removing them from x. This function supports auto-commit. </p> 113 </div> 114 <div class="sect3" lang="en" xml:lang="en"> 115 <div class="titlepage"> 116 <div> 117 <div> 118 <h4 class="title"><a id="id1548849"></a> 119Parameters</h4> 120 </div> 121 </div> 122 </div> 123 <div class="sect4" lang="en" xml:lang="en"> 124 <div class="titlepage"> 125 <div> 126 <div> 127 <h5 class="title"><a id="id1548914"></a> 128 i </h5> 129 </div> 130 </div> 131 </div> 132 <p>The position of element in x to move into this list. </p> 133 </div> 134 <div class="sect4" lang="en" xml:lang="en"> 135 <div class="titlepage"> 136 <div> 137 <div> 138 <h5 class="title"><a id="id1548725"></a> 139 position </h5> 140 </div> 141 </div> 142 </div> 143 <p>Position within the container where the elements of x are inserted. </p> 144 </div> 145 <div class="sect4" lang="en" xml:lang="en"> 146 <div class="titlepage"> 147 <div> 148 <div> 149 <h5 class="title"><a id="id1548804"></a> 150 x </h5> 151 </div> 152 </div> 153 </div> 154 <p>The other list container to splice from. </p> 155 </div> 156 </div> 157 <div class="sect3" lang="en" xml:lang="en"> 158 <div class="titlepage"> 159 <div> 160 <div> 161 <h4 class="title"><a id="id1548823"></a> 162See Also</h4> 163 </div> 164 </div> 165 </div> 166 <p> 167 </p> 168 <p><a class="ulink" href="http://www.cplusplus.com/reference/stl/list/splice/" target="_top">http://www.cplusplus.com/reference/stl/list/splice/</a> </p> 169 <p> </p> 170 </div> 171 <pre class="programlisting"> 172void splice(iterator position, self &x, iterator first, 173 iterator last) 174 </pre> 175 <div class="sect3" lang="en" xml:lang="en"> 176 <div class="titlepage"></div> 177 <p>Moves elements from list x into this list. </p> 178 <p>Moves elements in range [first, last) of list x into this list container at the specified position, effectively inserting the specified elements into the container and removing them from x. This function supports auto-commit. </p> 179 </div> 180 <div class="sect3" lang="en" xml:lang="en"> 181 <div class="titlepage"> 182 <div> 183 <div> 184 <h4 class="title"><a id="id1548654"></a> 185Parameters</h4> 186 </div> 187 </div> 188 </div> 189 <div class="sect4" lang="en" xml:lang="en"> 190 <div class="titlepage"> 191 <div> 192 <div> 193 <h5 class="title"><a id="id1548955"></a> 194 position </h5> 195 </div> 196 </div> 197 </div> 198 <p>Position within the container where the elements of x are inserted. </p> 199 </div> 200 <div class="sect4" lang="en" xml:lang="en"> 201 <div class="titlepage"> 202 <div> 203 <div> 204 <h5 class="title"><a id="id1548636"></a> 205 first </h5> 206 </div> 207 </div> 208 </div> 209 <p>The range's closed boundary. </p> 210 </div> 211 <div class="sect4" lang="en" xml:lang="en"> 212 <div class="titlepage"> 213 <div> 214 <div> 215 <h5 class="title"><a id="id1548569"></a> 216 last </h5> 217 </div> 218 </div> 219 </div> 220 <p>The range's open boundary. </p> 221 </div> 222 <div class="sect4" lang="en" xml:lang="en"> 223 <div class="titlepage"> 224 <div> 225 <div> 226 <h5 class="title"><a id="id1548521"></a> 227 x </h5> 228 </div> 229 </div> 230 </div> 231 <p>The other list container to splice from. </p> 232 </div> 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="id1548994"></a> 239See Also</h4> 240 </div> 241 </div> 242 </div> 243 <p> 244 </p> 245 <p><a class="ulink" href="http://www.cplusplus.com/reference/stl/list/splice/" target="_top">http://www.cplusplus.com/reference/stl/list/splice/</a> </p> 246 <p> </p> 247 </div> 248 </div> 249 <div class="sect2" lang="en" xml:lang="en"> 250 <div class="titlepage"> 251 <div> 252 <div> 253 <h3 class="title"><a id="id1548644"></a> 254Group: std::list specific functions</h3> 255 </div> 256 </div> 257 </div> 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/list/" target="_top">http://www.cplusplus.com/reference/stl/list/</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="id1548572"></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_vectorreverse.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_vectorsize.html">Next</a></td> 289 </tr> 290 <tr> 291 <td width="40%" align="left" valign="top"> 292reverse 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"> 298size 299</td> 300 </tr> 301 </table> 302 </div> 303 </body> 304</html> 305