链表类CList成员的使用

2009-04-29

链表类CList成员的使用

使用时 要

#include <afxtempl.h>

Construction

CListConstructs an empty ordered list.

建立一个链表

example：

CList<int,int> myList;//建立一个int链表

CList<CString,CString&> myList(16);//建立一个cstring的链表，后面的16表示链表里面数据的个数，如果不写的话，可能是不限个数？

CList<MYTYPE,MYTYPE&> myList;//建立一个MYTYPE类型（自定义）的链表

如果不存入数据的话，刚建立的链表是空的，头尾都为空

Head/Tail Access

GetHeadReturns the head element of the list (cannot be empty).

返回链表的头数据

例子：

CList<int,int> myList;

for(int i=0;i<10000;i++) { myList.AddTail(int(i)); }//存入数据

int tmp=myList.GetHead();//tmp被赋予了0

GetTailReturns the tail element of the list (cannot be empty).

返回链表的尾数据

CList<int,int> myList;

for(int i=0;i<10000;i++) { myList.AddTail(int(i)); }//存入数据

int tmp=myList.GetTail();//tmp被赋予了9999

Operations

RemoveHeadRemoves the element from the head of the list.

移除链表头数据，链表数据个数减1，返回缩减前的头数据

例子：

CList<int,int> myList;

for(int i=0;i<10000;i++) { myList.AddTail(int(i)); }//存入数据

int tmp=myList.RemoveHead();//tmp被赋予了之前的头数据：0；同时数据个数变为9999；

RemoveTailRemoves the element from the tail of the list.

移除链表尾数据，链表数据个数减1，返回缩减前的尾数据

例子：

CList<int,int> myList;

for(int i=0;i<10000;i++) { myList.AddTail(int(i)); }//存入数据

int tmp=myList.RemoveTail();//tmp被赋予了之前的尾数据：9999；同时数据个数变为9999；

AddHeadAdds an element (or all the elements in another list) to the head of the list (makes a new head).

在链表头处插入新数据，链表数据个数加1，返回新的链表头位置（POSITION）;

例子：

CList<int,int> myList;

for(int i=0;i<10000;i++) { myList.AddTail(int(i)); }//存入数据

POSITION pos=myList.AddHead(int(314));//链表有了一个新的头数据：314；同时链表个数变为10001；pos为新的头的位置；

AddTailAdds an element (or all the elements in another list) to the tail of the list (makes a new tail).

在链表尾处插入新数据，链表数据个数加1，返回新的链表尾位置（POSITION）;

例子：

CList<int,int> myList;

for(int i=0;i<10000;i++) { myList.AddTail(int(i)); }//存入数据

POSITION pos=myList.AddTail(int(314));//链表有了一个新的尾数据：314；同时链表个数变为10001；pos为新的尾的位置；

RemoveAllRemoves all the elements from this list.

清空链表，其头尾皆变成空指针；

Iteration

GetHeadPositionReturns the position of the head element of the list.

返回链表头的位置；

CList<int,int> myList;

for(int i=0;i<10000;i++) { myList.AddTail(int(i)); }//存入数据

POSITION pos=myList.GetHeadPosition();//获得链表头的位置

GetTailPositionReturns the position of the tail element of the list.

返回链表尾的位置；

CList<int,int> myList;

for(int i=0;i<10000;i++) { myList.AddTail(int(i)); }//存入数据

POSITION pos=myList.GetTailPosition();//获得链表尾的位置

GetNextGets the next element for iterating.

返回当前位置的数据，之后，位置后移一位；

CList<int,int> myList;

for(int i=0;i<10000;i++) { myList.AddTail(int(i)); }//存入数据

POSITION pos=myList.GetHeadPosition();//获得链表头的位置

int tmp=myList.GetNext(pos);//tmp被赋予了头数据的值：0；同时pos指向第二个数据1；

GetPrevGets the previous element for iterating.

返回当前位置的数据，之后，位置前移一位；

CList<int,int> myList;

for(int i=0;i<10000;i++) { myList.AddTail(int(i)); }//存入数据

POSITION pos=myList.GetTailPosition();//获得链表尾的位置

int tmp=myList.GetNext(pos);//tmp被赋予了尾巴数据的值：9999；同时pos指向倒数第二个数据9998；

Retrieval/Modification

GetAtGets the element at a given position.

返回指定位置的数据；

CList<int,int> myList;

for(int i=0;i<10000;i++) { myList.AddTail(int(i)); }//存入数据

POSITION pos=myList.GetTailPosition();//获得链表尾的位置，还可以继续改变pos，以指向其他数据

int tmp=myList.GetAt(pos);//tmp被赋予链表尾的数据

SetAtSets the element at a given position.

CList<int,int> myList;

for(int i=0;i<10000;i++) { myList.AddTail(int(i)); }//存入数据

POSITION pos=myList.GetTailPosition();//获得链表尾的位置，还可以继续改变pos，以指向其他数据

myList.SetAt(pos,int(222));//将链表尾部的数据赋成222

RemoveAtRemoves an element from this list, specified by position.

清除指定位置处的数据；同时数据个数减1；

CList<int,int> myList;

for(int i=0;i<10000;i++) { myList.AddTail(int(i)); }//存入数据

POSITION pos=myList.GetTailPosition();//获得链表尾的位置

myList.RemoveAt(pos);//链表pos（尾部）位置的数据被清除，数据个数变为9999；

Insertion

InsertBeforeInserts a new element before a given position.

在指定位置前插入一个新数据，数据个数加1；

CList<int,int> myList;

for(int i=0;i<10000;i++) { myList.AddTail(int(i)); }//存入数据

POSITION pos=myList.GetHeadPosition();//获得第一个数据的位置

myList.InsertBefore(pos,int(123));//在第一个数据前插入一个新数据： 123，同时数据个数变为10001

InsertAfterInserts a new element after a given position.

在指定位置后插入一个新数据，数据个数加1；

CList<int,int> myList;

for(int i=0;i<10000;i++) { myList.AddTail(int(i)); }//存入数据

POSITION pos=myList.GetHeadPosition();//获得第一个数据的位置

myList.InsertAfter(pos,int(123));//在第一个数据后插入一个新数据： 123，同时数据个数变为10001

Searching

FindGets the position of an element specified by pointer value.

返回指定数据对应的位置；

CList<int,int> myList;

for(int i=0;i<10000;i++) { myList.AddTail(int(i)); }//存入数据

POSITION pos=myList.Find(int(0));//获得0（链表头）的位置

FindIndexGets the position of an element specified by a zero-based index.

返回索引号对应的位置；

POSITION pos=myList.FindIndex(0);//0表示链表头，以此类推

Status

GetCountReturns the number of elements in this list.

返回链表的数据个数

int num=myList.GetCount();//获得链表的数据个数

IsEmptyTests for the empty list condition (no elements).

判定链表是否为空；

返回1表示链表是空，返回0表示链表非空；

BOOL empty=myList.IsEmpty();