TList

【 tulaoshi.com - 编程语言 】

　　TList包含对象指针列表。

　　类关系 TObject

　　Tlist用于存储和维护对象列表。TList引入属隆和方法以执行以下操作：

　　(1)在列表中增加或删除对象。

　　(2)在列表中重排对象。

　　(3)在列表中定位和获得对象。

　　(4)在列表中对对象进行排序。

　　属性列表

　　Capacity 标识TList对象维护的指针数组的大小。

　　Count 表明在列表中使用的项的数量。

　　Items 列出对象的引用。

　　List 标识组成Items的指针数组。

　　方法列表

　　~TList 删除与TList对象有关的内存。

　　Add 在列表的末尾插入有关的内存。

　　Clear 从列表中删除所有项。

　　Delete 删除Index参数标识的项。

　　Error 产生EListError异常。

　　Exchange 交换Items数组中两项的位置。

　　Expand 增加列表的Capacity。

　　First 返回Items[0]。

　　IndexOf 返回Items数组中一指针的索引。

　　Insert 增加一对象至Items数组中。

　　Last 返回Items[Count-1]。

　　Move 在Items数组中改变某一项的位置。

　　Pack 从Items数组中删除所有的零项。

　　Remove 从Items数组中删除Items参数的第一个引用。

　　Sort 在列表中执行QuickSort。

　　TList 创建一个新的TList对象。

　　详细说明

　　属性

　　TList::Capacity

　　__property int Capacity = {read=FCapacity,write=SetCapacity,nodefault};

　　标识TList对象维护的指针数组的大小。

　　设置Capacity为列表将要包含的指旬数。当当设置Capacity属性时，如果没有足够的内存扩展列表为它的新的大小，将产生EOutOfMemory异常。

　　在没有重新分配内存情况下，读取Capacity可得到列表能包含的对象数。注意不要混淆Capacity和Count属性；Count属性为列表中使用的项的数量。Capacity值总是大于或等于Count值。当Capacity大于Count，通过设定Capacity至Count可以回收未使用的内存。当添加一对象至列表，而此列表已被填充到Capacity时，Capacity属性自动增加。在增加对象之前设置Capacity能减少内存重分配的数量，因此提高了执行效果。例如：

　　List-Clear();

　　List-Capacity = Count;

　　for(int i=0;iCount;i++) List-add(...);

　　在for循环之前分配Capacity保证在随后的每一Add操作不重新分配列表。在调用Add时避免重新分配可以提高执行效果并且保证Add操作不产生异常。

　　TList:;Count

　　__property int Count = {read=FCount,write=SetCount,nodefault};

　　表明在列表中使用的项的数量。

　　读取Count可以确定Items数组中项的数量。增加Count的大小将在Items数组的末尾增加必要的零指针的数量；减小Count的大小将从Items数组的末尾删除必要的零指针的数量。

　　注意：Count并不总等同于列表中引用的对象的数量。在Items数组中，某些项将包含零指针。如果要删除零指针并且设置Count为对象引用的项数，则可以调用Pack方法。

　　TList::Items

　　__property void* Items[int Index] = {read=Get,write=Put};

　　列出对象的引用。

　　使用Items可以获得数组中指定对象的指针。Index参数标识对象的索引；第一个对象的索引值为0，第二个对象的索引值为1,以此类推。设置Items可以在指定位置改变引用。使用带有Count属性的Items可以遍历列表中的所有对象。

　　应该注意的是，并不是Items数组中所有的项都需包含对象的索引。有些项可能是零指针。如果要删除零掼针并且减小Items数组的大小至对象的数量，可以调用Pack方法。

　　TList::List

　　typedef void* TPointerLIst[134217727];

　　typedef TPointerLIst* PPointerList;

　　__property PPointerList List = {read=FList};

　　标识组成Items的指针数组。

　　使用List直接获得Items数组。

　　TList::~TList

　　__fastcall virtual~TList(void);

　　删除与TList对象有关的内存。

　　在应用中不要直接调用~TList。用delete替代。

　　~TList释放存储项列表的内存。注意，~TList并不释放指向列表元素的内存。

　　TList::Add

　　int __fastcall Ad(void* Item);

　　在列表的末尾插入新项，可以调用Add方法。Add方法返回值为新项的索引值；列表中第一项的索引值为0

　　如果Items数组使用完列表对象Capacity，则Add方法分配更多的内存。Add增加Count值以反映新指针的增加。注意：即使Items数组包含零指针，Add方法总是在Items数组的末尾插入Items指针。

　　TList::Clear

　　DYNAMIC void __fastcall Clear(void);

　　从列表中删除所有项。

　　如果要清空Items数组并且设置Count为0，可以调用Clear方法。Clear方法同时释放用于存储Items数组的内存并且设置Capacity为0。

　　TList::Delete

　　void __fastcall Delete(int Index);

　　删除Index参数标识的项。

　　如果要从列表指定位置删除项，可以调用Delete方法。索引从零开始，因此第一项的索引值为0,第二项的索引值为1，以此类推。调用Delete方法向前移动删除项之后的所有英并减小Count。

　　如果要删除一项的索引但并不从列表中删除该项并且改变Count，可设置Index的Items属性为零。注意Delete并不释放的项相关的内存。如果要释放存储删除项的内存，可设置Capacity属性。

　　TList::Error

　　virtual void __fastcall Error(const System::AnsiString Msg,int Data)　 {Error(__classid(TList),Msg,Data};

　　产生EListError异常。

　　当TList对象出现错误时，调用Error产生异常。Error组合Msg参数标识的错误消息和Data参数标识的数据植，然后产生EListError异常。调用Error而不是增加一行程序代码，例如：

　　throw EListError(MyMsg,iBadValue);

　　为减少应用程序的代码量。

　　TList::Exchange

　　void __fastcall Exchange(int Index1,int Index2);

　　交换Items数组中两项的位置。

　　如果要交换台Items数组中位于Index1和Index2的项的位置，可以调用Exchange方法。索引从零开始，因此，列表中第一项的索引值为0，第二项的索引值为1，以此类推。

　　TList::Expand

　　TList* __fastcall Expand(void);

　　增加列表的Capacity。

　　为了在列表增加新项，可以调用Expand以创建更多的空间。如果没有填充列表至Capacity，Expand一作任何处理。如果Count = Capacity，Expand按如下增加列表的Capacity。如果Capacity值大于8，Expand增加列表的Capacity至16；如果Capacity值大于4，但是小于8，列表的Capacity增加至8，如果Capacity值小于4，列表的Capacity 增加4。

　　返回值为扩展的列表对象。

　　TList::First

　　void* __fastcall First(void);

　　返回Items[0]。

　　调用First获得Items数组中的第一个指针。

　　TList::IndexOf

　　int __fastcall IndexOf(void* Item);

　　TList::Inset

　　void __fastcall Insert(int Index,void* Item);

　　返回Items数组中一指针的索引。

　　调用IndexOf获得Items数组中一指针的索引。Item参数标识指针。数组中第一项索引值为0，第二项的索引值为1，以此类推。如果项不在列表中，IndexOf返回-1。如果一指针在列表中出现多次，IndexOf返回第一次出现的索引值。

　　TList::Last

　　void* __fastcall(void);

　　增加一对象至Items数组中；Index参数标识该对象的添加位置。

　　如果要添加Item至Items数组中，可以调用Insert方法。Index参数为基于0的索引，因此，数组中的第一个位置的索引值为0。Insert在指定位置增加项；改变原先处于此位置的项以及后面的所有项。如果必要，Insert扩充列表的Capacity并且设置Items属性。

　　TList::Move

　　void __fastcall Move(int CurIndex,int NewIndex);

　　返回Items[Count-1]。

　　如果要在Items数组中得到最后的指针，可以调用Last方法。

　　TList::Pack

　　void __fastcall Pack(void);

　　从Items数组中删除所有的零项。

　　调用Pack将所有非零项移至Items数组的前面并且减小Count属性为实际使用的项的数量。Pack并不释放存储零指针的内存。为了释放通过Pack方法删除的不使用项所占用的内存，可以设置Capacity属性为Count的新值。

　　TList::Remove

　　int __fastcall Remove(void* Item);

　　从Items数组中删除Item参数的第一个引用。

　　当不知道指定项的索引时，调用Remove从Items数组中删除指定项。在删除指定项之前，返回该项的索引。在指定项删除之后，该项之后的所有项的索引位置提前并且Count减一。应该注意的是，如果Items数组包含指针的多个复制，仅第一个复制被删除。

　　TList::Sort

　　typedef int __fastcall (*TListSortCompare)(void* Item1,void* Item2);

　　void __fastcall Sort(TListSortCompare Compare);

　　根据Compare函数的比较，在列表中执行QuickSort。

　　如果要对Items数组中草药的项进行排序，可以调用Sort方法。Compare为比较函数，该函数表明项是如何进行排序的。如果Item1小于Item2，则Compare返回值为0；如果Item1大于Item2，则Compare返回值大于0；

　　TList::TList

　　__fastcall virtual TList(void);

　　创建一个新的TList对象。

　　不要直接调用TList。用new替代。