1<html> 2<head> 3<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> 4<title>iterator_range</title> 5<link rel="stylesheet" href="../../../../../../doc/src/boostbook.css" type="text/css"> 6<meta name="generator" content="DocBook XSL Stylesheets V1.79.1"> 7<link rel="home" href="../../index.html" title="Chapter 1. Fusion 2.2"> 8<link rel="up" href="../view.html" title="View"> 9<link rel="prev" href="filter_view.html" title="filter_view"> 10<link rel="next" href="joint_view.html" title="joint_view"> 11</head> 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="../../../../../../libs/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> 20</tr></table> 21<hr> 22<div class="spirit-nav"> 23<a accesskey="p" href="filter_view.html"><img src="../../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../view.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="joint_view.html"><img src="../../../../../../doc/src/images/next.png" alt="Next"></a> 24</div> 25<div class="section"> 26<div class="titlepage"><div><div><h3 class="title"> 27<a name="fusion.view.iterator_range"></a><a class="link" href="iterator_range.html" title="iterator_range">iterator_range</a> 28</h3></div></div></div> 29<h5> 30<a name="fusion.view.iterator_range.h0"></a> 31 <span class="phrase"><a name="fusion.view.iterator_range.description"></a></span><a class="link" href="iterator_range.html#fusion.view.iterator_range.description">Description</a> 32 </h5> 33<p> 34 <code class="computeroutput"><span class="identifier">iterator_range</span></code> presents a 35 sub-range of its underlying sequence delimited by a pair of iterators. 36 </p> 37<h5> 38<a name="fusion.view.iterator_range.h1"></a> 39 <span class="phrase"><a name="fusion.view.iterator_range.header"></a></span><a class="link" href="iterator_range.html#fusion.view.iterator_range.header">Header</a> 40 </h5> 41<pre class="programlisting"><span class="preprocessor">#include</span> <span class="special"><</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">fusion</span><span class="special">/</span><span class="identifier">view</span><span class="special">/</span><span class="identifier">iterator_range</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">></span> 42<span class="preprocessor">#include</span> <span class="special"><</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">fusion</span><span class="special">/</span><span class="identifier">include</span><span class="special">/</span><span class="identifier">iterator_range</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">></span> 43</pre> 44<h5> 45<a name="fusion.view.iterator_range.h2"></a> 46 <span class="phrase"><a name="fusion.view.iterator_range.synopsis"></a></span><a class="link" href="iterator_range.html#fusion.view.iterator_range.synopsis">Synopsis</a> 47 </h5> 48<pre class="programlisting"><span class="keyword">template</span> <span class="special"><</span><span class="keyword">typename</span> <span class="identifier">First</span><span class="special">,</span> <span class="keyword">typename</span> <span class="identifier">Last</span><span class="special">></span> 49<span class="keyword">struct</span> <span class="identifier">iterator_range</span><span class="special">;</span> 50</pre> 51<h5> 52<a name="fusion.view.iterator_range.h3"></a> 53 <span class="phrase"><a name="fusion.view.iterator_range.template_parameters"></a></span><a class="link" href="iterator_range.html#fusion.view.iterator_range.template_parameters">Template 54 parameters</a> 55 </h5> 56<div class="informaltable"><table class="table"> 57<colgroup> 58<col> 59<col> 60<col> 61</colgroup> 62<thead><tr> 63<th> 64 <p> 65 Parameter 66 </p> 67 </th> 68<th> 69 <p> 70 Description 71 </p> 72 </th> 73<th> 74 <p> 75 Default 76 </p> 77 </th> 78</tr></thead> 79<tbody> 80<tr> 81<td> 82 <p> 83 <code class="computeroutput"><span class="identifier">First</span></code> 84 </p> 85 </td> 86<td> 87 <p> 88 A fusion <a class="link" href="../iterator.html" title="Iterator">Iterator</a> 89 </p> 90 </td> 91<td> 92 </td> 93</tr> 94<tr> 95<td> 96 <p> 97 <code class="computeroutput"><span class="identifier">Last</span></code> 98 </p> 99 </td> 100<td> 101 <p> 102 A fusion <a class="link" href="../iterator.html" title="Iterator">Iterator</a> 103 </p> 104 </td> 105<td> 106 </td> 107</tr> 108</tbody> 109</table></div> 110<h5> 111<a name="fusion.view.iterator_range.h4"></a> 112 <span class="phrase"><a name="fusion.view.iterator_range.model_of"></a></span><a class="link" href="iterator_range.html#fusion.view.iterator_range.model_of">Model 113 of</a> 114 </h5> 115<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "> 116<li class="listitem"> 117 <a class="link" href="../sequence/concepts/forward_sequence.html" title="Forward Sequence">Forward Sequence</a>, 118 <a class="link" href="../sequence/concepts/bidirectional_sequence.html" title="Bidirectional Sequence">Bidirectional 119 Sequence</a> or <a class="link" href="../sequence/concepts/random_access_sequence.html" title="Random Access Sequence">Random 120 Access Sequence</a> depending on the traversal characteristics (see 121 <a class="link" href="../sequence/concepts.html#fusion.sequence.concepts.traversal">Sequence Traversal 122 Concept</a>) of its underlying sequence. 123 </li> 124<li class="listitem"> 125 <a class="link" href="../sequence/concepts/associative_sequence.html" title="Associative Sequence">Associative 126 Sequence</a> if <code class="computeroutput"><span class="identifier">First</span></code> 127 and <code class="computeroutput"><span class="identifier">Last</span></code> implement the 128 <a class="link" href="../iterator/concepts/associative_iterator.html" title="Associative Iterator">Associative 129 Iterator</a> model. 130 </li> 131</ul></div> 132<div class="variablelist"> 133<p class="title"><b>Notation</b></p> 134<dl class="variablelist"> 135<dt><span class="term"><code class="computeroutput"><span class="identifier">IR</span></code></span></dt> 136<dd><p> 137 An <code class="computeroutput"><span class="identifier">iterator_range</span></code> type 138 </p></dd> 139<dt><span class="term"><code class="computeroutput"><span class="identifier">f</span></code></span></dt> 140<dd><p> 141 An instance of <code class="computeroutput"><span class="identifier">First</span></code> 142 </p></dd> 143<dt><span class="term"><code class="computeroutput"><span class="identifier">l</span></code></span></dt> 144<dd><p> 145 An instance of <code class="computeroutput"><span class="identifier">Last</span></code> 146 </p></dd> 147<dt><span class="term"><code class="computeroutput"><span class="identifier">ir</span></code>, <code class="computeroutput"><span class="identifier">ir2</span></code></span></dt> 148<dd><p> 149 Instances of <code class="computeroutput"><span class="identifier">iterator_range</span></code> 150 </p></dd> 151</dl> 152</div> 153<h5> 154<a name="fusion.view.iterator_range.h5"></a> 155 <span class="phrase"><a name="fusion.view.iterator_range.expression_semantics"></a></span><a class="link" href="iterator_range.html#fusion.view.iterator_range.expression_semantics">Expression 156 Semantics</a> 157 </h5> 158<p> 159 Semantics of an expression is defined only where it differs from, or is not 160 defined in the implemented models. 161 </p> 162<div class="informaltable"><table class="table"> 163<colgroup> 164<col> 165<col> 166</colgroup> 167<thead><tr> 168<th> 169 <p> 170 Expression 171 </p> 172 </th> 173<th> 174 <p> 175 Semantics 176 </p> 177 </th> 178</tr></thead> 179<tbody> 180<tr> 181<td> 182 <p> 183 <code class="computeroutput"><span class="identifier">IR</span><span class="special">(</span><span class="identifier">f</span><span class="special">,</span> 184 <span class="identifier">l</span><span class="special">)</span></code> 185 </p> 186 </td> 187<td> 188 <p> 189 Creates an <code class="computeroutput"><span class="identifier">iterator_range</span></code> 190 given iterators, <code class="computeroutput"><span class="identifier">f</span></code> 191 and <code class="computeroutput"><span class="identifier">l</span></code>. 192 </p> 193 </td> 194</tr> 195<tr> 196<td> 197 <p> 198 <code class="computeroutput"><span class="identifier">IR</span><span class="special">(</span><span class="identifier">ir</span><span class="special">)</span></code> 199 </p> 200 </td> 201<td> 202 <p> 203 Copy constructs an <code class="computeroutput"><span class="identifier">iterator_range</span></code> 204 from another <code class="computeroutput"><span class="identifier">iterator_range</span></code>, 205 <code class="computeroutput"><span class="identifier">ir</span></code>. 206 </p> 207 </td> 208</tr> 209<tr> 210<td> 211 <p> 212 <code class="computeroutput"><span class="identifier">ir</span> <span class="special">=</span> 213 <span class="identifier">ir2</span></code> 214 </p> 215 </td> 216<td> 217 <p> 218 Assigns to a <code class="computeroutput"><span class="identifier">iterator_range</span></code>, 219 <code class="computeroutput"><span class="identifier">ir</span></code>, from another 220 <code class="computeroutput"><span class="identifier">iterator_range</span></code>, 221 <code class="computeroutput"><span class="identifier">ir2</span></code>. 222 </p> 223 </td> 224</tr> 225</tbody> 226</table></div> 227<h5> 228<a name="fusion.view.iterator_range.h6"></a> 229 <span class="phrase"><a name="fusion.view.iterator_range.example"></a></span><a class="link" href="iterator_range.html#fusion.view.iterator_range.example">Example</a> 230 </h5> 231<pre class="programlisting"><span class="keyword">char</span> <span class="keyword">const</span><span class="special">*</span> <span class="identifier">s</span> <span class="special">=</span> <span class="string">"Ruby"</span><span class="special">;</span> 232<span class="keyword">typedef</span> <a class="link" href="../container/vector.html" title="vector"><code class="computeroutput"><span class="identifier">vector</span></code></a><span class="special"><</span><span class="keyword">int</span><span class="special">,</span> <span class="keyword">char</span><span class="special">,</span> <span class="keyword">double</span><span class="special">,</span> <span class="keyword">char</span> <span class="keyword">const</span><span class="special">*></span> <span class="identifier">vector_type</span><span class="special">;</span> 233<span class="identifier">vector_type</span> <span class="identifier">vec</span><span class="special">(</span><span class="number">1</span><span class="special">,</span> <span class="char">'x'</span><span class="special">,</span> <span class="number">3.3</span><span class="special">,</span> <span class="identifier">s</span><span class="special">);</span> 234 235<span class="keyword">typedef</span> <a class="link" href="../sequence/intrinsic/metafunctions/begin.html" title="begin"><code class="computeroutput"><span class="identifier">result_of</span><span class="special">::</span><span class="identifier">begin</span></code></a><span class="special"><</span><span class="identifier">vector_type</span><span class="special">>::</span><span class="identifier">type</span> <span class="identifier">A</span><span class="special">;</span> 236<span class="keyword">typedef</span> <a class="link" href="../sequence/intrinsic/metafunctions/end.html" title="end"><code class="computeroutput"><span class="identifier">result_of</span><span class="special">::</span><span class="identifier">end</span></code></a><span class="special"><</span><span class="identifier">vector_type</span><span class="special">>::</span><span class="identifier">type</span> <span class="identifier">B</span><span class="special">;</span> 237<span class="keyword">typedef</span> <a class="link" href="../iterator/metafunctions/next.html" title="next"><code class="computeroutput"><span class="identifier">result_of</span><span class="special">::</span><span class="identifier">next</span></code></a><span class="special"><</span><span class="identifier">A</span><span class="special">>::</span><span class="identifier">type</span> <span class="identifier">C</span><span class="special">;</span> 238<span class="keyword">typedef</span> <a class="link" href="../iterator/metafunctions/prior.html" title="prior"><code class="computeroutput"><span class="identifier">result_of</span><span class="special">::</span><span class="identifier">prior</span></code></a><span class="special"><</span><span class="identifier">B</span><span class="special">>::</span><span class="identifier">type</span> <span class="identifier">D</span><span class="special">;</span> 239 240<span class="identifier">C</span> <span class="identifier">c</span><span class="special">(</span><span class="identifier">vec</span><span class="special">);</span> 241<span class="identifier">D</span> <span class="identifier">d</span><span class="special">(</span><span class="identifier">vec</span><span class="special">);</span> 242 243<span class="identifier">iterator_range</span><span class="special"><</span><span class="identifier">C</span><span class="special">,</span> <span class="identifier">D</span><span class="special">></span> <span class="identifier">range</span><span class="special">(</span><span class="identifier">c</span><span class="special">,</span> <span class="identifier">d</span><span class="special">);</span> 244<span class="identifier">std</span><span class="special">::</span><span class="identifier">cout</span> <span class="special"><<</span> <span class="identifier">range</span> <span class="special"><<</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">endl</span><span class="special">;</span> 245</pre> 246</div> 247<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr> 248<td align="left"></td> 249<td align="right"><div class="copyright-footer">Copyright © 2001-2006, 2011, 2012 Joel de Guzman, 250 Dan Marsden, Tobias Schwinger<p> 251 Distributed under the Boost Software License, Version 1.0. (See accompanying 252 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>) 253 </p> 254</div></td> 255</tr></table> 256<hr> 257<div class="spirit-nav"> 258<a accesskey="p" href="filter_view.html"><img src="../../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../view.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="joint_view.html"><img src="../../../../../../doc/src/images/next.png" alt="Next"></a> 259</div> 260</body> 261</html> 262
