Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
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
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