Class wwCollection

The base wwCollection class allows adding items as single items. The collection is purely accessed by a numeric indexer.

The collection internally manages an aItems array which can also be accessed directly for performance if necessary.


        foxpro
        
            
        
     

        foxpro
        
            
        
     
loCol = CREATEOBJECT("wwCollection")

loCol.Add("This is Item1")
loCol.Add("This is Item2")

? loCol.Count           && 2
? loCol.Item(1)         && This is Item1
? loCol.Item(2)         && This is Item2

? loCol.aItems[1]       && This is Item1
? loCol.aItems[2]       && This is Item2


? loCol.Item(4)         && .NULL.

loCol.Remove(2)
? loCol.Count           && 1

Custom

Class Members

Member		Description
	Add	Adds an item to the Collection. If `RequireUniqueItems=.T.` and a value exists already the original item is left without adding a new value, which is slightly slower. o.Add(Value)
	Clear	Clears all of the collection's items. o.Clear()
	Find	Finds an item by value. Note: Only finds the first match. o.Find(lvItem)
	FindIndex	o.FindIndex(lvItem)
	InsertAt	Inserts an item at the specified index position. Items are inserted before the item specified. If `RequireUniqueItems=.T.` and an item exists, the old item is shifted to the desired position. o.InsertAt(Position,Value)
	Item	Returns an item from the collection by in integer index value. If the item doesn't exist `null` is returned, or if `llThrowError=.T.` an error is generated. o.Item(Index, llThrowError)
	Remove	Removes an item from the collection by its index value. o.Remove(Index, llRemoveByValue)
	Set	Assigns a value to the collection by adding if it doesn't exist, or doing nothing if it already exists. Use this function primarily with `RequiresUniqueItems=.T.` collections. Behavior is identical… o.Set(lvValue)
	UpdateItem	Updates an item in the collection at a specific location. o.UpdateItem(lnIndex,lvValue)
	aItems[]	The internally maintained array of items added. This array is one dimensional and contains only the values added.
	Count	The count of items in this collection.
	RequireUniqueItems	When .T. insures that all items in the collections are unique when added.