CObList

  

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