InsertIter (Parallel Template Library (PTL)™ 4.0)

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

Type Parameters:
T - The type of objects to iterate.
TContainer - The type of container that contains the elements inserted before the specified position.
TIterator - The type of iterator that specifies the inserting position.

All Implemented Interfaces:

IBaseIter<InsertIter<T,TContainer,TIterator>>, IDisposable, IOutIter<T,InsertIter<T,TContainer,TIterator>>, IEquatable<InsertIter<T,TContainer,TIterator>>
```
public class InsertIter<T,TContainer extends IInsertSequence<T,TIterator>,TIterator extends IOutIter<T,TIterator>>
extends java.lang.Object
implements IOutIter<T,InsertIter<T,TContainer,TIterator>>
```
Defines an iterator adaptor that functions as an output iterator. It inserts, rather than overwrites, elements into a sequence before a specified iterator.

Constructor Summary

Constructors
Constructor and Description
`InsertIter(InsertIter<T,TContainer,TIterator> x)` Constructs a new instance from another iterator.
`InsertIter(TContainer cnt, TIterator iter)` Constructs an InsertIter that inserts elements in a container before a specified iterator.

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.
`InsertIter<T,TContainer,TIterator>`	`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(InsertIter<T,TContainer,TIterator> other)` Used to implement the Distance method.
`boolean`	`Equals(InsertIter<T,TContainer,TIterator> 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.
`InsertIter<T,TContainer,TIterator>`	`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 current iterator.

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

- Constructor Detail
  - InsertIter
```
public InsertIter(TContainer cnt,
          TIterator iter)
```
    Constructs an InsertIter that inserts elements in a container before a specified iterator.
    
    Parameters:
    cnt - The container into which the InsertIter is to insert elements.
    iter - The position for the insertion.
    
    Throws:
    
    java.lang.NullPointerException - When the container is null.
  - InsertIter
```
public InsertIter(InsertIter<T,TContainer,TIterator> 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<InsertIter<T,TContainer extends IInsertSequence<T,TIterator>,TIterator extends IOutIter<T,TIterator>>>
    
    Returns:
    The iterator category.
  - Copy
```
public InsertIter<T,TContainer,TIterator> Copy()
```
    Creates and returns a copy of the current instance.
    
    Specified by:
    
    Copy in interface IBaseIter<InsertIter<T,TContainer extends IInsertSequence<T,TIterator>,TIterator extends IOutIter<T,TIterator>>>
    
    Returns:
    A copy of the current instance.
  - SetCurrent
```
public void SetCurrent(T value)
```
    Inserts an element at the current iterator. The iterator will be incremented after insertion.
    
    Specified by:
    
    SetCurrent in interface IOutIter<T,InsertIter<T,TContainer extends IInsertSequence<T,TIterator>,TIterator extends IOutIter<T,TIterator>>>
    
    Parameters:
    value - The specified element to be inserted.
  - 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<InsertIter<T,TContainer extends IInsertSequence<T,TIterator>,TIterator extends IOutIter<T,TIterator>>>
  - 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<InsertIter<T,TContainer extends IInsertSequence<T,TIterator>,TIterator extends IOutIter<T,TIterator>>>
  - 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<InsertIter<T,TContainer extends IInsertSequence<T,TIterator>,TIterator extends IOutIter<T,TIterator>>>
  - Next
```
public InsertIter<T,TContainer,TIterator> 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<InsertIter<T,TContainer extends IInsertSequence<T,TIterator>,TIterator extends IOutIter<T,TIterator>>>
    
    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<InsertIter<T,TContainer extends IInsertSequence<T,TIterator>,TIterator extends IOutIter<T,TIterator>>>
    
    Parameters:
    offset - The number of positions the iterator is to be offset.
  - Distance
```
public long Distance(InsertIter<T,TContainer,TIterator> other)
```
    Used to implement the Distance method.
    
    Specified by:
    
    Distance in interface IBaseIter<InsertIter<T,TContainer extends IInsertSequence<T,TIterator>,TIterator extends IOutIter<T,TIterator>>>
    
    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 InsertIter 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(InsertIter<T,TContainer,TIterator> other)
```
    Tests whether this instance is equal to a specified object.
    
    Specified by:
    
    Equals in interface IEquatable<InsertIter<T,TContainer extends IInsertSequence<T,TIterator>,TIterator extends IOutIter<T,TIterator>>>
    
    Parameters:
    other - An object to compare with this instance.
    
    Returns:
    True if other equals the value of this instance; otherwise, false.

Class InsertIter<T,TContainer extends IInsertSequence<T,TIterator>,TIterator extends IOutIter<T,TIterator>>

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

InsertIter

InsertIter

Method Detail

Dispose

Category

Copy

SetCurrent

ResetBegin

ResetEnd

Increment

Next

Advance

Advance

Distance

equals

hashCode

Equals