Skip to content. Skip to navigation

ICTP Portal

Sections
You are here: Home Manuals on-line PGI Compiler pgC_lib Output Iterators
Personal tools
Document Actions

Output Iterators



Click on the banner to return to the class reference home page.

Output Iterators


Iterator

Summary

A write-only, forward moving iterator.

Data Type and Member Function Indexes
(exclusive of constructors and destructors)

None

Description


For a complete discussion of iterators, see the Iterators section of this reference.


Iterators are a generalization of pointers that allow a C++ program to uniformly interact with different data structures. Output iterators are write-only, forward moving iterators that satisfy the requirements listed below. Note that unlike other iterators used with the standard library, output iterators cannot be constant.

Key to Iterator Requirements

The following key pertains to the iterator requirements listed below:

a and b
values of type X
n
value of distance type
u, Distance, tmp and m
identifiers
r
value of type X&
t
value of type T

Requirements for Output Iterators

The following expressions must be valid for output iterators:

X(a)
copy constructor, a == X(a).
X u(a)
copy constructor, u == a
X u = a
assignment, u == a
*a = t
result is not used
++r
returns X&
r++
return value convertible to const X&
*r++ = t
result is not used

The only valid use for the operator * is on the left hand side of the assignment statement.

Algorithms using output iterators should be single pass algorithms. That is, they should not pass through the same iterator twice.

See Also

Iterators, Input Iterators


©Copyright 1996, Rogue Wave Software, Inc.


Powered by Plone This site conforms to the following standards: