Loyc.Collections.AListReverseView< K, T > Struct Template Reference

A reverse view of an AList. More...

---

Source file:

• /Core/Loyc.Collections/ALists/AListBase.cs

Inheritance diagram for Loyc.Collections.AListReverseView< K, T >:

Remarks

A reverse view of an AList.

Public fields
AListBase< K, T >	_list

Properties
T	this[int index] [get]
int	Count [get]

Public Member Functions
	AListReverseView (AListBase< K, T > list)
T	TryGet (int index, out bool fail)
	Gets the item at the specified index, and does not throw an exception on failure. More...
ReverseBinumerator< T >	GetEnumerator ()
IEnumerator< T > IEnumerable< T >.	GetEnumerator ()
System.Collections.IEnumerator System.Collections.IEnumerable.	GetEnumerator ()
IRange< T > IListSource< T >.	Slice (int start, int count)
	Returns a sub-range of this list. More...
Slice_< T >	Slice (int start, int count)
	Returns a sub-range of this list. More...

Member Function Documentation

IRange<T> IListSource<T>. Loyc.Collections.AListReverseView< K, T >.Slice ( int  start, int  count  )

inline

Returns a sub-range of this list.

Parameters

start	The new range will start at this index in the current list (this location will be index [0] in the new range).
count	The desired number of elements in the new range, or int.MaxValue to get all elements until the end of the list.

Returns

Returns a sub-range of this range.

Exceptions

ArgumentException

The start index was below zero.

The (start, count) range is allowed to be invalid, as long as start is zero or above.

• If count is below zero, or if start is above the original Count, the Count of the new slice is set to zero.
• if (start + count) is above the original Count, the Count of the new slice is reduced to this.Count - start. Implementation note: do not compute (start + count) because it may overflow. Instead, test whether (count > this.Count - start).

Most collections should use the following implementation:

IRange<T> IListSource<T>.Slice(int start, int count) { return Slice(start, count); }
public Slice_<T> Slice(int start, int count) { return new Slice_<T>(this, start, count); }

Implements Loyc.Collections.IListSource< out T >.

References Loyc.Collections.AListReverseView< K, T >.Slice().

Referenced by Loyc.Collections.AListReverseView< K, T >.Slice().

Slice_<T> Loyc.Collections.AListReverseView< K, T >.Slice ( int  start, int  count  )

inline

Returns a sub-range of this list.

Parameters

start	The new range will start at this index in the current list (this location will be index [0] in the new range).
count	The desired number of elements in the new range, or int.MaxValue to get all elements until the end of the list.

Returns

Returns a sub-range of this range.

Exceptions

ArgumentException

The start index was below zero.

The (start, count) range is allowed to be invalid, as long as start is zero or above.

• If count is below zero, or if start is above the original Count, the Count of the new slice is set to zero.
• if (start + count) is above the original Count, the Count of the new slice is reduced to this.Count - start. Implementation note: do not compute (start + count) because it may overflow. Instead, test whether (count > this.Count - start).

Most collections should use the following implementation:

IRange<T> IListSource<T>.Slice(int start, int count) { return Slice(start, count); }
public Slice_<T> Slice(int start, int count) { return new Slice_<T>(this, start, count); }

Implements Loyc.Collections.IListSource< out T >.

T Loyc.Collections.AListReverseView< K, T >.TryGet ( int  index, out bool  fail  )

inline

Gets the item at the specified index, and does not throw an exception on failure.

Parameters

index	An index in the range 0 to Count-1.
fail	A flag that is set on failure.

Returns

The element at the specified index, or default(T) if the index is not valid.

In my original design, the caller could provide a value to return on failure, but this would not allow T to be marked as "out" in C# 4. For the same reason, we cannot have a ref/out T parameter. Instead, the following extension methods are provided:

bool TryGet(int index, ref T value);
T TryGet(int, T defaultValue);

Implements Loyc.Collections.IListSource< out T >.