docs/api_reference/STL/stldb_vectorsplice.html

   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 xmlns="" class="navheader">
  16       <div class="libver">
  17         <p>Library Version 11.2.5.3</p>
  18       </div>
  19       <table width="100%" summary="Navigation header">
  20         <tr>
  21           <th colspan="3" align="center">splice</th>
  22         </tr>
  23         <tr>
  24           <td width="20%" align="left"><a accesskey="p" href="stldb_vectorreverse.html">Prev</a> </td>
  25           <th width="60%" align="center">Chapter 4.
  26  Db_vector  </th>
  27           <td width="20%" align="right"> <a accesskey="n" href="stldb_vectorsize.html">Next</a></td>
  28         </tr>
  29       </table>
  30       <hr />
  31     </div>
  32     <div class="sect1" lang="en" xml:lang="en">
  33       <div class="titlepage">
  34         <div>
  35           <div>
  36             <h2 class="title" style="clear: both"><a id="stldb_vectorsplice"></a>splice</h2>
  37           </div>
  38         </div>
  39       </div>
  40       <div class="sect2" lang="en" xml:lang="en">
  41         <div class="titlepage">
  42           <div>
  43             <div>
  44               <h3 class="title"><a id="stldb_vectorsplice_details"></a>Function Details</h3>
  45             </div>
  46           </div>
  47         </div>
  48         <pre class="programlisting">
  49 void splice(iterator position,
  50     self &amp;x)
  51  </pre>
  52         <p>Moves elements from list x into this list. </p>
  53         <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>
  54         <div class="sect3" lang="en" xml:lang="en">
  55           <div class="titlepage">
  56             <div>
  57               <div>
  58                 <h4 class="title"><a id="idm37400"></a>Parameters</h4>
  59               </div>
  60             </div>
  61           </div>
  62           <div class="sect4" lang="en" xml:lang="en">
  63             <div class="titlepage">
  64               <div>
  65                 <div>
  66                   <h5 class="title"><a id="idm232336"></a>position</h5>
  67                 </div>
  68               </div>
  69             </div>
  70             <p>Position within the container where the elements of x are inserted. </p>
  71           </div>
  72           <div class="sect4" lang="en" xml:lang="en">
  73             <div class="titlepage">
  74               <div>
  75                 <div>
  76                   <h5 class="title"><a id="idm677904"></a>x</h5>
  77                 </div>
  78               </div>
  79             </div>
  80             <p>The other list container to splice from. </p>
  81           </div>
  82         </div>
  83         <div class="sect3" lang="en" xml:lang="en">
  84           <div class="titlepage">
  85             <div>
  86               <div>
  87                 <h4 class="title"><a id="idm572384"></a>See Also</h4>
  88               </div>
  89             </div>
  90           </div>
  91           <p>
  92      </p>
  93           <p>
  94             <a class="ulink" href="http://www.cplusplus.com/reference/stl/list/splice/" target="_top">http://www.cplusplus.com/reference/stl/list/splice/</a>
  95           </p>
  96           <p>
  97    </p>
  98         </div>
  99         <pre class="programlisting">
 100 void splice(iterator position, self &amp;x,
 101     iterator i)
 102  </pre>
 103         <p>Moves elements from list x into this list. </p>
 104         <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>
 105         <div class="sect3" lang="en" xml:lang="en">
 106           <div class="titlepage">
 107             <div>
 108               <div>
 109                 <h4 class="title"><a id="idm779944"></a>Parameters</h4>
 110               </div>
 111             </div>
 112           </div>
 113           <div class="sect4" lang="en" xml:lang="en">
 114             <div class="titlepage">
 115               <div>
 116                 <div>
 117                   <h5 class="title"><a id="idm535936"></a>i</h5>
 118                 </div>
 119               </div>
 120             </div>
 121             <p>The position of element in x to move into this list. </p>
 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="idm444384"></a>position</h5>
 128                 </div>
 129               </div>
 130             </div>
 131             <p>Position within the container where the elements of x are inserted. </p>
 132           </div>
 133           <div class="sect4" lang="en" xml:lang="en">
 134             <div class="titlepage">
 135               <div>
 136                 <div>
 137                   <h5 class="title"><a id="idm484976"></a>x</h5>
 138                 </div>
 139               </div>
 140             </div>
 141             <p>The other list container to splice from. </p>
 142           </div>
 143         </div>
 144         <div class="sect3" lang="en" xml:lang="en">
 145           <div class="titlepage">
 146             <div>
 147               <div>
 148                 <h4 class="title"><a id="idm227616"></a>See Also</h4>
 149               </div>
 150             </div>
 151           </div>
 152           <p>
 153     </p>
 154           <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>
 155           <p>
 156    </p>
 157         </div>
 158         <pre class="programlisting">
 159 void splice(iterator position, self &amp;x, iterator first,
 160     iterator last)
 161  </pre>
 162         <p>Moves elements from list x into this list. </p>
 163         <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>
 164         <div class="sect3" lang="en" xml:lang="en">
 165           <div class="titlepage">
 166             <div>
 167               <div>
 168                 <h4 class="title"><a id="idm639280"></a>Parameters</h4>
 169               </div>
 170             </div>
 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="idm627192"></a>position</h5>
 177                 </div>
 178               </div>
 179             </div>
 180             <p>Position within the container where the elements of x are inserted. </p>
 181           </div>
 182           <div class="sect4" lang="en" xml:lang="en">
 183             <div class="titlepage">
 184               <div>
 185                 <div>
 186                   <h5 class="title"><a id="idm249720"></a>first</h5>
 187                 </div>
 188               </div>
 189             </div>
 190             <p>The range's closed boundary. </p>
 191           </div>
 192           <div class="sect4" lang="en" xml:lang="en">
 193             <div class="titlepage">
 194               <div>
 195                 <div>
 196                   <h5 class="title"><a id="idm893544"></a>last</h5>
 197                 </div>
 198               </div>
 199             </div>
 200             <p>The range's open boundary. </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="idm900992"></a>x</h5>
 207                 </div>
 208               </div>
 209             </div>
 210             <p>The other list container to splice from. </p>
 211           </div>
 212         </div>
 213         <div class="sect3" lang="en" xml:lang="en">
 214           <div class="titlepage">
 215             <div>
 216               <div>
 217                 <h4 class="title"><a id="idm709368"></a>See Also</h4>
 218               </div>
 219             </div>
 220           </div>
 221           <p>
 222     </p>
 223           <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>
 224           <p>
 225    </p>
 226         </div>
 227       </div>
 228       <div class="sect2" lang="en" xml:lang="en">
 229         <div class="titlepage">
 230           <div>
 231             <div>
 232               <h3 class="title"><a id="idm998376"></a>Group: std::list specific functions</h3>
 233             </div>
 234           </div>
 235         </div>
 236         <div class="simplesect" lang="en" xml:lang="en">
 237           <div class="titlepage"></div>
 238           <p><a class="ulink" href="http://www.cplusplus.com/reference/stl/list/" target="_top">http://www.cplusplus.com/reference/stl/list/</a> </p>
 239         </div>
 240         <p>
 241 </p>
 242       </div>
 243       <div class="sect2" lang="en" xml:lang="en">
 244         <div class="titlepage">
 245           <div>
 246             <div>
 247               <h3 class="title"><a id="idm953168"></a>Class</h3>
 248             </div>
 249           </div>
 250         </div>
 251         <p>
 252   <a class="link" href="db_vector.html" title="Chapter 4.  Db_vector">db_vector</a>
 253      </p>
 254       </div>
 255     </div>
 256     <div class="navfooter">
 257       <hr />
 258       <table width="100%" summary="Navigation footer">
 259         <tr>
 260           <td width="40%" align="left"><a accesskey="p" href="stldb_vectorreverse.html">Prev</a> </td>
 261           <td width="20%" align="center">
 262             <a accesskey="u" href="db_vector.html">Up</a>
 263           </td>
 264           <td width="40%" align="right"> <a accesskey="n" href="stldb_vectorsize.html">Next</a></td>
 265         </tr>
 266         <tr>
 267           <td width="40%" align="left" valign="top">reverse </td>
 268           <td width="20%" align="center">
 269             <a accesskey="h" href="index.html">Home</a>
 270           </td>
 271           <td width="40%" align="right" valign="top"> size</td>
 272         </tr>
 273       </table>
 274     </div>
 275   </body>
 276 </html>