Megjegyzés
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhat bejelentkezni vagy módosítani a címtárat.
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhatja módosítani a címtárat.
Megjegyzés:
A Microsoft Foundation Classes (MFC) könyvtár továbbra is támogatott. A továbbiakban azonban nem adunk hozzá funkciókat, és nem frissítjük a dokumentációt.
Támogatja a sorrendbe rendezett listákat a nem ismétlődő objektumokról, amelyek egymás után vagy érték szerint érhetők el.
Szemantika
template<class TYPE, class ARG_TYPE = const TYPE&>
class CList : public CObject
Tagok
Nyilvános konstruktorok
| Név | Description |
|---|---|
CList::CList |
Üres rendezett listát hoz létre. |
Nyilvános metódusok
| Név | Description |
|---|---|
CList::AddHead |
Hozzáad egy elemet (vagy egy másik lista összes elemét) a lista éléhez (új fejet hoz létre). |
CList::AddTail |
Hozzáad egy elemet (vagy egy másik lista összes elemét) a lista farkához (új farkát készít). |
CList::Find |
Lekéri a mutatóérték által megadott elem pozícióját. |
CList::FindIndex |
Lekéri egy nulla alapú index által megadott elem pozícióját. |
CList::GetAt |
Az elemet egy adott pozícióba helyezi. |
CList::GetCount |
A lista elemeinek számát adja vissza. |
CList::GetHead |
A lista fő elemét adja vissza (nem lehet üres). |
CList::GetHeadPosition |
A lista fő elemének pozícióját adja vissza. |
CList::GetNext |
Lekéri az iterálás következő elemét. |
CList::GetPrev |
Lekéri az előző elemet az iteráláshoz. |
CList::GetSize |
A lista elemeinek számát adja vissza. |
CList::GetTail |
A lista farokelemét adja vissza (nem lehet üres). |
CList::GetTailPosition |
A lista farokelemének pozícióját adja vissza. |
CList::InsertAfter |
Új elemet szúr be egy adott pozíció után. |
CList::InsertBefore |
Új elemet szúr be egy adott pozíció elé. |
CList::IsEmpty |
Az üres listafeltétel (elemek nélkül) tesztelése. |
CList::RemoveAll |
Eltávolítja a listából az összes elemet. |
CList::RemoveAt |
Eltávolít egy elemet a listából, amelyet a pozíció határoz meg. |
CList::RemoveHead |
Eltávolítja az elemet a lista éléről. |
CList::RemoveTail |
Eltávolítja az elemet a lista farkából. |
CList::SetAt |
Az elemet egy adott pozícióba állítja. |
Paraméterek
TYPE
A listában tárolt objektum típusa.
ARG_TYPE
A listában tárolt objektumokra való hivatkozáshoz használt típus. Lehet hivatkozás.
Megjegyzések
CList a listák a duplázott listákhoz hasonlóan működnek.
A típusváltozó POSITION a lista kulcsa. A változót iterátorként használhatja POSITION a listák egymás utáni, könyvjelzőként való bejárásához, hogy helyet tartson. A pozíció azonban nem ugyanaz, mint az index.
Az elem beszúrása nagyon gyors a listafejnél, a faroknál és egy ismertnél POSITION. Egy elem érték vagy index szerinti kereséséhez szekvenciális keresésre van szükség. Ez a keresés lassú lehet, ha a lista hosszú.
Ha a lista egyes elemeiből álló memóriaképre van szüksége, a memóriakép-környezet mélységét 1 vagy nagyobbra kell állítania.
Az osztály egyes tagfüggvényei globális segédfüggvényeket hívnak meg, amelyeket az CList osztály legtöbb használata esetén testre kell szabni. Tekintse meg a Gyűjteményosztály segítőit a "Makrók és globálisak" szakaszban.
A használatról CListtovábbi információt a Gyűjtemények című cikkben talál.
Example
// CList is a template class that takes two template arguments.
// The first argument is type stored internally by the list, the
// second argument is the type used in the arguments for the
// CList methods.
// This code defines a list of ints.
CList<int, int> myIntList;
// This code defines a list of CStrings
CList<CString, CString &> myStringList;
// This code defines a list of MYTYPEs,
// NOTE: MYTYPE could be any struct, class or type definition
CList<MYTYPE, MYTYPE &> myTypeList;
Öröklési hierarchia
CList
Requirements
Fejléc:afxtempl.h
CList::AddHead
Új elemet vagy elemlistát ad hozzá a lista éléhez.
POSITION AddHead(ARG_TYPE newElement);
void AddHead(CList* pNewList);
Paraméterek
ARG_TYPE
A listaelem típusát meghatározó sablonparaméter (hivatkozás lehet).
newElement
Az új elem.
pNewList
Egy másik CList listára mutató mutató. A program hozzáadja a benne lévő pNewList elemeket ehhez a listához.
Visszaadott érték
Az első verzió az POSITION újonnan beszúrt elem értékét adja vissza.
Megjegyzések
A lista a művelet előtt üres lehet.
Example
// Declarations of the variables used in the example
CList<CString, CString &> myList;
CList<CString, CString &> myList2;
// There are two versions of CList::AddHead: one adds a single
// element to the front of the list, the second adds another list
// to the front.
// This adds the string "ABC" to the front of myList.
// myList is a list of CStrings (ie defined as CList<CString,CString&>).
myList.AddHead(CString(_T("ABC")));
// This adds the elements of myList2 to the front of myList.
myList.AddHead(&myList2);
CList::AddTail
Új elemet vagy elemlistát ad hozzá a lista széléhez.
POSITION AddTail(ARG_TYPE newElement);
void AddTail(CList* pNewList);
Paraméterek
ARG_TYPE
A listaelem típusát meghatározó sablonparaméter (hivatkozás lehet).
newElement
A listához hozzáadni kívánt elem.
pNewList
Egy másik CList listára mutató mutató. A program hozzáadja a benne lévő pNewList elemeket ehhez a listához.
Visszaadott érték
Az első verzió az POSITION újonnan beszúrt elem értékét adja vissza.
Megjegyzések
A lista a művelet előtt üres lehet.
Example
// Define myList and myList2.
CList<CString, CString &> myList;
CList<CString, CString &> myList2;
// Add elements to the end of myList and myList2.
myList.AddTail(CString(_T("A")));
myList.AddTail(CString(_T("B")));
myList2.AddTail(CString(_T("C")));
myList2.AddTail(CString(_T("D")));
// There are two versions of CList::AddTail: one adds a single
// element to the end of the list, the second adds another list
// to the end.
// This adds the string "ABC" to the end of myList.
// myList is a list of CStrings (ie defined as CList<CString,CString&>).
myList.AddTail(CString(_T("ABC")));
ASSERT(CString(_T("ABC")) == myList.GetTail());
// This adds the elements of myList2 to the end of myList.
myList.AddTail(&myList2);
CList::CList
Üres rendezett listát hoz létre.
CList(INT_PTR nBlockSize = 10);
Paraméterek
nBlockSize
A lista kiterjesztésének memóriafoglalási részletessége.
Megjegyzések
A lista növekedésével a rendszer a memóriát bejegyzésegységekben nBlockSize foglalja le.
Example
// This code defines myList as a list of strings
// such that memory gets allocated in chunks of
// 16 strings.
CList<CString, CString &> myList(16);
// This code defines myList2 as a list of ints
// such that memory gets allocated in chunks of
// 128 ints.
CList<int, int> myList2(128);
CList::Find
A lista egymást követő keresésével megkeresi a megadott searchValueelemnek megfelelő első elemet.
POSITION Find(
ARG_TYPE searchValue,
POSITION startAfter = NULL) const;
Paraméterek
ARG_TYPE
A listaelem típusát meghatározó sablonparaméter (hivatkozás lehet).
searchValue
A listában található érték.
startAfter
A keresés kezdőpozíciója. Ha nincs megadva érték, a keresés a fejelemmel kezdődik.
Visszaadott érték
Iterációhoz POSITION vagy objektummutató lekéréséhez használható érték, NULL ha az objektum nem található.
Example
// Define myList.
CList<CString, CString &> myList;
// Add three elements to the list.
myList.AddHead(CString(_T("XYZ")));
myList.AddHead(CString(_T("ABC")));
myList.AddHead(CString(_T("123")));
// Find a specific element.
POSITION pos = myList.Find(CString(_T("XYZ")));
ASSERT(CString(_T("XYZ")) == myList.GetAt(pos));
CList::FindIndex
A lista indexeként használja az értéket nIndex .
POSITION FindIndex(INT_PTR nIndex) const;
Paraméterek
nIndex
A keresendő listaelem nulla alapú indexe.
Visszaadott érték
Iterációhoz POSITION vagy objektummutató lekéréséhez használható érték, NULL ha nIndex negatív vagy túl nagy.
Megjegyzések
Elindít egy szekvenciális vizsgálatot a lista éléről, és megáll az nth elemen.
Example
// Define myList.
CList<CString, CString &> myList;
// Add three elements to the list.
myList.AddTail(CString(_T("XYZ")));
myList.AddTail(CString(_T("ABC")));
myList.AddTail(CString(_T("123")));
// Verify the first element (index 0).
ASSERT(CString(_T("XYZ")) == myList.GetAt(myList.FindIndex(0)));
// Verify the third element (index 2).
ASSERT(CString(_T("123")) == myList.GetAt(myList.FindIndex(2)));
CList::GetAt
Lekéri a listaelemet egy adott helyre.
TYPE& GetAt(POSITION position);
const TYPE& GetAt(POSITION position) const;
Paraméterek
TYPE
A listában szereplő objektumtípust meghatározó sablonparaméter.
position
A lekérni kívánt elem listájának pozíciója.
Visszaadott érték
Lásd a visszatérési érték leírását GetHead.
Megjegyzések
GetAt egy adott pozícióhoz társított elemet (vagy az elemre mutató hivatkozást) ad vissza. Ez nem ugyanaz, mint egy index, és nem használhatja saját maga az POSITION értéket. A típusváltozó POSITION a lista kulcsa.
Győződjön meg arról, hogy az POSITION érték érvényes pozíciót jelöl a listában. Ha érvénytelen, akkor a Microsoft Foundation osztálytár hibakeresési verziója érvényes.
Example
Lásd a példát a CList::GetHeadPosition.
CList::GetCount
Lekéri a lista elemeinek számát.
INT_PTR GetCount() const;
Visszaadott érték
Az elemszámot tartalmazó egész szám.
Megjegyzések
A metódus meghívása ugyanazt az eredményt eredményezi, mint a CList::GetSize metódus.
Example
Lásd a példát a CList::RemoveHead.
CList::GetHead
Lekéri a lista fejelemét (vagy a fejelemre mutató hivatkozást).
const TYPE& GetHead() const;
TYPE& GetHead();
Paraméterek
TYPE
A listában szereplő objektumtípust meghatározó sablonparaméter.
Visszaadott érték
Ha a lista igen const, GetHead a lista élén lévő elem másolatát adja vissza. Így a függvény csak a hozzárendelési utasítás jobb oldalán használható, és védi a listát a módosítástól.
Ha a lista nem const, GetHead a lista elején lévő elemre mutató hivatkozást ad vissza. Ez lehetővé teszi a függvény használatát a hozzárendelési utasítás mindkét oldalán, így lehetővé teszi a listabejegyzések módosítását.
Megjegyzések
A hívás GetHeadelőtt győződjön meg arról, hogy a lista nem üres. Ha a lista üres, akkor a Microsoft Foundation osztálytár hibakeresési verziója érvényes. Annak ellenőrzésére használható IsEmpty , hogy a lista tartalmaz-e elemeket.
Example
// Define myList.
CList<CString, CString &> myList;
// Add an element to the front of the list.
myList.AddHead(CString(_T("ABC")));
// Verify the element was added to the front of the list.
ASSERT(CString(_T("ABC")) == myList.GetHead());
CList::GetHeadPosition
Lekéri a lista fő elemének pozícióját.
POSITION GetHeadPosition() const;
Visszaadott érték
Iterációhoz POSITION vagy objektummutató lekéréséhez használható érték, NULL ha a lista üres.
Example
// Define myList.
CList<CString, CString &> myList;
// Add an element to the front of the list.
myList.AddHead(CString(_T("ABC")));
// Verify the element at the head position
// is the one added.
POSITION pos = myList.GetHeadPosition();
ASSERT(CString(_T("ABC")) == myList.GetAt(pos));
CList::GetNext
Lekéri az általa rPositionazonosított listaelemet, majd a POSITION lista következő bejegyzésének értékére állítja rPosition be.
TYPE& GetNext(POSITION& rPosition);
const TYPE& GetNext(POSITION& rPosition) const;
Paraméterek
TYPE
A lista elemeinek típusát meghatározó sablonparaméter.
rPosition
Hivatkozás egy POSITION előző GetNext, GetHeadPositionvagy más tagfüggvény-hívás által visszaadott értékre.
Visszaadott érték
Ha a lista igen const, GetNext a lista egy elemének másolatát adja vissza. Így a függvény csak a hozzárendelési utasítás jobb oldalán használható, és védi a listát a módosítástól.
Ha a lista nem const, GetNext a lista egy elemére mutató hivatkozást ad vissza. Ez lehetővé teszi a függvény használatát a hozzárendelési utasítás mindkét oldalán, így lehetővé teszi a listabejegyzések módosítását.
Megjegyzések
A továbbítási iterációs ciklusban akkor használható GetNext , ha a kezdeti pozíciót egy vagy több hívással GetHeadPositionFindhozza létre.
Győződjön meg arról, hogy az POSITION érték érvényes pozíciót jelöl a listában. Ha érvénytelen, akkor a Microsoft Foundation osztálytár hibakeresési verziója érvényes.
Ha a lekért elem az utolsó a listában, akkor az új érték rPosition NULL értékre van állítva.
Example
// Define myList.
// Define myList.
CList<CString, CString &> myList;
// Add two elements to the list.
myList.AddHead(CString(_T("ABC")));
myList.AddHead(CString(_T("123")));
// Dump the list elements to the debug window.
POSITION pos = myList.GetHeadPosition();
for (int i = 0; i < myList.GetCount(); i++)
{
TRACE(_T("%s\r\n"), (LPCTSTR)myList.GetNext(pos));
}
CList::GetPrev
Lekéri az általa rPositionazonosított listaelemet, majd a POSITION lista előző bejegyzésének értékére állítja rPosition be.
TYPE& GetPrev(POSITION& rPosition);
const TYPE& GetPrev(POSITION& rPosition) const;
Paraméterek
TYPE
A lista elemeinek típusát meghatározó sablonparaméter.
rPosition
Hivatkozás egy POSITION korábbi GetPrev vagy más tagfüggvény-hívás által visszaadott értékre.
Visszaadott érték
Ha a lista igen const, GetPrev a lista élén lévő elem másolatát adja vissza. Így a függvény csak a hozzárendelési utasítás jobb oldalán használható, és védi a listát a módosítástól.
Ha a lista nem const, GetPrev a lista egy elemére mutató hivatkozást ad vissza. Ez lehetővé teszi a függvény használatát a hozzárendelési utasítás mindkét oldalán, így lehetővé teszi a listabejegyzések módosítását.
Megjegyzések
Fordított iterációs ciklusban akkor használható GetPrev , ha a kezdeti pozíciót egy vagy több hívással GetTailPositionFindhozza létre.
Győződjön meg arról, hogy az POSITION érték érvényes pozíciót jelöl a listában. Ha érvénytelen, akkor a Microsoft Foundation osztálytár hibakeresési verziója érvényes.
Ha a lekért elem az első a listában, akkor az új érték rPosition a következőre NULLvan állítva: .
Example
// Define myList.
CList<CString,CString&> myList;
// Add two elements to the list.
myList.AddHead(CString(_T("ABC")));
myList.AddHead(CString(_T("123")));
// Dump the list elements to the debug window,
// in reverse order.
POSITION pos = myList.GetTailPosition();
for (int i = 0; i < myList.GetCount(); i++)
{
TRACE(_T("%s\r\n"), (LPCTSTR)myList.GetPrev(pos));
}
CList::GetSize
A listaelemek számát adja vissza.
INT_PTR GetSize() const;
Visszaadott érték
A lista elemeinek száma.
Megjegyzések
Hívja meg ezt a metódust a lista elemeinek számának lekéréséhez. A metódus meghívása ugyanazt az eredményt eredményezi, mint a CList::GetCount metódus.
Example
// Define myList.
CList<CString, CString &> myList;
// Add two elements to the list.
myList.AddHead(CString(_T("ABC")));
myList.AddHead(CString(_T("123")));
// Remove the head element and verify the list.
// NOTE: once the head is removed, the number of
// elements in the list will be one.
CString strHead = myList.RemoveHead();
ASSERT((CString(_T("123")) == strHead) && (myList.GetSize() == 1) &&
(CString(_T("ABC")) == myList.GetHead()));
CList::GetTail
Lekéri a CObject lista farokelemét ábrázoló mutatót.
TYPE& GetTail();
const TYPE& GetTail() const;
Paraméterek
TYPE
A lista elemeinek típusát meghatározó sablonparaméter.
Visszaadott érték
Lásd a visszatérési érték leírását GetHead.
Megjegyzések
A hívás GetTailelőtt győződjön meg arról, hogy a lista nem üres. Ha a lista üres, akkor a Microsoft Foundation osztálytár hibakeresési verziója érvényes. Annak ellenőrzésére használható IsEmpty , hogy a lista tartalmaz-e elemeket.
Example
// Define myList.
CList<CString, CString &> myList;
// Add an element to the end of the list.
myList.AddTail(CString(_T("ABC")));
// Verify the element was added to the end of the list.
ASSERT(CString(_T("ABC")) == myList.GetTail());
CList::GetTailPosition
Lekéri a lista farokelemének pozícióját; NULL ha a lista üres.
POSITION GetTailPosition() const;
Visszaadott érték
Iterációhoz POSITION vagy objektummutató lekéréséhez használható érték, NULL ha a lista üres.
Example
// Define myList.
CList<CString,CString&> myList;
// Add an element to the end of the list.
myList.AddTail(CString(_T("ABC")));
// Verify the element at the end position
// is the one added.
POSITION pos = myList.GetTailPosition();
ASSERT(CString(_T("ABC")) == myList.GetAt(pos));
CList::InsertAfter
Hozzáad egy elemet a listához a megadott pozícióban lévő elem után.
POSITION InsertAfter(POSITION position, ARG_TYPE newElement);
Paraméterek
position
Egy korábbi GetNext, GetPrevvagy Find tagfüggvény-hívás által visszaadott POZÍCIÓ érték.
ARG_TYPE
A listaelem típusát meghatározó sablonparaméter.
newElement
A listához hozzáadni kívánt elem.
Visszaadott érték
Iterációhoz POSITION vagy listaelem-lekéréshez használható érték.
Example
// Define myList.
CList<CString, CString &> myList;
// Add three elements to the list.
POSITION pos = myList.AddHead(CString(_T("XYZ")));
pos = myList.InsertAfter(pos, CString(_T("ABC")));
pos = myList.InsertAfter(pos, CString(_T("123")));
// Verify the tail element is what's expected.
ASSERT(CString(_T("123")) == myList.GetTail());
CList::InsertBefore
Hozzáad egy elemet a listához a megadott pozícióban lévő elem előtt.
POSITION InsertBefore(POSITION position, ARG_TYPE newElement);
Paraméterek
position
Egy POSITION korábbi GetNext, GetPrevvagy Find tagfüggvény-hívás által visszaadott érték.
ARG_TYPE
A listaelem típusát meghatározó sablonparaméter (hivatkozás lehet).
newElement
A listához hozzáadni kívánt elem.
Visszaadott érték
Iterációhoz POSITION vagy listaelem-lekéréshez használható érték.
Megjegyzések
Ha position igen NULL, az elem a lista élére kerül.
Example
// Define myList.
CList<CString, CString &> myList;
// Add three elements to the list.
POSITION pos = myList.AddHead(CString(_T("XYZ")));
pos = myList.InsertBefore(pos, CString(_T("ABC")));
pos = myList.InsertBefore(pos, CString(_T("123")));
// Verify the head element is what's expected.
ASSERT(CString(_T("123")) == myList.GetHead());
CList::IsEmpty
Azt jelzi, hogy a lista nem tartalmaz-e elemeket.
BOOL IsEmpty() const;
Visszaadott érték
Nonzero, ha ez a lista üres; egyéb esetben 0.
Example
// Define myList.
CList<CString, CString &> myList;
// Add three elements to the list.
myList.AddTail(CString(_T("XYZ")));
myList.AddTail(CString(_T("ABC")));
myList.AddTail(CString(_T("123")));
// Remove the head element until the list is empty.
CString str;
while (!myList.IsEmpty())
{
str = myList.RemoveHead();
TRACE(_T("%s\r\n"), (LPCTSTR)str);
}
CList::RemoveAll
Eltávolítja a listából az összes elemet, és felszabadítja a társított memóriát.
void RemoveAll();
Megjegyzések
Nem jön létre hiba, ha a lista már üres.
Example
// Define myList.
CList<CString, CString&> myList;
// Add three elements to the list.
myList.AddTail(CString(_T("XYZ")));
myList.AddTail(CString(_T("ABC")));
myList.AddTail(CString(_T("123")));
// Remove all of the elements in the list.
myList.RemoveAll();
// Verify the list is empty.
ASSERT(myList.IsEmpty());
CList::RemoveAt
Eltávolítja a megadott elemet a listából.
void RemoveAt(POSITION position);
Paraméterek
position
A listából eltávolítandó elem helye.
Megjegyzések
Győződjön meg arról, hogy az POSITION érték érvényes pozíciót jelöl a listában. Ha érvénytelen, akkor a Microsoft Foundation osztálytár hibakeresési verziója érvényes.
Example
// Define myList.
CList<CString, CString&> myList;
// Add three elements to the list.
myList.AddTail(CString(_T("XYZ")));
myList.AddTail(CString(_T("ABC")));
myList.AddTail(CString(_T("123")));
// Remove CString("ABC") from the list.
myList.RemoveAt(myList.FindIndex(1));
// Verify CString("ABC") is not in the list.
ASSERT(myList.Find(CString(_T("ABC"))) == NULL);
CList::RemoveHead
Eltávolítja az elemet a lista éléről, és egy mutatót ad vissza.
TYPE RemoveHead();
Paraméterek
TYPE
A lista elemeinek típusát meghatározó sablonparaméter.
Visszaadott érték
Az elem, amely korábban a lista élén volt.
Megjegyzések
A hívás RemoveHeadelőtt győződjön meg arról, hogy a lista nem üres. Ha a lista üres, akkor a Microsoft Foundation osztálytár hibakeresési verziója érvényes. Annak ellenőrzésére használható IsEmpty , hogy a lista tartalmaz-e elemeket.
Example
// Define myList.
CList<CString, CString&> myList;
// Add two elements to the list.
myList.AddHead(CString(_T("ABC")));
myList.AddHead(CString(_T("123")));
// Remove the head element and verify the list.
// NOTE: once the head is removed, the number of
// elements in the list will be one.
CString strHead = myList.RemoveHead();
ASSERT((CString(_T("123")) == strHead) && (myList.GetCount() == 1) &&
(CString(_T("ABC")) == myList.GetHead()));
CList::RemoveTail
Eltávolítja az elemet a lista farkából, és egy mutatót ad vissza.
TYPE RemoveTail();
Paraméterek
TYPE
A lista elemeinek típusát meghatározó sablonparaméter.
Visszaadott érték
A lista végén lévő elem.
Megjegyzések
A hívás RemoveTailelőtt győződjön meg arról, hogy a lista nem üres. Ha a lista üres, akkor a Microsoft Foundation osztálytár hibakeresési verziója érvényes. Annak ellenőrzésére használható IsEmpty , hogy a lista tartalmaz-e elemeket.
Example
// Define myList.
CList<CString, CString &> myList;
// Add two elements to the list.
myList.AddTail(CString(_T("ABC")));
myList.AddTail(CString(_T("123")));
// Remove the tail element and verify the list.
// NOTE: once the tail is removed, the number of
// elements in the list will be one.
CString strTail = myList.RemoveTail();
ASSERT((CString(_T("123")) == strTail) && (myList.GetCount() == 1) &&
(CString(_T("ABC")) == myList.GetTail()));
CList::SetAt
A típusváltozó POSITION a lista kulcsa.
void SetAt(POSITION pos, ARG_TYPE newElement);
Paraméterek
pos
A POSITION beállítani kívánt elem.
ARG_TYPE
A listaelem típusát meghatározó sablonparaméter (hivatkozás lehet).
newElement
A listához hozzáadni kívánt elem.
Megjegyzések
Ez nem ugyanaz, mint egy index, és nem használhatja saját maga az POSITION értéket.
SetAt az elemet a lista megadott helyére írja.
Győződjön meg arról, hogy az POSITION érték érvényes pozíciót jelöl a listában. Ha érvénytelen, akkor a Microsoft Foundation osztálytár hibakeresési verziója érvényes.
Example
// Define myList.
CList<CString, CString &> myList;
// Add three elements to the list.
myList.AddTail(CString(_T("XYZ")));
myList.AddTail(CString(_T("ABC")));
myList.AddTail(CString(_T("123")));
// Replace CString("ABC") with CString("CBA")
POSITION pos = myList.Find(CString(_T("ABC")));
myList.SetAt(pos, CString(_T("CBA")));
// Verify CString("ABC") is not in the list.
ASSERT(myList.Find(CString(_T("ABC"))) == NULL);
Lásd még
MFC-minta COLLECT
CObject osztály
hierarchiadiagram
CMap osztály
CArray osztály