Provide an output iterator that calls an object of the (template parameter) type FUNCTION. If FUNCTION is a functor, de-referencing this iterator and assigning to the result (of dereferencing) will call the operator() of the functor with the assigned value as a parameter. Similarly, if FUNCTION if a function pointer type, assigning to the dereferenced iterator will call the function supplied at construction with the assigned value as a parameter.
Declared in <bdlb_functionoutputiterator.h>
template<class FUNCTION>
class FunctionOutputIterator;| Name | Description |
|---|---|
difference_type | Unused difference type required by iterator_traits (always void). |
iterator_category | Tag identifying this type as an output iterator. |
pointer | Unused pointer type required by iterator_traits (always void). |
reference | Unused reference type required by iterator_traits (always void). |
value_type | Unused value type required by iterator_traits (always void). |
| Name | Description |
|---|---|
FunctionOutputIterator [constructor] | Constructors |
operator* | Return an object that can appear on the left-hand side of an assignment from TYPE. When a value is assigned to the returned value, invoke the functor or function indicated at construction supplying the assigned value as the parameter. This function is non-const in accordance with the input iterator requirements, even though *this is not modified. Note that if FUNCTION is a function pointer type and a valid function pointer was not supplied at construction, then the behavior when assigning to a dereferenced iterator will be undefined. |
| Name | Description |
|---|---|
operator++ | Do nothing and return specified iterator. |
operator++ | Do nothing and return specified iterator. |