[ceph.git] / ceph / src / boost / libs / iterator / doc / counting_iterator.rst

.. Distributed under the Boost
.. Software License, Version 1.0. (See accompanying
.. file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

+++++++++++++++++++
 Counting Iterator
+++++++++++++++++++

:Author: David Abrahams, Jeremy Siek, Thomas Witt
:Contact: dave@boost-consulting.com, jsiek@osl.iu.edu, witt@ive.uni-hannover.de
:organization: `Boost Consulting`_, Indiana University `Open Systems
               Lab`_, University of Hanover `Institute for Transport
               Railway Operation and Construction`_
:date: $Date$
:copyright: Copyright David Abrahams, Jeremy Siek, and Thomas Witt 2003. 

.. _`Boost Consulting`: http://www.boost-consulting.com
.. _`Open Systems Lab`: http://www.osl.iu.edu
.. _`Institute for Transport Railway Operation and Construction`: http://www.ive.uni-hannover.de

:abstract: How would you fill up a vector with the numbers zero
  through one hundred using ``std::copy()``?  The only iterator
  operation missing from builtin integer types is an
  ``operator*()`` that returns the current value of the integer.
  The counting iterator adaptor adds this crucial piece of
  functionality to whatever type it wraps.  One can use the
  counting iterator adaptor not only with integer types, but with
  any incrementable type.

  .. include:: counting_iterator_abstract.rst

.. contents:: Table of Contents

``counting_iterator`` synopsis
..............................

.. include:: counting_iterator_ref.rst
.. include:: make_counting_iterator.rst

.. include:: counting_iterator_eg.rst

.. _iterator-category: iterator_facade.html#iterator-category
.. |iterator-category| replace:: *iterator-category*
Commit	Line	Data
7c673cae FG	1	.. Distributed under the Boost
	2	.. Software License, Version 1.0. (See accompanying
	3	.. file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
	4
	5	+++++++++++++++++++
	6	Counting Iterator
	7	+++++++++++++++++++
	8
	9	:Author: David Abrahams, Jeremy Siek, Thomas Witt
	10	:Contact: dave@boost-consulting.com, jsiek@osl.iu.edu, witt@ive.uni-hannover.de
	11	:organization: `Boost Consulting`_, Indiana University `Open Systems
	12	Lab`_, University of Hanover `Institute for Transport
	13	Railway Operation and Construction`_
	14	:date: $Date$
	15	:copyright: Copyright David Abrahams, Jeremy Siek, and Thomas Witt 2003.
	16
	17	.. _`Boost Consulting`: http://www.boost-consulting.com
	18	.. _`Open Systems Lab`: http://www.osl.iu.edu
	19	.. _`Institute for Transport Railway Operation and Construction`: http://www.ive.uni-hannover.de
	20
	21	:abstract: How would you fill up a vector with the numbers zero
	22	through one hundred using ``std::copy()``? The only iterator
	23	operation missing from builtin integer types is an
	24	``operator*()`` that returns the current value of the integer.
	25	The counting iterator adaptor adds this crucial piece of
	26	functionality to whatever type it wraps. One can use the
	27	counting iterator adaptor not only with integer types, but with
	28	any incrementable type.
	29
	30	.. include:: counting_iterator_abstract.rst
	31
	32	.. contents:: Table of Contents
	33
	34	``counting_iterator`` synopsis
	35	..............................
	36
	37	.. include:: counting_iterator_ref.rst
	38	.. include:: make_counting_iterator.rst
	39
	40	.. include:: counting_iterator_eg.rst
	41
	42	.. _iterator-category: iterator_facade.html#iterator-category
	43	.. \|iterator-category\| replace:: iterator-category