boostorg/utility
1
0
Fork 1
mirror of https://github.com/boostorg/utility.git synced 2025-08-02 14:24:30 +02:00
Code Issues Packages Projects Releases Wiki Activity

changed named parameters doc to match new stuff

Browse Source 
[SVN r11417]
This commit is contained in:
Jeremy Siek
2001-10-22 17:04:23 +00:00
parent 139e33c36d
commit 354aef0e8c
1 changed files with 25 additions and 54 deletions
Download Patch File Download Diff File Expand all files Collapse all files

79
iterator_adaptors.htm
View File

@@ -131,11 +131,11 @@
<p><tt>iterator_adaptor</tt> is declared like this: <p><tt>iterator_adaptor</tt> is declared like this:
<pre> <pre>
template &lt;class Base, class Policies, template &lt;class Base, class Policies,
class ValueOrNamedParams = typename std::iterator_traits&lt;Base&gt;::value_type, class ValueOrNamedParam = typename std::iterator_traits&lt;Base&gt;::value_type,
class ReferenceOrNamedParams = <i>...(see below)</i>, class ReferenceOrNamedParam = <i>...(see below)</i>,
class PointerOrNamedParams = <i>...(see below)</i>, class PointerOrNamedParam = <i>...(see below)</i>,
class CategoryOrNamedParams = typename std::iterator_traits&lt;Base&gt;::iterator_category, class CategoryOrNamedParam = typename std::iterator_traits&lt;Base&gt;::iterator_category,
class DistanceOrNamedParams = typename std::iterator_traits&lt;Base&gt;::difference_type&gt; class DistanceOrNamedParam = typename std::iterator_traits&lt;Base&gt;::difference_type&gt;
struct iterator_adaptor; struct iterator_adaptor;
</pre> </pre>
@@ -208,11 +208,9 @@ struct iterator_adaptor;
<tt>std::iterator_traits&lt;BaseType&gt;::difference_type</tt> <tt>std::iterator_traits&lt;BaseType&gt;::difference_type</tt>
<tr> <tr>
<td><tt>NamedParams</tt> <td><tt>NamedParam</tt>
<td>A list of named template parameters generated using the <td>A named template parameter (see below).
<a href="#iterator_traits_generator">
<tt>iterator_traits_generator</tt></a> class (see below).
</table> </table>
<h3><a name="named_template_parameters">Named Template Parameters</a></h3> <h3><a name="named_template_parameters">Named Template Parameters</a></h3>
@@ -223,59 +221,32 @@ struct iterator_adaptor;
template parameter, but use the defaults for the third through template parameter, but use the defaults for the third through
fifth. As a solution to these problems we provide a mechanism for fifth. As a solution to these problems we provide a mechanism for
naming the last five template parameters, and providing them in naming the last five template parameters, and providing them in
any order through the <tt>iterator_traits_generator</tt> class. any order through a set of named template parameters. The following
classes are provided for specifying the parameters. Any of these
classes can be used for any of the last five template parameters
of <tt>iterator_adaptor</tt>.
<blockquote> <blockquote>
<pre> <pre>
<a name="iterator_traits_generator">class iterator_traits_generator</a> template &lt;class Value&gt; struct value_type_is;
{ template &lt;class Reference&gt; struct reference_is;
public: template &lt;class Pointer&gt; struct pointer_is;
template &lt;class Value&gt; template &lt;class Distance&gt; struct difference_type_is;
struct value_type : public <i>recursive magic</i> { }; template &lt;class Category&gt; struct iterator_category_is;
template &lt;class Reference&gt;
struct reference : public <i>recursive magic</i> { };
template &lt;class Pointer&gt;
struct pointer : public <i>recursive magic</i> { };
template &lt;class Distance&gt;
struct difference_type : public <i>recursive magic</i> { };
template &lt;class Category&gt;
struct iterator_category : public <i>recursive magic</i> { };
};
</pre> </pre>
</blockquote> </blockquote>
The <tt>iterator_traits_generator</tt> is used to create a list of For example, the following adapts <tt>foo_iterator</tt> to create
of template arguments. For example, suppose you want to set the an <a href=
<tt>Reference</tt> and <tt>Category</tt> parameters, and use the "http://www.sgi.com/tech/stl/InputIterator.html">InputIterator</a>
defaults for the rest. Then you can use the traits generator as with <tt>reference</tt> type <tt>foo</tt>, and whose other traits
follows: are determined according to the defaults described <a
href="#template_parameters">above</a>.
<blockquote> <blockquote>
<pre> <pre>
iterator_traits_generator::reference&lt;foo&gt;::category&lt;std::input_iterator_tag&gt; typedef iterator_adaptor&lt;foo_iterator, foo_policies,
</pre> reference_is&lt;foo&gt;, iterator_category_is&lt;std::input_iterator_tag&gt;
</blockquote> &gt; MyIterator;
This generated type can then be passed into the <tt>iterator_adaptor</tt>
class to replace any of the last five parameters. If you use the traits
generator in the <i>i</i>th parameter position, then the parameters <i>i</i>
through 7 will use the types specified in the generator. For example, the
following adapts <tt>foo_iterator</tt> to create an <a href=
"http://www.sgi.com/tech/stl/InputIterator.html">InputIterator</a> with
<tt>reference</tt> type <tt>foo</tt>, and whose other traits are determined
according to the defaults described <a href="#template_parameters">above</a>.
<blockquote>
<pre>
iterator_adaptor&lt;foo_iterator, foo_policies,
iterator_traits_generator
::reference&lt;foo&gt;
::iterator_category&lt;std::input_iterator_tag&gt;
&gt;
</pre> </pre>
</blockquote> </blockquote>