BackInsertIter (Parallel Template Library (PTL)™ 4.0)

java.lang.Object
- Progeneric.Ptl.Iterators.BackInsertIter<T,TContainer>

Type Parameters:
T - The type of objects to iterate.
TContainer - The type of container that contains the elements inserted into the back.

All Implemented Interfaces:

IBaseIter<BackInsertIter<T,TContainer>>, IDisposable, IOutIter<T,BackInsertIter<T,TContainer>>, IEquatable<BackInsertIter<T,TContainer>>
```
public class BackInsertIter<T,TContainer extends IBackSequence<T>>
extends java.lang.Object
implements IOutIter<T,BackInsertIter<T,TContainer>>
```
Defines an iterator adaptor that functions as an output iterator. It inserts, rather than overwrites, elements into the back end of a sequence.

Constructor Summary

Constructors
Constructor and Description
`BackInsertIter(BackInsertIter<T,TContainer> x)` Constructs a new instance from another iterator.
`BackInsertIter(TContainer cnt)` Constructs a BackInsertIter that inserts elements after the last element in a container.

Method Summary

Methods
Modifier and Type	Method and Description
`void`	`Advance(int offset)` Used to implement the Advance method.
`void`	`Advance(long offset)` Used to implement the Advance method.
`IteratorCategory`	`Category()` Gets the iterator category.
`BackInsertIter<T,TContainer>`	`Copy()` Creates and returns a copy of the current instance.
`void`	`Dispose()` Performs application-defined tasks associated with freeing, releasing, or resetting system resources or other cleanup.
`long`	`Distance(BackInsertIter<T,TContainer> other)` Used to implement the Distance method.
`boolean`	`Equals(BackInsertIter<T,TContainer> other)` Tests whether this instance is equal to a specified object.
`boolean`	`equals(java.lang.Object obj)` Tests whether this instance is equal to a specified object.
`int`	`hashCode()` Returns the hash code for this instance.
`void`	`Increment()` Used to implement the IOutIter Increment method.
`BackInsertIter<T,TContainer>`	`Next()` Used to implement the IOutIter Next method.
`void`	`ResetBegin()` Used to implement the IOutIter ResetBegin method.
`void`	`ResetEnd()` Used to implement the IOutIter ResetEnd method.
`void`	`SetCurrent(T value)` Inserts an element at the back of the container.

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - BackInsertIter
```
public BackInsertIter(TContainer cnt)
```
    Constructs a BackInsertIter that inserts elements after the last element in a container.
    Remarks: A BackInsertIter must always be initialized with its container.
    
    Parameters:
    cnt - The container into which the BackInsertIter is to insert elements.
    
    Throws:
    
    java.lang.NullPointerException - When the container is null.
  - BackInsertIter
```
public BackInsertIter(BackInsertIter<T,TContainer> x)
```
    Constructs a new instance from another iterator.
    
    Parameters:
    x - The iterator to copy.
- Method Detail
  - Dispose
```
public void Dispose()
```
    Performs application-defined tasks associated with freeing, releasing, or resetting system resources or other cleanup.
    
    Specified by:
    
    Dispose in interface IDisposable
  - Category
```
public IteratorCategory Category()
```
    Gets the iterator category.
    
    Specified by:
    
    Category in interface IBaseIter<BackInsertIter<T,TContainer extends IBackSequence<T>>>
    
    Returns:
    The iterator category.
  - Copy
```
public BackInsertIter<T,TContainer> Copy()
```
    Creates and returns a copy of the current instance.
    
    Specified by:
    
    Copy in interface IBaseIter<BackInsertIter<T,TContainer extends IBackSequence<T>>>
    
    Returns:
    A copy of the current instance.
  - SetCurrent
```
public void SetCurrent(T value)
```
    Inserts an element at the back of the container.
    
    Specified by:
    
    SetCurrent in interface IOutIter<T,BackInsertIter<T,TContainer extends IBackSequence<T>>>
    
    Parameters:
    value - The new value for the current element.
  - ResetBegin
```
public void ResetBegin()
```
    Used to implement the IOutIter ResetBegin method. This operation has no effect on the current instance.
    
    Specified by:
    
    ResetBegin in interface IBaseIter<BackInsertIter<T,TContainer extends IBackSequence<T>>>
  - ResetEnd
```
public void ResetEnd()
```
    Used to implement the IOutIter ResetEnd method. This operation has no effect on the current instance.
    
    Specified by:
    
    ResetEnd in interface IBaseIter<BackInsertIter<T,TContainer extends IBackSequence<T>>>
  - Increment
```
public void Increment()
```
    Used to implement the IOutIter Increment method. This operation has no effect on the current instance.
    
    Specified by:
    
    Increment in interface IBaseIter<BackInsertIter<T,TContainer extends IBackSequence<T>>>
  - Next
```
public BackInsertIter<T,TContainer> Next()
```
    Used to implement the IOutIter Next method.
    
    Returns:
    The current instance.
  - Advance
```
public void Advance(int offset)
```
    Used to implement the Advance method. This operation has no effect on the current instance.
    
    Specified by:
    
    Advance in interface IBaseIter<BackInsertIter<T,TContainer extends IBackSequence<T>>>
    
    Parameters:
    offset - The number of positions the iterator is to be offset.
  - Advance
```
public void Advance(long offset)
```
    Used to implement the Advance method. This operation has no effect on the current instance.
    
    Specified by:
    
    Advance in interface IBaseIter<BackInsertIter<T,TContainer extends IBackSequence<T>>>
    
    Parameters:
    offset - The number of positions the iterator is to be offset.
  - Distance
```
public long Distance(BackInsertIter<T,TContainer> other)
```
    Used to implement the Distance method.
    
    Specified by:
    
    Distance in interface IBaseIter<BackInsertIter<T,TContainer extends IBackSequence<T>>>
    
    Parameters:
    other - An input iterator addressing the position one past the final element in the range [this, other).
    
    Returns:
    Zero.
  - equals
```
public boolean equals(java.lang.Object obj)
```
    Tests whether this instance is equal to a specified object.
    
    Overrides:
    
    equals in class java.lang.Object
    
    Parameters:
    obj - An object to compare with this instance.
    
    Returns:
    True if obj is an instance of BackInsertIter and equals the value of this instance; otherwise, false.
  - hashCode
```
public int hashCode()
```
    Returns the hash code for this instance.
    
    Overrides:
    
    hashCode in class java.lang.Object
    
    Returns:
    A 32-bit signed integer hash code.
  - Equals
```
public boolean Equals(BackInsertIter<T,TContainer> other)
```
    Tests whether this instance is equal to a specified object.
    
    Specified by:
    
    Equals in interface IEquatable<BackInsertIter<T,TContainer extends IBackSequence<T>>>
    
    Parameters:
    other - An object to compare with this instance.
    
    Returns:
    True if other equals the value of this instance; otherwise, false.

Class BackInsertIter<T,TContainer extends IBackSequence<T>>

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

BackInsertIter

BackInsertIter

Method Detail

Dispose

Category

Copy

SetCurrent

ResetBegin

ResetEnd

Increment

Next

Advance

Advance

Distance

equals

hashCode

Equals