`CList` Sınıf

Makale
07/05/2024

Sıralı olarak veya değere göre erişilebilen sıralı olmayan nesne listelerini destekler.

Sözdizimi

template<class TYPE, class ARG_TYPE = const TYPE&>
class CList : public CObject

Üyeler

Ortak Oluşturucular

Veri Akışı Adı	Açıklama
`CList::CList`	Boş bir sıralı liste oluşturur.

Genel Yöntemler

Veri Akışı Adı	Açıklama
`CList::AddHead`	Listenin başına bir öğe (veya başka bir listedeki tüm öğeler) ekler (yeni bir kafa oluşturur).
`CList::AddTail`	Listenin kuyruğuna bir öğe (veya başka bir listedeki tüm öğeler) ekler (yeni bir kuyruk oluşturur).
`CList::Find`	İşaretçi değeri tarafından belirtilen öğenin konumunu alır.
`CList::FindIndex`	Sıfır tabanlı dizin tarafından belirtilen bir öğenin konumunu alır.
`CList::GetAt`	Öğeyi belirli bir konumda alır.
`CList::GetCount`	Bu listedeki öğelerin sayısını döndürür.
`CList::GetHead`	Listenin baş öğesini döndürür (boş olamaz).
`CList::GetHeadPosition`	Listenin baş öğesinin konumunu döndürür.
`CList::GetNext`	Yineleme için sonraki öğeyi alır.
`CList::GetPrev`	Yineleme için önceki öğeyi alır.
`CList::GetSize`	Bu listedeki öğelerin sayısını döndürür.
`CList::GetTail`	Listenin kuyruk öğesini döndürür (boş olamaz).
`CList::GetTailPosition`	Listenin kuyruk öğesinin konumunu döndürür.
`CList::InsertAfter`	Belirli bir konumdan sonra yeni bir öğe ekler.
`CList::InsertBefore`	Belirli bir konumdan önce yeni bir öğe ekler.
`CList::IsEmpty`	Boş liste koşulu için test (öğe yok).
`CList::RemoveAll`	Bu listeden tüm öğeleri kaldırır.
`CList::RemoveAt`	Bu listeden konuma göre belirtilen bir öğeyi kaldırır.
`CList::RemoveHead`	öğesini listenin başından kaldırır.
`CList::RemoveTail`	öğesini listenin kuyruğundan kaldırır.
`CList::SetAt`	Öğesini belirli bir konumda ayarlar.

Parametreler

TYPE
Listede depolanan nesnenin türü.

ARG_TYPE
Listede depolanan nesnelere başvurmak için kullanılan tür. Başvuru olabilir.

Açıklamalar

CList listeler, ikiye kat bağlantılı listeler gibi davranır.

Türündeki POSITION bir değişken, listenin anahtarıdır. Bir POSITION değişkeni, listeyi sıralı olarak çapraz geçiş yapmak için yineleyici ve yer işareti olarak kullanabilirsiniz. Ancak konum, dizinle aynı değildir.

Öğe ekleme, liste başında, kuyrukta ve bilinen POSITIONbir öğesinde çok hızlıdır. Bir öğeyi değere veya dizine göre aramak için sıralı arama gereklidir. Liste uzunsa bu arama yavaş olabilir.

Listedeki tek tek öğelerin dökümünü almanız gerekiyorsa döküm bağlamının derinliğini 1 veya daha büyük olarak ayarlamanız gerekir.

Bu sınıfın bazı üye işlevleri, sınıfın çoğu kullanımları CList için özelleştirilmesi gereken genel yardımcı işlevleri çağırır. "Makrolar ve GenelLer" bölümündeki Koleksiyon Sınıfı Yardımcıları bölümüne bakın.

kullanma CListhakkında daha fazla bilgi için Koleksiyonlar makalesine bakın.

Örnek

// 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;

Devralma Hiyerarşisi

CObject

CList

Gereksinimler

Üstbilgi: afxtempl.h

`CList::AddHead`

Bu listenin başına yeni bir öğe veya öğe listesi ekler.

POSITION AddHead(ARG_TYPE newElement);
void AddHead(CList* pNewList);

Parametreler

ARG_TYPE
Liste öğesinin türünü belirten şablon parametresi (başvuru olabilir).

newElement
Yeni öğe.

pNewList
Başka bir CList listenin işaretçisi. içindeki pNewList öğeler bu listeye eklenir.

Dönüş Değeri

İlk sürüm, POSITION yeni eklenen öğenin değerini döndürür.

Açıklamalar

Liste işlemden önce boş olabilir.

Örnek

// 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`

Bu listenin kuyruğuna yeni bir öğe veya öğe listesi ekler.

POSITION AddTail(ARG_TYPE newElement);
void AddTail(CList* pNewList);

Parametreler

ARG_TYPE
Liste öğesinin türünü belirten şablon parametresi (başvuru olabilir).

newElement
Bu listeye eklenecek öğe.

pNewList
Başka bir CList listenin işaretçisi. içindeki pNewList öğeler bu listeye eklenir.

Dönüş Değeri

İlk sürüm, POSITION yeni eklenen öğenin değerini döndürür.

Açıklamalar

Liste işlemden önce boş olabilir.

Örnek

// 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`

Boş bir sıralı liste oluşturur.

CList(INT_PTR nBlockSize = 10);

Parametreler

nBlockSize
Listeyi genişletmek için bellek ayırma ayrıntı düzeyi.

Açıklamalar

Liste büyüdükçe bellek girdi birimlerinde nBlockSize ayrılır.

Örnek

// 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`

Belirtilen searchValueile eşleşen ilk öğeyi bulmak için listede sıralı olarak aramalar.

POSITION Find(
    ARG_TYPE searchValue,
    POSITION startAfter = NULL) const;

Parametreler

ARG_TYPE
Liste öğesinin türünü belirten şablon parametresi (başvuru olabilir).

searchValue
Listede bulunabilecek değer.

startAfter
Aramanın başlangıç konumu. Değer belirtilmezse, arama baş öğesiyle başlar.

Dönüş Değeri

POSITION Nesne bulunamazsa yineleme veya nesne işaretçisi alma NULL için kullanılabilecek bir değer.

Örnek

// 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`

değerini nIndex listede dizin olarak kullanır.

POSITION FindIndex(INT_PTR nIndex) const;

Parametreler

nIndex
Bulunabilecek liste öğesinin sıfır tabanlı dizini.

Dönüş Değeri

POSITION Yineleme veya nesne işaretçisi alma için kullanılabilecek bir değer; NULL negatif veya çok büyüksenIndex.

Açıklamalar

Listenin başından sıralı tarama başlatır ve n. öğesinde durduruluyor.

Örnek

// 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`

Liste öğesini belirli bir konumda alır.

TYPE& GetAt(POSITION position);
const TYPE& GetAt(POSITION position) const;

Parametreler

TYPE
Listedeki nesne türünü belirten şablon parametresi.

position
Alınacak öğe listesindeki konum.

Dönüş Değeri

için dönüş değeri açıklamasına GetHeadbakın.

Açıklamalar

GetAt belirli bir konumla ilişkili öğeyi (veya öğeye başvuruyu) döndürür. Dizinle aynı değildir ve bir POSITION değer üzerinde kendiniz çalışamazsınız. Türündeki POSITION bir değişken, listenin anahtarıdır.

Değerinizin POSITION listede geçerli bir konumu temsildiğinden emin olmanız gerekir. Geçersizse, Microsoft Foundation Sınıf Kitaplığı'nın Hata Ayıklama sürümü onaylar.

Örnek

örneğine CList::GetHeadPositionbakın.

`CList::GetCount`

Bu listedeki öğelerin sayısını alır.

INT_PTR GetCount() const;

Dönüş Değeri

Öğe sayısını içeren bir tamsayı değeri.

Açıklamalar

Bu yöntemin çağrılması yöntemiyle CList::GetSize aynı sonucu oluşturur.

Örnek

örneğine CList::RemoveHeadbakın.

`CList::GetHead`

Bu listenin head öğesini (veya baş öğesine başvuruyu) alır.

const TYPE& GetHead() const;

TYPE& GetHead();

Parametreler

TYPE
Listedeki nesne türünü belirten şablon parametresi.

Dönüş Değeri

Liste ise const, GetHead listenin başındaki öğenin bir kopyasını döndürür. Bu, işlevin yalnızca atama deyiminin sağ tarafında kullanılmasını sağlar ve listeyi değişiklikten korur.

Liste değilse const, GetHead listenin başındaki öğeye bir başvuru döndürür. Bu, işlevin atama deyiminin her iki tarafında kullanılmasını sağlar ve böylece liste girdilerinin değiştirilmesine izin verir.

Açıklamalar

çağrısından GetHeadönce listenin boş olmadığından emin olmanız gerekir. Liste boşsa, Microsoft Foundation Sınıf Kitaplığı'nın Hata Ayıklama sürümü onaylar. Listenin öğeler içerdiğini doğrulamak için kullanın IsEmpty .

Örnek

// 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`

Bu listenin baş öğesinin konumunu alır.

POSITION GetHeadPosition() const;

Dönüş Değeri

POSITION Liste boşsa yineleme veya nesne işaretçisi alma NULL için kullanılabilecek bir değer.

Örnek

// 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`

tarafından rPositiontanımlanan list öğesini alır, ardından listedeki bir sonraki girdinin değerine ayarlar rPosition POSITION .

TYPE& GetNext(POSITION& rPosition);
const TYPE& GetNext(POSITION& rPosition) const;

Parametreler

TYPE
Listedeki öğelerin türünü belirten şablon parametresi.

rPosition
Önceki GetNextbir , GetHeadPositionveya başka bir POSITION üye işlev çağrısı tarafından döndürülen bir değere başvuru.

Dönüş Değeri

Liste ise const, GetNext liste öğesinin bir kopyasını döndürür. Bu, işlevin yalnızca atama deyiminin sağ tarafında kullanılmasını sağlar ve listeyi değişiklikten korur.

Liste değilse const, GetNext listenin bir öğesine başvuru döndürür. Bu, işlevin atama deyiminin her iki tarafında kullanılmasını sağlar ve böylece liste girdilerinin değiştirilmesine izin verir.

Açıklamalar

veya Findçağrısıyla GetHeadPosition ilk konumu belirlerseniz, bir iletme yineleme döngüsünde kullanabilirsinizGetNext.

Değerinizin POSITION listede geçerli bir konumu temsildiğinden emin olmanız gerekir. Geçersizse, Microsoft Foundation Sınıf Kitaplığı'nın Hata Ayıklama sürümü onaylar.

Alınan öğe listedeki son öğeyse, öğesinin yeni değeri rPosition NULL olarak ayarlanır.

Örnek

// 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`

tarafından rPositiontanımlanan list öğesini alır ve ardından listedeki önceki girdinin değerine ayarlar rPosition POSITION .

TYPE& GetPrev(POSITION& rPosition);
const TYPE& GetPrev(POSITION& rPosition) const;

Parametreler

TYPE
Listedeki öğelerin türünü belirten şablon parametresi.

rPosition
Önceki GetPrev veya başka bir POSITION üye işlev çağrısı tarafından döndürülen bir değere başvuru.

Dönüş Değeri

Liste ise const, GetPrev listenin başındaki öğenin bir kopyasını döndürür. Bu, işlevin yalnızca atama deyiminin sağ tarafında kullanılmasını sağlar ve listeyi değişiklikten korur.

Liste değilse const, GetPrev listenin bir öğesine başvuru döndürür. Bu, işlevin atama deyiminin her iki tarafında kullanılmasını sağlar ve böylece liste girdilerinin değiştirilmesine izin verir.

Açıklamalar

veya Findçağrısıyla GetTailPosition ilk konumu belirlerseniz ters yineleme döngüsünde kullanabilirsinizGetPrev.

Değerinizin POSITION listede geçerli bir konumu temsildiğinden emin olmanız gerekir. Geçersizse, Microsoft Foundation Sınıf Kitaplığı'nın Hata Ayıklama sürümü onaylar.

Alınan öğe listedeki ilk öğeyse, yeni değeri rPosition olarak NULLayarlanır.

Örnek

// 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`

Liste öğelerinin sayısını döndürür.

INT_PTR GetSize() const;

Dönüş Değeri

Listedeki öğelerin sayısı.

Açıklamalar

Listedeki öğe sayısını almak için bu yöntemi çağırın. Bu yöntemin çağrılması yöntemiyle CList::GetCount aynı sonucu oluşturur.

Örnek

// 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`

Bu listenin CObject kuyruk öğesini temsil eden işaretçiyi alır.

TYPE& GetTail();
const TYPE& GetTail() const;

Parametreler

TYPE
Listedeki öğelerin türünü belirten şablon parametresi.

Dönüş Değeri

için dönüş değeri açıklamasına GetHeadbakın.

Açıklamalar

çağrısından GetTailönce listenin boş olmadığından emin olmanız gerekir. Liste boşsa, Microsoft Foundation Sınıf Kitaplığı'nın Hata Ayıklama sürümü onaylar. Listenin öğeler içerdiğini doğrulamak için kullanın IsEmpty .

Örnek

// 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`

Bu listenin kuyruk öğesinin konumunu alır; NULL liste boşsa.

POSITION GetTailPosition() const;

Dönüş Değeri

POSITION Liste boşsa yineleme veya nesne işaretçisi alma NULL için kullanılabilecek bir değer.

Örnek

// 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`

Belirtilen konumda öğesinden sonra bu listeye bir öğe ekler.

POSITION InsertAfter(POSITION position, ARG_TYPE newElement);

Parametreler

position
Önceki GetNextbir , GetPrevveya Find üye işlev çağrısı tarafından döndürülen POSITION değeri.

ARG_TYPE
Liste öğesinin türünü belirten şablon parametresi.

newElement
Bu listeye eklenecek öğe.

Dönüş Değeri

POSITION Yineleme veya liste öğesi alma için kullanılabilecek bir değer.

Örnek

// 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`

Belirtilen konumdaki öğesinden önce bu listeye bir öğe ekler.

POSITION InsertBefore(POSITION position, ARG_TYPE newElement);

Parametreler

position
POSITION Önceki GetNextbir , GetPrevveya Find üye işlev çağrısı tarafından döndürülen değer.

ARG_TYPE
Liste öğesinin türünü belirten şablon parametresi (başvuru olabilir).

newElement
Bu listeye eklenecek öğe.

Dönüş Değeri

POSITION Yineleme veya liste öğesi alma için kullanılabilecek bir değer.

Açıklamalar

ise position NULL, öğesi listenin başına eklenir.

Örnek

// 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`

Bu listede öğe bulunup bulunmadığını gösterir.

BOOL IsEmpty() const;

Dönüş Değeri

Bu liste boşsa sıfır olmayan; aksi takdirde 0.

Örnek

// 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`

Bu listeden tüm öğeleri kaldırır ve ilişkili belleği serbest bırakır.

void RemoveAll();

Açıklamalar

Liste zaten boşsa hata oluşturulmaz.

Örnek

// 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`

Belirtilen öğeyi bu listeden kaldırır.

void RemoveAt(POSITION position);

Parametreler

position
Listeden kaldırılacak öğenin konumu.

Açıklamalar

Değerinizin POSITION listede geçerli bir konumu temsildiğinden emin olmanız gerekir. Geçersizse, Microsoft Foundation Sınıf Kitaplığı'nın Hata Ayıklama sürümü onaylar.

Örnek

// 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`

öğeyi listenin başından kaldırır ve buna bir işaretçi döndürür.

TYPE RemoveHead();

Parametreler

TYPE
Listedeki öğelerin türünü belirten şablon parametresi.

Dönüş Değeri

Daha önce listenin başındaki öğesi.

Açıklamalar

çağrısından RemoveHeadönce listenin boş olmadığından emin olmanız gerekir. Liste boşsa, Microsoft Foundation Sınıf Kitaplığı'nın Hata Ayıklama sürümü onaylar. Listenin öğeler içerdiğini doğrulamak için kullanın IsEmpty .

Örnek

// 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`

öğeyi listenin kuyruğundan kaldırır ve buna bir işaretçi döndürür.

TYPE RemoveTail();

Parametreler

TYPE
Listedeki öğelerin türünü belirten şablon parametresi.

Dönüş Değeri

Listenin sonundaki öğe.

Açıklamalar

çağrısından RemoveTailönce listenin boş olmadığından emin olmanız gerekir. Liste boşsa, Microsoft Foundation Sınıf Kitaplığı'nın Hata Ayıklama sürümü onaylar. Listenin öğeler içerdiğini doğrulamak için kullanın IsEmpty .

Örnek

// 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`

Türündeki POSITION bir değişken, listenin anahtarıdır.

void SetAt(POSITION pos, ARG_TYPE newElement);

Parametreler

pos
POSITION Ayarlanacak öğenin öğesi.

ARG_TYPE
Liste öğesinin türünü belirten şablon parametresi (başvuru olabilir).

newElement
Listeye eklenecek öğe.

Açıklamalar

Dizinle aynı değildir ve bir POSITION değer üzerinde kendiniz çalışamazsınız. SetAt öğesini listede belirtilen konuma yazar.

Değerinizin POSITION listede geçerli bir konumu temsildiğinden emin olmanız gerekir. Geçersizse, Microsoft Foundation Sınıf Kitaplığı'nın Hata Ayıklama sürümü onaylar.

Örnek

// 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);

Ayrıca bkz.

MFC Örneği COLLECT
CObject Sınıf
Hiyerarşi Grafiği
CMap Sınıf
CArray Sınıf

Aracılığıyla paylaş

CList Sınıf

Sözdizimi

Üyeler

Ortak Oluşturucular

Genel Yöntemler

Parametreler

Açıklamalar

Örnek

Devralma Hiyerarşisi

Gereksinimler

CList::AddHead

Parametreler

Dönüş Değeri

Açıklamalar

Örnek

CList::AddTail

Parametreler

Dönüş Değeri

Açıklamalar

Örnek

CList::CList

Parametreler

Açıklamalar

Örnek

CList::Find

Parametreler

Dönüş Değeri

Örnek

CList::FindIndex

Parametreler

Dönüş Değeri

Açıklamalar

Örnek

CList::GetAt

Parametreler

Dönüş Değeri

Açıklamalar

Örnek

CList::GetCount

Dönüş Değeri

Açıklamalar

Örnek

CList::GetHead

Parametreler

Dönüş Değeri

Açıklamalar

Örnek

CList::GetHeadPosition

Dönüş Değeri

Örnek

CList::GetNext

Parametreler

Dönüş Değeri

Açıklamalar

Örnek

CList::GetPrev

Parametreler

Dönüş Değeri

Açıklamalar

Örnek

CList::GetSize

Dönüş Değeri

Açıklamalar

Örnek

CList::GetTail

Parametreler

Dönüş Değeri

Açıklamalar

Örnek

CList::GetTailPosition

Dönüş Değeri

Örnek

CList::InsertAfter

Parametreler

Dönüş Değeri

Örnek

CList::InsertBefore

Parametreler

Dönüş Değeri

`CList` Sınıf

`CList::AddHead`

`CList::AddTail`

`CList::CList`

`CList::Find`

`CList::FindIndex`

`CList::GetAt`

`CList::GetCount`

`CList::GetHead`

`CList::GetHeadPosition`

`CList::GetNext`

`CList::GetPrev`

`CList::GetSize`

`CList::GetTail`

`CList::GetTailPosition`

`CList::InsertAfter`

`CList::InsertBefore`

`CList::IsEmpty`

`CList::RemoveAll`

`CList::RemoveAt`

`CList::RemoveHead`

`CList::RemoveTail`

`CList::SetAt`