Files
boost_fusion/doc/html/fusion/sequences/views/iterator_range.html
T

189 lines
13 KiB
HTML
Raw Blame History

This file contains invisible Unicode characters
This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>iterator_range</title>
<link rel="stylesheet" href="../../../boostbook.css" type="text/css">
<meta name="generator" content="DocBook XSL Stylesheets V1.68.1">
<link rel="start" href="../../../index.html" title="Chapter 1. Fusion 2.0">
<link rel="up" href="../views.html" title="Views">
<link rel="prev" href="filter_view.html" title="filter_view">
<link rel="next" href="joint_view.html" title="joint_view">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%">
<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
<td align="center"><a href="../../../../../../../index.htm">Home</a></td>
<td align="center"><a href="../../../../../../libraries.htm">Libraries</a></td>
<td align="center"><a href="../../../../../../../people/people.htm">People</a></td>
<td align="center"><a href="../../../../../../../more/faq.htm">FAQ</a></td>
<td align="center"><a href="../../../../../../../more/index.htm">More</a></td>
</table>
<hr>
<div class="spirit-nav">
<a accesskey="p" href="filter_view.html"><img src="../../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../views.html"><img src="../../../images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../images/home.png" alt="Home"></a><a accesskey="n" href="joint_view.html"><img src="../../../images/next.png" alt="Next"></a>
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
<a name="fusion.sequences.views.iterator_range"></a><a href="iterator_range.html" title="iterator_range">iterator_range</a></h4></div></div></div>
<a name="fusion.sequences.views.iterator_range.description"></a><h5>
<a name="id976940"></a>
<a href="iterator_range.html#fusion.sequences.views.iterator_range.description">Description</a>
</h5>
<p>
<code class="computeroutput"><span class="identifier">iterator_range</span></code> presents
a sub-range of its underlying sequence delimited by a pair of iterators.
</p>
<a name="fusion.sequences.views.iterator_range.header"></a><h5>
<a name="id976978"></a>
<a href="iterator_range.html#fusion.sequences.views.iterator_range.header">Header</a>
</h5>
<pre class="programlisting">
<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">fusion</span><span class="special">/</span><span class="identifier">sequence</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">&gt;</span>
</pre>
<a name="fusion.sequences.views.iterator_range.synopsis"></a><h5>
<a name="id977069"></a>
<a href="iterator_range.html#fusion.sequences.views.iterator_range.synopsis">Synopsis</a>
</h5>
<pre class="programlisting">
<span class="keyword">template</span> <span class="special">&lt;</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">&gt;</span>
<span class="keyword">struct</span> <span class="identifier">iterator_range</span><span class="special">;</span>
</pre>
<a name="fusion.sequences.views.iterator_range.template_parameters"></a><h5>
<a name="id977154"></a>
<a href="iterator_range.html#fusion.sequences.views.iterator_range.template_parameters">Template
parameters</a>
</h5>
<div class="informaltable"><table class="table">
<colgroup>
<col>
<col>
<col>
</colgroup>
<thead><tr>
<th>Parameter</th>
<th>Description</th>
<th>Default</th>
</tr></thead>
<tbody>
<tr>
<td><code class="computeroutput"><span class="identifier">First</span></code></td>
<td>A
fusion <a href="../../iterators.html" title="Iterators">Iterator</a>
</td>
<td> </td>
</tr>
<tr>
<td><code class="computeroutput"><span class="identifier">Last</span></code></td>
<td>A
fusion <a href="../../iterators.html" title="Iterators">Iterator</a>
</td>
<td> </td>
</tr>
</tbody>
</table></div>
<a name="fusion.sequences.views.iterator_range.model_of"></a><h5>
<a name="id977252"></a>
<a href="iterator_range.html#fusion.sequences.views.iterator_range.model_of">Model of</a>
</h5>
<div class="itemizedlist"><ul type="disc"><li><a href="../concepts/forward_sequence.html" title="Forward
Sequence">Forward Sequence</a></li></ul></div>
<div class="variablelist">
<p class="title"><b>Notation</b></p>
<dl>
<dt><span class="term"><code class="computeroutput"><span class="identifier">IR</span></code></span></dt>
<dd>
An <code class="computeroutput"><span class="identifier">iterator_range</span></code> type
</dd>
<dt><span class="term"><code class="computeroutput"><span class="identifier">f</span></code></span></dt>
<dd>
An instance of <code class="computeroutput"><span class="identifier">First</span></code>
</dd>
<dt><span class="term"><code class="computeroutput"><span class="identifier">l</span></code></span></dt>
<dd>
An instance of <code class="computeroutput"><span class="identifier">Last</span></code>
</dd>
<dt><span class="term"><code class="computeroutput"><span class="identifier">ir</span></code>,
<code class="computeroutput"><span class="identifier">ir2</span></code></span></dt>
<dd>
Instances of <code class="computeroutput"><span class="identifier">iterator_range</span></code>
</dd>
</dl>
</div>
<a name="fusion.sequences.views.iterator_range.expression_semantics"></a><h5>
<a name="id977402"></a>
<a href="iterator_range.html#fusion.sequences.views.iterator_range.expression_semantics">Expression
Semantics</a>
</h5>
<p>
Semantics of an expression is defined only where it differs from, or is
not defined in <a href="../concepts/forward_sequence.html" title="Forward
Sequence">Forward
Sequence</a>.
</p>
<div class="informaltable"><table class="table">
<colgroup>
<col>
<col>
</colgroup>
<thead><tr>
<th>Expression</th>
<th>Semantics</th>
</tr></thead>
<tbody>
<tr>
<td><code class="computeroutput"><span class="identifier">IR</span><span class="special">(</span><span class="identifier">f</span><span class="special">,</span> <span class="identifier">l</span><span class="special">)</span></code></td>
<td>Creates
an <code class="computeroutput"><span class="identifier">iterator_range</span></code>
given iterators, <code class="computeroutput"><span class="identifier">f</span></code>
and <code class="computeroutput"><span class="identifier">l</span></code>.</td>
</tr>
<tr>
<td><code class="computeroutput"><span class="identifier">IR</span><span class="special">(</span><span class="identifier">ir</span><span class="special">)</span></code></td>
<td>Copy
constructs an <code class="computeroutput"><span class="identifier">iterator_range</span></code>
from another <code class="computeroutput"><span class="identifier">iterator_range</span></code>,
<code class="computeroutput"><span class="identifier">ir</span></code>.</td>
</tr>
<tr>
<td><code class="computeroutput"><span class="identifier">ir</span> <span class="special">=</span>
<span class="identifier">ir2</span></code></td>
<td>Assigns
to a <code class="computeroutput"><span class="identifier">iterator_range</span></code>,
<code class="computeroutput"><span class="identifier">ir</span></code>, from another
<code class="computeroutput"><span class="identifier">iterator_range</span></code>,
<code class="computeroutput"><span class="identifier">ir2</span></code>.</td>
</tr>
</tbody>
</table></div>
<a name="fusion.sequences.views.iterator_range.example"></a><h5>
<a name="id977648"></a>
<a href="iterator_range.html#fusion.sequences.views.iterator_range.example">Example</a>
</h5>
<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>
<span class="keyword">typedef</span> <a href="../containers/vector.html" title="vector"><code class="computeroutput"><span class="identifier">vector</span></code></a><span class="special">&lt;</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">*&gt;</span> <span class="identifier">vector_type</span><span class="special">;</span>
<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>
<span class="keyword">typedef</span> <a href="../intrinsics/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">&lt;</span><span class="identifier">vector_type</span><span class="special">&gt;::</span><span class="identifier">type</span> <span class="identifier">A</span><span class="special">;</span>
<span class="keyword">typedef</span> <a href="../intrinsics/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">&lt;</span><span class="identifier">vector_type</span><span class="special">&gt;::</span><span class="identifier">type</span> <span class="identifier">B</span><span class="special">;</span>
<span class="keyword">typedef</span> <a href="../../iterators/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">&lt;</span><span class="identifier">A</span><span class="special">&gt;::</span><span class="identifier">type</span> <span class="identifier">C</span><span class="special">;</span>
<span class="keyword">typedef</span> <a href="../../iterators/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">&lt;</span><span class="identifier">B</span><span class="special">&gt;::</span><span class="identifier">type</span> <span class="identifier">D</span><span class="special">;</span>
<span class="identifier">C</span> <span class="identifier">c</span><span class="special">(</span><span class="identifier">vec</span><span class="special">);</span>
<span class="identifier">D</span> <span class="identifier">d</span><span class="special">(</span><span class="identifier">vec</span><span class="special">);</span>
<span class="identifier">iterator_range</span><span class="special">&lt;</span><span class="identifier">C</span><span class="special">,</span> <span class="identifier">D</span><span class="special">&gt;</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>
<span class="identifier">std</span><span class="special">::</span><span class="identifier">cout</span> <span class="special">&lt;&lt;</span> <span class="identifier">range</span> <span class="special">&lt;&lt;</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">endl</span><span class="special">;</span>
</pre>
</div>
<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
<td align="left"></td>
<td align="right"><small>Copyright © 2001-2005 Joel de Guzman, Dan Marsden</small></td>
</tr></table>
<hr>
<div class="spirit-nav">
<a accesskey="p" href="filter_view.html"><img src="../../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../views.html"><img src="../../../images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../images/home.png" alt="Home"></a><a accesskey="n" href="joint_view.html"><img src="../../../images/next.png" alt="Next"></a>
</div>
</body>
</html>