3 <meta http-equiv=
"Content-Type" content=
"text/html; charset=US-ASCII">
4 <title>Class template insert_iterator
</title>
5 <link rel=
"stylesheet" href=
"../../../../../../doc/src/boostbook.css" type=
"text/css">
6 <meta name=
"generator" content=
"DocBook XSL Stylesheets V1.74.0">
7 <link rel=
"home" href=
"../../index.html" title=
"Chapter 1. Boost.Icl">
8 <link rel=
"up" href=
"../../header/boost/icl/iterator_hpp.html" title=
"Header <boost/icl/iterator.hpp>">
9 <link rel=
"prev" href=
"add_iterator.html" title=
"Class template add_iterator">
10 <link rel=
"next" href=
"adder.html" title=
"Function template adder">
12 <body bgcolor=
"white" text=
"black" link=
"#0000FF" vlink=
"#840084" alink=
"#0000FF">
13 <table cellpadding=
"2" width=
"100%"><tr>
14 <td valign=
"top"><img alt=
"Boost C++ Libraries" width=
"277" height=
"86" src=
"../../../../../../boost.png"></td>
15 <td align=
"center"><a href=
"../../../../../../index.html">Home
</a></td>
16 <td align=
"center"><a href=
"../../../../../libraries.htm">Libraries
</a></td>
17 <td align=
"center"><a href=
"http://www.boost.org/users/people.html">People
</a></td>
18 <td align=
"center"><a href=
"http://www.boost.org/users/faq.html">FAQ
</a></td>
19 <td align=
"center"><a href=
"../../../../../../more/index.htm">More
</a></td>
22 <div class=
"spirit-nav">
23 <a accesskey=
"p" href=
"add_iterator.html"><img src=
"../../../../../../doc/src/images/prev.png" alt=
"Prev"></a><a accesskey=
"u" href=
"../../header/boost/icl/iterator_hpp.html"><img src=
"../../../../../../doc/src/images/up.png" alt=
"Up"></a><a accesskey=
"h" href=
"../../index.html"><img src=
"../../../../../../doc/src/images/home.png" alt=
"Home"></a><a accesskey=
"n" href=
"adder.html"><img src=
"../../../../../../doc/src/images/next.png" alt=
"Next"></a>
25 <div class=
"refentry" lang=
"en">
26 <a name=
"boost.icl.insert_iterator"></a><div class=
"titlepage"></div>
27 <div class=
"refnamediv">
28 <h2><span class=
"refentrytitle">Class template insert_iterator
</span></h2>
29 <p>boost::icl::insert_iterator
— Performes an insertion using a container's memberfunction add, when operator= is called.
</p>
31 <h2 xmlns:
rev=
"http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class=
"refsynopsisdiv-title">Synopsis
</h2>
32 <div xmlns:
rev=
"http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class=
"refsynopsisdiv"><pre class=
"synopsis"><span class=
"comment">// In header:
<<a class=
"link" href=
"../../header/boost/icl/iterator_hpp.html" title=
"Header <boost/icl/iterator.hpp>">boost/icl/iterator.hpp
</a>>
34 </span><span class=
"keyword">template
</span><span class=
"special"><</span><span class=
"keyword">typename
</span> ContainerT
<span class=
"special">></span>
35 <span class=
"keyword">class
</span> <a class=
"link" href=
"insert_iterator.html" title=
"Class template insert_iterator">insert_iterator
</a> <span class=
"special">{
</span>
36 <span class=
"keyword">public
</span><span class=
"special">:
</span>
37 <span class=
"comment">// types
</span>
38 <span class=
"keyword">typedef
</span> <span class=
"identifier">ContainerT
</span> <a name=
"boost.icl.insert_iterator.container_type"></a><span class=
"identifier">container_type
</span><span class=
"special">;
</span> <span class=
"comment">// The container's type.
</span>
39 <span class=
"keyword">typedef
</span> <span class=
"identifier">std
</span><span class=
"special">::
</span><span class=
"identifier">output_iterator_tag
</span> <a name=
"boost.icl.insert_iterator.iterator_category"></a><span class=
"identifier">iterator_category
</span><span class=
"special">;
</span>
41 <span class=
"comment">//
<a class=
"link" href=
"insert_iterator.html#boost.icl.insert_iteratorconstruct-copy-destruct">construct/copy/destruct
</a></span>
42 <a class=
"link" href=
"insert_iterator.html#id657579-bb"><span class=
"identifier">insert_iterator
</span></a><span class=
"special">(
</span><span class=
"identifier">ContainerT
</span> <span class=
"special">&</span><span class=
"special">,
</span> <span class=
"keyword">typename
</span> <span class=
"identifier">ContainerT
</span><span class=
"special">::
</span><span class=
"identifier">iterator
</span><span class=
"special">)
</span><span class=
"special">;
</span>
43 insert_iterator
& <a class=
"link" href=
"insert_iterator.html#id657598-bb"><span class=
"keyword">operator
</span><span class=
"special">=
</span></a><span class=
"special">(
</span><span class=
"keyword">typename
</span> <span class=
"identifier">ContainerT
</span><span class=
"special">::
</span><span class=
"identifier">const_reference
</span><span class=
"special">)
</span><span class=
"special">;
</span>
45 <span class=
"comment">//
<a class=
"link" href=
"insert_iterator.html#id657546-bb">public member functions
</a></span>
46 <a class=
"link" href=
"insert_iterator.html" title=
"Class template insert_iterator">insert_iterator
</a> <span class=
"special">&</span> <a class=
"link" href=
"insert_iterator.html#id657549-bb"><span class=
"keyword">operator
</span><span class=
"special">*
</span></a><span class=
"special">(
</span><span class=
"special">)
</span><span class=
"special">;
</span>
47 <a class=
"link" href=
"insert_iterator.html" title=
"Class template insert_iterator">insert_iterator
</a> <span class=
"special">&</span> <a class=
"link" href=
"insert_iterator.html#id657557-bb"><span class=
"keyword">operator
</span><span class=
"special">++
</span></a><span class=
"special">(
</span><span class=
"special">)
</span><span class=
"special">;
</span>
48 <a class=
"link" href=
"insert_iterator.html" title=
"Class template insert_iterator">insert_iterator
</a> <span class=
"special">&</span> <a class=
"link" href=
"insert_iterator.html#id657565-bb"><span class=
"keyword">operator
</span><span class=
"special">++
</span></a><span class=
"special">(
</span><span class=
"keyword">int
</span><span class=
"special">)
</span><span class=
"special">;
</span>
49 <span class=
"special">}
</span><span class=
"special">;
</span></pre></div>
50 <div class=
"refsect1" lang=
"en">
51 <a name=
"id1302298"></a><h2>Description
</h2>
52 <div class=
"refsect2" lang=
"en">
53 <a name=
"id1302302"></a><h3>
54 <a name=
"boost.icl.insert_iteratorconstruct-copy-destruct"></a><code class=
"computeroutput">insert_iterator
</code>
56 construct/copy/destruct
</h3>
57 <div class=
"orderedlist"><ol type=
"1">
59 <pre class=
"literallayout"><a name=
"id657579-bb"></a><span class=
"identifier">insert_iterator
</span><span class=
"special">(
</span><span class=
"identifier">ContainerT
</span> <span class=
"special">&</span> cont
<span class=
"special">,
</span> <span class=
"keyword">typename
</span> <span class=
"identifier">ContainerT
</span><span class=
"special">::
</span><span class=
"identifier">iterator
</span> iter
<span class=
"special">)
</span><span class=
"special">;
</span></pre>
60 <p>An
<code class=
"computeroutput"><a class=
"link" href=
"insert_iterator.html" title=
"Class template insert_iterator">insert_iterator
</a></code> is constructed with a container and a position that has to be maintained.
</p>
63 <pre class=
"literallayout">insert_iterator
& <a name=
"id657598-bb"></a><span class=
"keyword">operator
</span><span class=
"special">=
</span><span class=
"special">(
</span><span class=
"keyword">typename
</span> <span class=
"identifier">ContainerT
</span><span class=
"special">::
</span><span class=
"identifier">const_reference
</span> value
<span class=
"special">)
</span><span class=
"special">;
</span></pre>
64 <p>This assignment operator adds the
<code class=
"computeroutput">value
</code> before the current position. It maintains it's position by incrementing after addition.
</p>
68 <div class=
"refsect2" lang=
"en">
69 <a name=
"id1302430"></a><h3>
70 <a name=
"id657546-bb"></a><code class=
"computeroutput">insert_iterator
</code> public member functions
</h3>
71 <div class=
"orderedlist"><ol type=
"1">
72 <li><pre class=
"literallayout"><a class=
"link" href=
"insert_iterator.html" title=
"Class template insert_iterator">insert_iterator
</a> <span class=
"special">&</span> <a name=
"id657549-bb"></a><span class=
"keyword">operator
</span><span class=
"special">*
</span><span class=
"special">(
</span><span class=
"special">)
</span><span class=
"special">;
</span></pre></li>
73 <li><pre class=
"literallayout"><a class=
"link" href=
"insert_iterator.html" title=
"Class template insert_iterator">insert_iterator
</a> <span class=
"special">&</span> <a name=
"id657557-bb"></a><span class=
"keyword">operator
</span><span class=
"special">++
</span><span class=
"special">(
</span><span class=
"special">)
</span><span class=
"special">;
</span></pre></li>
74 <li><pre class=
"literallayout"><a class=
"link" href=
"insert_iterator.html" title=
"Class template insert_iterator">insert_iterator
</a> <span class=
"special">&</span> <a name=
"id657565-bb"></a><span class=
"keyword">operator
</span><span class=
"special">++
</span><span class=
"special">(
</span><span class=
"keyword">int
</span><span class=
"special">)
</span><span class=
"special">;
</span></pre></li>
79 <table xmlns:
rev=
"http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width=
"100%"><tr>
80 <td align=
"left"></td>
81 <td align=
"right"><div class=
"copyright-footer">Copyright
© 2007 -
2010 Joachim Faulhaber
<br>Copyright
© 1999 -
2006 Cortex Software GmbH
<p>
82 Distributed under the Boost Software License, Version
1.0. (See accompanying
83 file LICENSE_1_0.txt or copy at
<a href=
"http://www.boost.org/LICENSE_1_0.txt" target=
"_top">http://www.boost.org/LICENSE_1_0.txt
</a>)
88 <div class=
"spirit-nav">
89 <a accesskey=
"p" href=
"add_iterator.html"><img src=
"../../../../../../doc/src/images/prev.png" alt=
"Prev"></a><a accesskey=
"u" href=
"../../header/boost/icl/iterator_hpp.html"><img src=
"../../../../../../doc/src/images/up.png" alt=
"Up"></a><a accesskey=
"h" href=
"../../index.html"><img src=
"../../../../../../doc/src/images/home.png" alt=
"Home"></a><a accesskey=
"n" href=
"adder.html"><img src=
"../../../../../../doc/src/images/next.png" alt=
"Next"></a>