CObList
|
└CObList
|
POSITION类型的变量为列表的键。使用POSITION变量，既可以作为列表循环中的循环变量，也可以作为标记某个位置的标签。不过，位置并不等同于索引。
在列表头、列表尾以及在指定的位置上，进行插入元素都非常便捷。一个顺序的搜索对于通过值或索引查找元素非常必要。如果这种列表很长，那么搜索速度将非常慢。
CObList引入了IMPLEMENT_SERIAL宏，从而支持其元素的串行化与转储。如果一系列的CObject指针被存储于档案文件中，那么使用加载插入操作符或使用Serialize成员函数，每个CObject元素都将被串行化。如果需要转储列表中个别CObject元素的转储，那么必须将转储内容的深度设置为1或更大。
当删除了对象或其元素，那么被删除的仅仅是CObject指针，而不是它们参考的对象。
可以从CObList派生自己的类。新的列表类，用于包含从CObject派生对象的指针，它将增添新的数据成员及新的成员函数。注意，结果列表并不是严格的类型安全，其原因在于它允许插入任何的CObject指针。
注意：
如果你希望串行化列表，那么在你自己的类的执行过程中必须使用IMPLEMENT_SERIAL宏。
如果要了解有关使用CObList的更多信息，请参阅联机文档“Visual C++程序员指南”中的“收集”。
下面列出了同CObList类的成员函数较为相似的类：
#include <afxcoll.h>
请参阅：CStringList,CPtrList
CObList类的成员
| 为CObject指针构造一个空的列表 |
首或尾访问
|
GetHead
|
返回列表中的首元素（列表不能为空） |
| GetTail | 返回列表中的尾元素（列表不能为空） |
操作
|
RemoveHead
|
从列表首删除元素 |
| RemoveTail | 从列表尾删除元素 |
| AddHead | 在列表首增加一个元素或另一个列表的所有元素（并产生一个新的列表首） |
| AddTail | 在列表尾增加一个元素或另一个列表的所有元素（并产生一个新的列表尾） |
| RemoveAll | 删除列表中所有的元素 |
循环
|
GetHeadPosition
|
返回列表中首元素的位置 |
| GetTailPosition | 返回列表中尾元素的位置 |
| GetNext | 获取循环遍历中的下一个元素 |
| GetPrev | 获取循环遍历中的前一个元素 |
检索/修改
| 获取指定位置的元素 | |
| SetAt | 设置指定位置的元素 |
| RemoveAt | 从列表中删除指定位置的元素 |
插入
|
InsertBefore
|
在给定位置之前新插入一个元素 |
| InsertAfter | 在给定位置之后新插入一个元素 |
搜索
| 获取由指针值指定元素的位置 | |
| FindIndex | 获取由以零尾基数索引指定元素的位置 |
状态
| 返回列表中的元素数 | |
| IsEmpty | 测试是否为空列表（没有元素） |