RhinoList<T>
References[Serializable]
[DebuggerTypeProxy(ListDebuggerDisplayProxy<>)]
[DebuggerDisplay("Count = {Count}")]
public class RhinoList<T> : IList<T>, IList, ICloneable
Represents a list of generic data. This class is similar to System.Collections.Generic.List(T) but exposes a few more methods.
Type parameters:
| T |
Constructors
RhinoList
#Initializes this list as a shallow duplicate of another list, array or any other enumerable set of T.
RhinoList
#Initializes a new list with a specified amount of values.
public RhinoList()
amount,
Number of values to add to this list. Must be equal to or larger than zero.
T
defaultValue
Value to add, for reference types, the same item will be added over and over again.
RhinoList
#Initializes an new list by shallow duplicating another list.
public RhinoList()
RhinoList<T>
list
List to mimic.
Properties
Capacity
#Gets or sets the total number of elements the internal data structure can hold without resizing.
First
#Gets or sets the first item in the list. This is synonymous to calling List[0].
public T First { get; set; }
Last
#Gets or sets the last item in the list. This is synonymous to calling List[Count-1].
public T Last { get; set; }
NullCount
#Gets the number of null references (Nothing in Visual Basic) in this list. If T is a ValueType, this property always return zero.
When implemented by a class, gets a value indicating whether the IList is read-only. RhinoList is never ReadOnly.
When implemented by a class, gets a value indicating whether access to the ICollection is synchronized (thread-safe). ON_List is never Synchronized.
Gets an object that can be used to synchronize access to the ICollection.
When implemented by a class, gets a value indicating whether the IList has a fixed size. RhinoList is never fixed.
When implemented by a class, gets a value indicating whether the IList is read-only. RhinoList is never ReadOnly.
Indexers
Gets or sets the element at the specified index.
Returns: The element at the specified index.
Methods
AddRange
#Adds the elements of the specified collection to the end of the List.
public void AddRange()
collection
The collection whose elements should be added to the end of the List. The collection itself cannot be a null reference (Nothing in Visual Basic), but it can contain elements that are a null reference (Nothing in Visual Basic). Objects in collection which cannot be represented as T will throw exceptions.
AddRange
#Adds the elements of the specified collection to the end of the List.
public void AddRange()
collection
The collection whose elements should be added to the end of the List. The collection itself cannot be a null reference (Nothing in Visual Basic), but it can contain elements that are a null reference (Nothing in Visual Basic), if type T is a reference type.
BinarySearch
#Searches the entire sorted List for an element using the specified comparer and returns the zero-based index of the element.
public int BinarySearch()
index,
The zero-based starting index of the range to search.
count,
The length of the range to search.
T
item,
The object to locate. The value can be a null reference (Nothing in Visual Basic) for reference types.
comparer
The IComparer(T) implementation to use when comparing elements. Or a null reference (Nothing in Visual Basic) to use the default comparer Comparer(T)::Default.
Returns: The zero-based index of item in the sorted List, if item is found; otherwise, a negative number that is the bitwise complement of the index of the next element that is larger than item or, if there is no larger element, the bitwise complement of Count.
BinarySearch
#Searches the entire sorted List for an element using the specified comparer and returns the zero-based index of the element.
public int BinarySearch()
T
item,
The object to locate. The value can be a null reference (Nothing in Visual Basic) for reference types.
comparer
The IComparer(T) implementation to use when comparing elements. Or a null reference (Nothing in Visual Basic) to use the default comparer Comparer(T)::Default.
Returns: The zero-based index of item in the sorted List, if item is found; otherwise, a negative number that is the bitwise complement of the index of the next element that is larger than item or, if there is no larger element, the bitwise complement of Count.
BinarySearch
#Searches the entire sorted List for an element using the default comparer and returns the zero-based index of the element.
public int BinarySearch()
T
item
The object to locate. The value can be a null reference (Nothing in Visual Basic) for reference types.
Returns: The zero-based index of item in the sorted List, if item is found; otherwise, a negative number that is the bitwise complement of the index of the next element that is larger than item or, if there is no larger element, the bitwise complement of Count.
Contains
#Determines whether an element is in the List.
public bool Contains()
T
item
The object to locate in the List. The value can be a null reference (Nothing in Visual Basic) for reference types.
Returns: true if item is found in the List; otherwise, false.
ConvertAll<TOutput>
#Aggregates all results of a conversion function over this table into a new list.
Returns: The new list.
CopyTo
#Copies a range of elements from the List to a compatible one-dimensional array, starting at the specified index of the target array.
public void CopyTo()
index,
The zero-based index in the source List at which copying begins.
T[]
array,
The one-dimensional Array that is the destination of the elements copied from List. The Array must have zero-based indexing.
arrayIndex,
The zero-based index in array at which copying begins.
count
The number of elements to copy.
CopyTo
#Copies the entire List to a compatible one-dimensional array, starting at the specified index of the target array.
public void CopyTo()
T[]
array,
The one-dimensional Array that is the destination of the elements copied from List. The Array must have zero-based indexing.
arrayIndex
The zero-based index in array at which copying begins.
CopyTo
#Copies the entire List to a compatible one-dimensional array, starting at the beginning of the target array.
public void CopyTo()
T[]
array
The one-dimensional Array that is the destination of the elements copied from List. The Array must have zero-based indexing.
Duplicate
#Returns a shallow copy of this instance. If the generic type is comprised of only value types (struct, enum, ptr), then the result will be a deep copy.
Returns: The duplicated list.
Exists
#Determines whether the List contains elements that match the conditions defined by the specified predicate.
Returns: true if the List contains one or more elements that match the conditions defined by the specified predicate; otherwise, false.
Find
#Searches for an element that matches the conditions defined by the specified predicate, and returns the first occurrence within the entire List.
public T Find()
match
The Predicate(T) delegate that defines the conditions of the element to search for.
Returns: The first element that matches the conditions defined by the specified predicate, if found; otherwise, the default value for type T.
FindAll
#Retrieves all the elements that match the conditions defined by the specified predicate.
Returns: A ON_List(T) containing all the elements that match the conditions defined by the specified predicate, if found; otherwise, an empty ON_List(T).
FindIndex
#Searches for an element that matches the conditions defined by the specified predicate, and returns the zero-based index of the first occurrence within the range of elements in the List that extends from the specified index to the last element.
Returns: The zero-based index of the first occurrence of an element that matches the conditions defined by match, if found; otherwise, -1.
FindIndex
#Searches for an element that matches the conditions defined by the specified predicate, and returns the zero-based index of the first occurrence within the entire List.
Returns: The zero-based index of the first occurrence of an element that matches the conditions defined by match, if found; otherwise, -1.
FindIndex
#Searches for an element that matches the conditions defined by the specified predicate, and returns the zero-based index of the first occurrence within the entire List.
Returns: The zero-based index of the first occurrence of an element that matches the conditions defined by match, if found; otherwise, -1.
FindLast
#Searches for an element that matches the conditions defined by the specified predicate, and returns the last occurrence within the entire List.
public T FindLast()
match
The Predicate(T) delegate that defines the conditions of the element to search for.
Returns: The last element that matches the conditions defined by the specified predicate, if found; otherwise, the default value for type T.
FindLastIndex
#Searches for an element that matches the conditions defined by the specified predicate, and returns the zero-based index of the last occurrence within the entire List.
Returns: The zero-based index of the last occurrence of an element that matches the conditions defined by match, if found; otherwise, -1.
FindLastIndex
#Searches for an element that matches the conditions defined by the specified predicate, and returns the zero-based index of the last occurrence within the entire List.
Returns: The zero-based index of the last occurrence of an element that matches the conditions defined by match, if found; otherwise, -1.
FindLastIndex
#Searches for an element that matches the conditions defined by the specified predicate, and returns the zero-based index of the last occurrence within the entire List.
Returns: The zero-based index of the last occurrence of an element that matches the conditions defined by match, if found; otherwise, -1.
GetEnumerator
#Constructs an enumerator that is capable of iterating over all items in this list.
Returns: The new enumerator.
GetRange
#Constructs a shallow copy of a range of elements in the source List.
Returns: A shallow copy of a range of elements in the source List.
IndexOf
#Searches for the specified object and returns the zero-based index of the first occurrence within the range of elements in the List that starts at the specified index and contains the specified number of elements.
Returns: The zero-based index of the first occurrence of item within the entire List, if found; otherwise, -1.
IndexOf
#Searches for the specified object and returns the zero-based index of the first occurrence within the range of elements in the List that extends from the specified index to the last element.
Returns: The zero-based index of the first occurrence of item within the entire List, if found; otherwise, -1.
IndexOf
#Searches for the specified object and returns the zero-based index of the first occurrence within the entire List.
public int IndexOf()
T
item
The object to locate in the List. The value can be a null reference (Nothing in Visual Basic) for reference types.
Returns: The zero-based index of the first occurrence of item within the entire List, if found; otherwise, -1.
Insert
#Inserts an element into the List at the specified index.
public void Insert()
index,
The zero-based index at which item should be inserted.
T
item
The object to insert. The value can be a null reference (Nothing in Visual Basic) for reference types.
InsertRange
#Inserts the elements of a collection into the List at the specified index.
public void InsertRange()
index,
The zero-based index at which the new elements should be inserted.
collection
The collection whose elements should be inserted into the List. The collection itself cannot be a null reference (Nothing in Visual Basic), but it can contain elements that are a null reference (Nothing in Visual Basic), if type T is a reference type.
LastIndexOf
#Searches for the specified object and returns the zero-based index of the last occurrence within the range of elements in the List that contains the specified number of elements and ends at the specified index.
Returns: The zero-based index of the last occurrence of item within the entire the List, if found; otherwise, -1.
LastIndexOf
#Searches for the specified object and returns the zero-based index of the last occurrence within the range of elements in the List that extends from the first element to the specified index.
Returns: The zero-based index of the last occurrence of item within the entire the List, if found; otherwise, -1.
LastIndexOf
#Searches for the specified object and returns the zero-based index of the last occurrence within the entire List.
public int LastIndexOf()
T
item
The object to locate in the List. The value can be a null reference (Nothing in Visual Basic) for reference types.
Returns: The zero-based index of the last occurrence of item within the entire the List, if found; otherwise, -1.
Remove
#Removes the first occurrence of a specific object from the List.
public bool Remove()
T
item
The object to remove from the List. The value can be a null reference (Nothing in Visual Basic) for reference types.
Returns: true if item is successfully removed; otherwise, false. This method also returns false if item was not found in the List.
RemoveAll
#Removes the all the elements that match the conditions defined by the specified predicate.
Returns: The number of elements removed from the List.
RemoveNulls
#Removes all elements from the List that are null references (Nothing in Visual Basic). This function will not do anything if T is not a Reference type.
Returns: The number of nulls removed from the List.
RemoveRange
#Removes a range of elements from the List.
Reverse
#Reverses the order of the elements in the specified range.
Sort
#Sort this list based on a list of numeric keys of equal length. The keys array will not be altered.
Remarks: This function does not exist on the DotNET List class. David thought it was a good idea.
Sort
#Sorts the elements in the entire list using the specified System.Comparison(T)
public void Sort()
comparer
The IComparer(T) implementation to use when comparing elements, or a null reference (Nothing in Visual Basic) to use the default comparer Comparer(T).Default.
Sort
#Sorts the elements in a range of elements in list using the specified comparer.
public void Sort()
index,
The zero-based starting index of the range to sort.
count,
The length of the range to sort.
comparer
The IComparer(T) implementation to use when comparing elements, or a null reference (Nothing in Visual Basic) to use the default comparer Comparer(T).Default.
Sort
#Sort this list based on a list of numeric keys of equal length. The keys array will not be altered.
Remarks: This function does not exist on the DotNET List class. David thought it was a good idea.
Copies the elements of the ICollection to an Array, starting at a particular Array index.
void ICollection.CopyTo()
array,
The one-dimensional Array that is the destination of the elements copied from ICollection. The Array must have zero-based indexing.
arrayIndex
The zero-based index in array at which copying begins.
Adds an item to the IList.
Returns: The position into which the new element was inserted.
Determines whether an element is in the List.
Returns: true if item is found in the List; otherwise, false.
Searches for the specified object and returns the zero-based index of the first occurrence within the entire List.
Returns: The zero-based index of the first occurrence of item within the entire List, if found; otherwise, -1.
Inserts an element into the List at the specified index.
Removes the first occurrence of a specific object from the List.
ToArray
#Constructs an array that contains all items in this list.
public T[] ToArray()
Returns: An array containing all items in this list.
TrimExcess
#Sets the capacity to the actual number of elements in the List, if that number is less than a threshold value.
public void TrimExcess()
Remarks: This function differs from the DotNET implementation of List<T> since that one only trims the excess if the excess exceeds 10% of the list length.
TrueForAll
#Determines whether every element in the List matches the conditions defined by the specified predicate.
Returns: true if every element in the List matches the conditions defined by the specified predicate; otherwise, false. If the list has no elements, the return value is true.