[#BloombergLP-bdlb-NullOutputIterator]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bdlb.adoc[bdlb]::NullOutputIterator
:relfileprefix: ../../
:mrdocs:

Provide an output iterator that ignores the output that is provided. De‐referencing an iterator and assigning to the returned value has no effect.

== Synopsis

Declared in `<bdlb_nulloutputiterator.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<class TYPE>
class NullOutputIterator;
----

== Type Aliases

[cols="1,4"]
|===
| Name| Description
| xref:BloombergLP/bdlb/NullOutputIterator/AssignmentProxy.adoc[`AssignmentProxy`] 
| `AssignmentProxy` is an alias for an object type returned by de‐referencing operator.
| xref:BloombergLP/bdlb/NullOutputIterator/difference_type.adoc[`difference_type`] 
| Type used to represent distances between iterators (unused).
| xref:BloombergLP/bdlb/NullOutputIterator/iterator_category.adoc[`iterator_category`] 
| Standard iterator category for this iterator type.
| xref:BloombergLP/bdlb/NullOutputIterator/pointer.adoc[`pointer`] 
| Pointer type for this iterator (unused).
| xref:BloombergLP/bdlb/NullOutputIterator/reference.adoc[`reference`] 
| 
| xref:BloombergLP/bdlb/NullOutputIterator/value_type.adoc[`value_type`] 
| Type of values that can be written through this iterator.
|===


== Member Functions

[cols="1,4"]
|===
| Name| Description
| xref:BloombergLP/bdlb/NullOutputIterator/2constructor-06.adoc[`NullOutputIterator`]         [.small]#[constructor]#
| Constructors
| xref:BloombergLP/bdlb/NullOutputIterator/2destructor.adoc[`~NullOutputIterator`] [.small]#[destructor]#
| Destroy this object.
| xref:BloombergLP/bdlb/NullOutputIterator/operator_assign.adoc[`operator=`] 
| Assign to this object the value of the specified `rhs` iterator, and return a reference providing modifiable access to this object.
| xref:BloombergLP/bdlb/NullOutputIterator/operator_star.adoc[`operator*`] 
| Return an object that can appear on the left‐hand side of an assignment from `TYPE`. The assignment to the returned object has no effect.
| xref:BloombergLP/bdlb/NullOutputIterator/operator_inc-0b.adoc[`operator++`] 
| Set this object to point to the next writable element, and return a reference providing modifiable access to this object. This operation has no effect.
|===



[.small]#Created with https://www.mrdocs.com[MrDocs]#