ContainerRandomAccessIterator<TValue> Class

Definition

Provides an iterator that supports the following operations: moving forward one position by calling operator++, moving backward one position by calling operator--, accessing an element by using operator[], and accessing an element by using pointer arithmetic.

generic <typename TValue>
public ref class ContainerRandomAccessIterator : Microsoft::VisualC::StlClr::Generic::IRandomAccessIterator<TValue>
public class ContainerRandomAccessIterator<TValue> : Microsoft.VisualC.StlClr.Generic.IRandomAccessIterator<TValue>
type ContainerRandomAccessIterator<'Value> = class
    interface IRandomAccessIterator<'Value>
Public Class ContainerRandomAccessIterator(Of TValue)
Implements IRandomAccessIterator(Of TValue)

Type Parameters

TValue

The type of an element in the controlled sequence.

Inheritance
ContainerRandomAccessIterator<TValue>
Implements

Remarks

Some methods, especially operators, declare a type for a parameter but do not specify a parameter name. Such a parameter is known as an unnamed parameter. In the documentation for these methods, the A_0 placeholder represents the unnamed parameter.

Constructors

ContainerRandomAccessIterator<TValue>()

Allocates and initializes a new ContainerRandomAccessIterator<TValue> object.

ContainerRandomAccessIterator<TValue>(ContainerRandomAccessIterator<TValue>)

Allocates and initializes a new ContainerRandomAccessIterator<TValue> object from an existing ContainerRandomAccessIterator<TValue> object.

ContainerRandomAccessIterator<TValue>(IRandomAccessContainer<TValue>, Int32)

Allocates and initializes a new ContainerRandomAccessIterator<TValue> object from an existing IRandomAccessContainer<TValue> object.

Properties

Item[Int32]

Accesses the element at the given position in the container.

Methods

Clone()

Creates a copy of the current ContainerRandomAccessIterator<TValue> object.

container()

Gets the container that the iterator is traversing.

distance(ContainerRandomAccessIterator<TValue>)

Determines the distance between the element that the current iterator is pointing to and the element that the given iterator is pointing to.

distance(IRandomAccessIterator<TValue>)

Determines the distance between the element that the current iterator is pointing to and the element that the given iterator is pointing to.

equal_to(ContainerRandomAccessIterator<TValue>)

Determines whether the given ContainerRandomAccessIterator<TValue> object is the same as the current ContainerRandomAccessIterator<TValue> object.

equal_to(IInputIterator<TValue>)

Determines whether the given IInputIterator<TValue> object is the same as the current ContainerRandomAccessIterator<TValue> object.

Equals(Object)

Determines whether the specified object is equal to the current object.

(Inherited from Object)
get_bias()

Gets the bias of the iterator. The bias is the offset of the iterator from element zero.

get_cref()

Returns a constant reference to the element that the iterator is currently pointing to.

get_node()

Gets the node, or element, that the iterator is pointing to.

get_ref()

Returns a reference to the element that the iterator is currently pointing to.

GetHashCode()

Serves as the default hash function.

(Inherited from Object)
GetType()

Gets the Type of the current instance.

(Inherited from Object)
less_than(ContainerRandomAccessIterator<TValue>)

Determines whether the current iterator is pointing to an element in the container that is before the element that the given iterator points to.

less_than(IRandomAccessIterator<TValue>)

Determines whether the current iterator is pointing to an element in the container that is before the element that the given iterator points to.

MemberwiseClone()

Creates a shallow copy of the current Object.

(Inherited from Object)
move(Int32)

Moves the iterator by the given number of elements.

next()

Increments the iterator to the next position in the underlying container, or to the first position beyond the end of container if the container has been completely traversed.

prev()

Positions the iterator to the element immediately before the current element.

ToString()

Returns a string that represents the current object.

(Inherited from Object)
valid()

Determines whether the iterator is valid and can be safely used to traverse the underlying container.

Operators

Addition(ContainerRandomAccessIterator<TValue>, Int32)

Increments the iterator by the given number of elements. The integer parameter is specified on the right side of the addition operator.

Addition(ContainerRandomAccessIterator<TValue>, Int32, ContainerRandomAccessIterator<TValue>)

Increments the iterator by the given number of elements. The integer parameter is specified on the left side of the addition operator.

Assign(ContainerRandomAccessIterator<TValue>)

Assigns the given ContainerRandomAccessIterator<TValue> object to the current object.

Decrement(ContainerRandomAccessIterator<TValue>)

Decrements the iterator by one element. This is the prefix version of the decrement operator.

Decrement(Int32, Int32)

Decrements the iterator by one element. This is the postfix version of the decrement operator.

Equality(ContainerRandomAccessIterator<TValue>)

Determines whether the given ContainerRandomAccessIterator<TValue> object is the same as the current ContainerRandomAccessIterator<TValue> object.

Equality(IInputIterator<TValue>)

Determines whether the given IInputIterator<TValue> object is the same as the current ContainerRandomAccessIterator<TValue> object.

GreaterThan(ContainerRandomAccessIterator<TValue>)

Determines whether the position of the left-side iterator is greater than the position of the given right-side iterator.

GreaterThan(IRandomAccessIterator<TValue>, ContainerRandomAccessIterator<TValue>)

Determines whether the position of the given left-side iterator is greater than the position of the given right-side iterator.

GreaterThanOrEqual(ContainerRandomAccessIterator<TValue>)

Determines whether the position of the left-side iterator is greater than or equal to the position of the given right-side iterator.

GreaterThanOrEqual(IRandomAccessIterator<TValue>)

Determines whether the position of the left-side iterator is greater than or equal to the position of the given right-side iterator.

Implicit

Converts a ContainerRandomAccessIterator<TValue> to an IRandomAccessIterator<TValue>.

Increment(ContainerRandomAccessIterator<TValue>)

Increments the iterator by one element. This is the prefix version of the increment operator.

Increment(Int32, Int32)

Increments the iterator by one element. This is the postfix version of the increment operator.

Inequality(ContainerRandomAccessIterator<TValue>)

Determines whether the given ContainerRandomAccessIterator<TValue> object differs from the current ContainerRandomAccessIterator<TValue> object.

Inequality(IInputIterator<TValue>)

Determines whether the given IInputIterator<TValue> object differs from the current ContainerRandomAccessIterator<TValue> object.

LessThan(ContainerRandomAccessIterator<TValue>)

Determines whether the position of the left-side iterator is less than the position of the given right-side iterator.

LessThan(IRandomAccessIterator<TValue>)

Determines whether the position of the left-side iterator is less than the position of the given right-side iterator.

LessThanOrEqual(ContainerRandomAccessIterator<TValue>)

Determines whether the position of the left-side iterator is less than or equal to the position of the given right-side iterator.

LessThanOrEqual(IRandomAccessIterator<TValue>, ContainerRandomAccessIterator<TValue>)

Determines whether the position of the given left-side iterator is less than the position of the given right-side iterator.

MemberSelection(ContainerRandomAccessIterator<TValue>)

Returns the element that the iterator is currently pointing to.

PointerDereference(ContainerRandomAccessIterator<TValue>)

Returns the element that the iterator is currently pointing to.

Subtraction(ContainerRandomAccessIterator<TValue>, Int32)

Decrements the iterator by the given number of elements. The integer parameter is specified on the right side of the subtraction operator.

Subtraction(IRandomAccessIterator<TValue>)

Determines the difference between two iterators.

Applies to