Files
boost_fusion/doc/html/fusion/sequences/views/iterator_range.html
Joel de Guzman 6ca462baa0 doc updates
[SVN r35784]
2006-10-30 01:20:23 +00:00

188 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.66.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="id492870"></a>
<a href="iterator_range.html#fusion.sequences.views.iterator_range.description">Description</a>
</h5>
<p>
<tt class="computeroutput"><span class="identifier">iterator_range</span></tt> 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="id492913"></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="id493017"></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="id493114"></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><tt class="computeroutput"><span class="identifier">First</span></tt></td>
<td>A
fusion <a href="../../iterators.html" title="Iterators">Iterator</a>
</td>
<td> </td>
</tr>
<tr>
<td><tt class="computeroutput"><span class="identifier">Last</span></tt></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="id493225"></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"><tt class="computeroutput"><span class="identifier">IR</span></tt></span></dt>
<dd>
An <tt class="computeroutput"><span class="identifier">iterator_range</span></tt> type
</dd>
<dt><span class="term"><tt class="computeroutput"><span class="identifier">f</span></tt></span></dt>
<dd>
An instance of <tt class="computeroutput"><span class="identifier">First</span></tt>
</dd>
<dt><span class="term"><tt class="computeroutput"><span class="identifier">l</span></tt></span></dt>
<dd>
An instance of <tt class="computeroutput"><span class="identifier">Last</span></tt>
</dd>
<dt><span class="term"><tt class="computeroutput"><span class="identifier">ir</span></tt>,
<tt class="computeroutput"><span class="identifier">ir2</span></tt></span></dt>
<dd>
Instances of <tt class="computeroutput"><span class="identifier">iterator_range</span></tt>
</dd>
</dl>
</div>
<a name="fusion.sequences.views.iterator_range.expression_semantics"></a><h5>
<a name="id493396"></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><tt 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></tt></td>
<td>Creates
an <tt class="computeroutput"><span class="identifier">iterator_range</span></tt>
given iterators, <tt class="computeroutput"><span class="identifier">f</span></tt>
and <tt class="computeroutput"><span class="identifier">l</span></tt>.</td>
</tr>
<tr>
<td><tt class="computeroutput"><span class="identifier">IR</span><span class="special">(</span><span class="identifier">ir</span><span class="special">)</span></tt></td>
<td>Copy
constructs an <tt class="computeroutput"><span class="identifier">iterator_range</span></tt>
from another <tt class="computeroutput"><span class="identifier">iterator_range</span></tt>,
<tt class="computeroutput"><span class="identifier">ir</span></tt>.</td>
</tr>
<tr>
<td><tt class="computeroutput"><span class="identifier">ir</span> <span class="special">=</span> <span class="identifier">ir2</span></tt></td>
<td>Assigns to a
<tt class="computeroutput"><span class="identifier">iterator_range</span></tt>,
<tt class="computeroutput"><span class="identifier">ir</span></tt>, from another
<tt class="computeroutput"><span class="identifier">iterator_range</span></tt>,
<tt class="computeroutput"><span class="identifier">ir2</span></tt>.</td>
</tr>
</tbody>
</table></div>
<a name="fusion.sequences.views.iterator_range.example"></a><h5>
<a name="id493676"></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"><tt class="computeroutput"><span class="identifier">vector</span></tt></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"><tt class="computeroutput"><span class="identifier">result_of</span><span class="special">::</span><span class="identifier">begin</span></tt></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"><tt class="computeroutput"><span class="identifier">result_of</span><span class="special">::</span><span class="identifier">end</span></tt></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"><tt class="computeroutput"><span class="identifier">result_of</span><span class="special">::</span><span class="identifier">next</span></tt></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"><tt class="computeroutput"><span class="identifier">result_of</span><span class="special">::</span><span class="identifier">prior</span></tt></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>