C# Class Tanis.Collections.Heap

Inheritance: IList, ICloneable

Exibir arquivo Open project: poeticmatter/tutorials Class Usage Examples

Public Methods

Method	Description
Add ( object O ) : int	IList implementation. Adds the object at the right place.
AddRange ( ICollection C ) : void	The objects will be added at the right place.
Clear ( ) : void	IList implementation. Idem ArrayList
Clone ( ) : object	ICloneable implementation. Idem ArrayList
Contains ( object O ) : bool	IList implementation. Search for a specified object in the list. If the list is sorted, a BinarySearch is performed using IComparer interface. Else the Object.Equals implementation is used.
CopyTo ( Array array, int arrayIndex ) : void	IList.ICollection implementation. Idem ArrayList
Equals ( object Object ) : bool	Object.Equals() override.
GetEnumerator ( ) : IEnumerator	IList.IEnumerable implementation. Idem ArrayList
GetHashCode ( ) : int	Object.GetHashCode() override.
Heap ( ) : System	Default constructor. Since no IComparer is provided here, added objects must implement the IComparer interface.
Heap ( IComparer Comparer ) : System	Constructor.
Heap ( IComparer Comparer, int Capacity ) : System	Constructor.
Heap ( int Capacity ) : System	Constructor. Since no IComparer is provided, added objects must implement the IComparer interface.
IndexOf ( object O ) : int	IList implementation. Returns the index of the specified object in the list. If the list is sorted, a BinarySearch is performed using IComparer interface. Else the Object.Equals implementation of objects is used.
IndexOf ( object Object, Equality AreEqual ) : int	Idem IndexOf(object), but with a specified equality function
IndexOf ( object Object, int Start ) : int	Idem IndexOf(object), but starting at a specified position in the list
IndexOf ( object Object, int Start, Equality AreEqual ) : int	Idem IndexOf(object), but with a start index and a specified equality function
IndexOfMax ( ) : int	Returns the object of the list whose value is maximum
IndexOfMin ( ) : int	Returns the object of the list whose value is minimum
Insert ( int Index, object O ) : void	IList implementation. Cannot be used on a Heap.
InsertRange ( int Index, ICollection C ) : void	Cannot be called on a Heap.
LimitOccurrences ( object Value, int NumberToKeep ) : void	Limits the number of occurrences of a specified value. Same values are equals according to the Equals() method of objects in the list. The first occurrences encountered are kept.
Pop ( ) : object	Returns the topmost object on the list and removes it from the list
Push ( object Object ) : int	Pushes an object on list. It will be inserted at the right spot.
Remove ( object Value ) : void	IList implementation. Idem ArrayList
RemoveAt ( int Index ) : void	IList implementation. Idem ArrayList
RemoveDuplicates ( ) : void	Removes all duplicates in the list. Each value encountered will have only one representant.
ToString ( ) : string	Object.ToString() override. Build a string to represent the list.
getExisting ( object O ) : object
this ( int Index ) : object	IList implementation. Gets object's value at a specified index. The set operation is impossible on a Heap.

Private Methods

Method	Description
InitProperties ( IComparer Comparer, int Capacity ) : void
ObjectIsCompliant ( object Object ) : bool

Method Details

Add() public method

IList implementation. Adds the object at the right place.

The Heap is set to use object's IComparable interface, and the specifed object does not implement this interface.

public Add ( object O ) : int
O	object	The object to add.
return	int

AddRange() public method

The objects will be added at the right place.

The Heap is set to use object's IComparable interface, and the specifed object does not implement this interface.

public AddRange ( ICollection C ) : void
C	ICollection	The object to add.
return	void

Clear() public method

IList implementation. Idem ArrayList

public Clear ( ) : void
return	void

Clone() public method

ICloneable implementation. Idem ArrayList

public Clone ( ) : object
return	object

Contains() public method

IList implementation. Search for a specified object in the list. If the list is sorted, a BinarySearch is performed using IComparer interface. Else the Object.Equals implementation is used.

public Contains ( object O ) : bool
O	object	The object to look for
return	bool

CopyTo() public method

IList.ICollection implementation. Idem ArrayList

public CopyTo ( Array array, int arrayIndex ) : void
array	System.Array
arrayIndex	int
return	void

Equals() public method

Object.Equals() override.

public Equals ( object Object ) : bool
Object	object
return	bool

GetEnumerator() public method

IList.IEnumerable implementation. Idem ArrayList

public GetEnumerator ( ) : IEnumerator
return	IEnumerator

GetHashCode() public method

Object.GetHashCode() override.

public GetHashCode ( ) : int
return	int

Heap() public method

Default constructor. Since no IComparer is provided here, added objects must implement the IComparer interface.

public Heap ( ) : System
return	System

Heap() public method

Constructor.

public Heap ( IComparer Comparer ) : System
Comparer	IComparer	Will be used to compare added elements for sort and search operations.
return	System

Heap() public method

Constructor.

public Heap ( IComparer Comparer, int Capacity ) : System
Comparer	IComparer	Will be used to compare added elements for sort and search operations.
Capacity	int	Capacity of the list (ArrayList.Capacity)
return	System

Heap() public method

Constructor. Since no IComparer is provided, added objects must implement the IComparer interface.

public Heap ( int Capacity ) : System
Capacity	int	Capacity of the list (ArrayList.Capacity)
return	System

IndexOf() public method

IList implementation. Returns the index of the specified object in the list. If the list is sorted, a BinarySearch is performed using IComparer interface. Else the Object.Equals implementation of objects is used.

public IndexOf ( object O ) : int
O	object	The object to locate.
return	int

IndexOf() public method

Idem IndexOf(object), but with a specified equality function

public IndexOf ( object Object, Equality AreEqual ) : int
Object	object	The object to locate.
AreEqual	Equality	Equality function to use for the search.
return	int

IndexOf() public method

Idem IndexOf(object), but starting at a specified position in the list

public IndexOf ( object Object, int Start ) : int
Object	object	The object to locate.
Start	int	The index for start position.
return	int

IndexOf() public method

Idem IndexOf(object), but with a start index and a specified equality function

public IndexOf ( object Object, int Start, Equality AreEqual ) : int
Object	object	The object to locate.
Start	int	The index for start position.
AreEqual	Equality	Equality function to use for the search.
return	int

IndexOfMax() public method

Returns the object of the list whose value is maximum

public IndexOfMax ( ) : int
return	int

IndexOfMin() public method

Returns the object of the list whose value is minimum

public IndexOfMin ( ) : int
return	int

Insert() public method

IList implementation. Cannot be used on a Heap.

Insert method cannot be called on a Heap.

public Insert ( int Index, object O ) : void
Index	int	The index before which the object must be added.
O	object	The object to add.
return	void

InsertRange() public method

Cannot be called on a Heap.

Insert cannot be called on a Heap.

public InsertRange ( int Index, ICollection C ) : void
Index	int	The index before which the objects must be added.
C	ICollection	The object to add.
return	void

LimitOccurrences() public method

Limits the number of occurrences of a specified value. Same values are equals according to the Equals() method of objects in the list. The first occurrences encountered are kept.

public LimitOccurrences ( object Value, int NumberToKeep ) : void
Value	object	Value whose occurrences number must be limited.
NumberToKeep	int	Number of occurrences to keep
return	void

Pop() public method

Returns the topmost object on the list and removes it from the list

public Pop ( ) : object
return	object

Push() public method

Pushes an object on list. It will be inserted at the right spot.

public Push ( object Object ) : int
Object	object	Object to add to the list
return	int

Remove() public method

IList implementation. Idem ArrayList

public Remove ( object Value ) : void
Value	object	The object whose value must be removed if found in the list.
return	void

RemoveAt() public method

IList implementation. Idem ArrayList

public RemoveAt ( int Index ) : void
Index	int	Index of object to remove.
return	void

RemoveDuplicates() public method

Removes all duplicates in the list. Each value encountered will have only one representant.

public RemoveDuplicates ( ) : void
return	void

ToString() public method

Object.ToString() override. Build a string to represent the list.

public ToString ( ) : string
return	string

getExisting() public method

public getExisting ( object O ) : object
O	object
return	object

this() public method

IList implementation. Gets object's value at a specified index. The set operation is impossible on a Heap.

Index is less than zero or Index is greater than Count. [] operator cannot be used to set a value on a Heap.

public this ( int Index ) : object
Index	int
return	object