`CObList`-Klasse

Artikel
10/12/2023

Unterstützt sortierte Listen von nicht CObject geordneten Zeigern, auf die sequenziell oder nach Zeigerwert zugegriffen werden kann.

Syntax

class CObList : public CObject

Member

Öffentliche Konstruktoren

Name	Beschreibung
`CObList::CObList`	Erstellt eine leere Liste für `CObject` Zeiger.

Öffentliche Methoden

Name	Beschreibung
`CObList::AddHead`	Fügt dem Kopf der Liste ein Element (oder alle Elemente in einer anderen Liste) hinzu (macht einen neuen Kopf).
`CObList::AddTail`	Fügt dem Listenende ein Element (oder alle Elemente in einer anderen Liste) hinzu (macht einen neuen Tail).
`CObList::Find`	Ruft die Position eines Elements ab, das durch Zeigerwert angegeben wird.
`CObList::FindIndex`	Ruft die Position eines Elements ab, das durch einen nullbasierten Index angegeben wird.
`CObList::GetAt`	Ruft das Element an einer bestimmten Position ab.
`CObList::GetCount`	Gibt die Anzahl der Elemente in dieser Liste zurück.
`CObList::GetHead`	Gibt das Kopfelement der Liste zurück (darf nicht leer sein).
`CObList::GetHeadPosition`	Gibt die Position des Kopfelements der Liste zurück.
`CObList::GetNext`	Ruft das nächste Element zum Durchlaufen ab.
`CObList::GetPrev`	Ruft das vorherige Element zum Durchlaufen ab.
`CObList::GetSize`	Gibt die Anzahl der Elemente in dieser Liste zurück.
`CObList::GetTail`	Gibt das Tail-Element der Liste zurück (kann nicht leer sein).
`CObList::GetTailPosition`	Gibt die Position des Tail-Elements der Liste zurück.
`CObList::InsertAfter`	Fügt ein neues Element nach einer bestimmten Position ein.
`CObList::InsertBefore`	Fügt ein neues Element vor einer bestimmten Position ein.
`CObList::IsEmpty`	Tests für die leere Listenbedingung (keine Elemente).
`CObList::RemoveAll`	Entfernt alle Elemente aus dieser Liste.
`CObList::RemoveAt`	Entfernt ein Element aus dieser Liste, angegeben nach Position.
`CObList::RemoveHead`	Entfernt das Element aus dem Kopf der Liste.
`CObList::RemoveTail`	Entfernt das Element aus dem Tail der Liste.
`CObList::SetAt`	Legt das Element an einer bestimmten Position fest.

Hinweise

CObList Listen verhalten sich wie doubly verknüpfte Listen.

Eine Variable vom Typ POSITION ist ein Schlüssel für die Liste. Sie können eine POSITION Variable sowohl als Iterator verwenden, um eine Liste sequenziell als auch als Textmarke zu durchlaufen, um einen Ort zu speichern. Eine Position ist jedoch nicht mit einem Index identisch.

Die Elementeinfügung ist sehr schnell am Listenkopf, am Schwanz und an einem bekannten POSITION. Eine sequenzielle Suche ist erforderlich, um ein Element nach Wert oder Index nachzuschlagen. Diese Suche kann langsam sein, wenn die Liste lang ist.

CObList enthält das Makro zur Unterstützung der IMPLEMENT_SERIAL Serialisierung und des Dumpings seiner Elemente. Wenn eine Liste von CObject Zeigern in einem Archiv gespeichert wird, entweder mit einem überladenen Einfügeoperator oder mit der Serialize Memberfunktion, wird jedes CObject Element wiederum serialisiert.

Wenn Sie ein Abbild einzelner CObject Elemente in der Liste benötigen, müssen Sie die Tiefe des Dumpkontexts auf 1 oder höher festlegen.

Wenn ein CObList Objekt gelöscht wird oder dessen Elemente entfernt werden, werden nur die CObject Zeiger entfernt, nicht die Objekte, auf die verwiesen wird.

Sie können Ihre eigenen Kurse ableiten von CObList. Die neue Listenklasse, die zum Speichern von Zeigern auf Objekte entwickelt wurde, die von CObjectobjekten abgeleitet wurden, fügt neue Datenmember und neue Memberfunktionen hinzu. Beachten Sie, dass die resultierende Liste nicht streng typsicher ist, da sie das Einfügen eines Zeigers CObject zulässt.

Hinweis

Sie müssen das IMPLEMENT_SERIAL Makro in der Implementierung Der abgeleiteten Klasse verwenden, wenn Sie die Liste serialisieren möchten.

Weitere Informationen zur Verwendung CObListfinden Sie im Artikel Sammlungen.

Vererbungshierarchie

CObject

CObList

Anforderungen

Header: afxcoll.h

`CObList::AddHead`

Fügt dem Kopf dieser Liste ein neues Element oder eine Liste von Elementen hinzu.

POSITION AddHead(CObject* newElement);
void AddHead(CObList* pNewList);

Parameter

newElement
Der CObject Zeiger, der dieser Liste hinzugefügt werden soll.

pNewList
Ein Zeiger auf eine andere CObList Liste. Die Elemente in pNewList dieser Liste werden hinzugefügt.

Rückgabewert

Die erste Version gibt den POSITION Wert des neu eingefügten Elements zurück.

In der folgenden Tabelle sind andere Memberfunktionen aufgeführt, die ähnlich sind CObList::AddHead.

Klasse	Memberfunktion
`CPtrList`	`POSITION AddHead( void * newElement );` `void AddHead( CPtrList * pNewList );`
`CStringList`	`POSITION AddHead(const CString& newElement );` `POSITION AddHead(LPCTSTR newElement );` `void AddHead(CStringList * pNewList );`

Hinweise

Die Liste kann vor dem Vorgang leer sein.

Beispiel

Eine Auflistung der Klasse finden Sie unter.See CObList::CObList for a listing of the CAge class.

CObList list;
list.AddHead(new CAge(21)); // 21 is now at head.
list.AddHead(new CAge(40)); // 40 replaces 21 at head.
#ifdef _DEBUG
afxDump.SetDepth(1);
afxDump << _T("AddHead example: ") << &list << _T("\n");
#endif

Die Ergebnisse dieses Programms sind wie folgt:

AddHead example: A CObList with 2 elements
a CAge at $44A8 40
a CAge at $442A 21

`CObList::AddTail`

Fügt dem Listenende ein neues Element oder eine Liste von Elementen hinzu.

POSITION AddTail(CObject* newElement);
void AddTail(CObList* pNewList);

Parameter

newElement
Der CObject Zeiger, der dieser Liste hinzugefügt werden soll.

pNewList
Ein Zeiger auf eine andere CObList Liste. Die Elemente in pNewList dieser Liste werden hinzugefügt.

Rückgabewert

Die erste Version gibt den POSITION Wert des neu eingefügten Elements zurück.

Hinweise

Die Liste kann vor dem Vorgang leer sein.

In der folgenden Tabelle sind andere Memberfunktionen aufgeführt, die ähnlich sind CObList::AddTail.

Klasse	Memberfunktion
`CPtrList`	`POSITION AddTail( void * newElement );` `void AddTail( CPtrList * pNewList );`
`CStringList`	`POSITION AddTail( const CString& newElement );` `POSITION AddTail( LPCTSTR newElement );` `void AddTail( CStringList * pNewList );`

Beispiel

Eine Auflistung der Klasse finden Sie unter.See CObList::CObList for a listing of the CAge class.

CObList list;
list.AddTail(new CAge(21));
list.AddTail(new CAge(40)); // List now contains (21, 40).
#ifdef _DEBUG
afxDump.SetDepth(1);
afxDump << _T("AddTail example: ") << &list << _T("\n");
#endif

Die Ergebnisse dieses Programms sind wie folgt:

AddTail example: A CObList with 2 elements
a CAge at $444A 21
a CAge at $4526 40

`CObList::CObList`

Erstellt eine leere CObject Zeigerliste.

CObList(INT_PTR nBlockSize = 10);

Parameter

nBlockSize
Die Granularität der Speicherzuweisung für die Erweiterung der Liste.

Hinweise

Wenn die Liste wächst, wird Speicher in Einheiten von nBlockSize Einträgen zugeordnet. Wenn eine Speicherzuweisung fehlschlägt, wird ein CMemoryException Fehler ausgelöst.

In der folgenden Tabelle sind andere Memberfunktionen aufgeführt, die ähnlich sind CObList::CObList.

Klasse	Memberfunktion
`CPtrList`	`CPtrList( INT_PTR nBlockSize = 10 );`
`CStringList`	`CStringList( INT_PTR nBlockSize = 10 );`

Beispiel

Nachfolgend finden Sie eine Auflistung der von -abgeleiteten KlasseCAge, die CObjectin allen Auflistungsbeispielen verwendet wird:

// Simple CObject-derived class for CObList and other examples
class CAge : public CObject
{
   DECLARE_SERIAL(CAge)
private:
   int   m_years;
public:
   CAge() { m_years = 0; }
   CAge(int age) { m_years = age; }
   CAge(const CAge& a) { m_years = a.m_years; } // Copy constructor
   void Serialize(CArchive& ar);
   void AssertValid() const;
   const CAge& operator=(const CAge& a)
   {
      m_years = a.m_years; return *this;
   }
   BOOL operator==(CAge a)
   {
      return m_years == a.m_years;
   }
#ifdef _DEBUG
   void Dump(CDumpContext& dc) const
   {
      CObject::Dump(dc);
      dc << m_years;
   }
#endif
};

Nachfolgend finden Sie ein Beispiel für die CObList Konstruktorverwendung:

CObList list(20);  // List on the stack with blocksize = 20.

CObList* plist = new CObList; // List on the heap with default 
                              // blocksize.

`CObList::Find`

Sucht die Liste sequenziell, um den ersten CObject Zeiger zu finden, der dem angegebenen Zeiger CObject entspricht.

POSITION Find(
    CObject* searchValue,
    POSITION startAfter = NULL) const;

Parameter

searchValue
Der In dieser Liste zu findende Objektzeiger.

startAfter
Die Startposition für die Suche.

Rückgabewert

Ein POSITION Wert, der für iterations- oder Objektzeigerabrufe verwendet werden kann; NULL wenn das Objekt nicht gefunden wird.

Hinweise

Beachten Sie, dass die Zeigerwerte verglichen werden, nicht der Inhalt der Objekte.

In der folgenden Tabelle sind andere Memberfunktionen aufgeführt, die ähnlich sind CObList::Find.

Klasse	Memberfunktion
`CPtrList`	`POSITION Find( void *searchValue , POSITION startAfter = NULL ) const;`
`CStringList`	`POSITION Find( LPCTSTR searchValue , POSITION startAfter = NULL ) const;`

Beispiel

Eine Auflistung der Klasse finden Sie unter.See CObList::CObList for a listing of the CAge class.

CObList list;
CAge* pa1;
CAge* pa2;
POSITION pos;
list.AddHead(pa1 = new CAge(21));
list.AddHead(pa2 = new CAge(40));    // List now contains (40, 21).
if ((pos = list.Find(pa1)) != NULL) // Hunt for pa1
{                                  // starting at head by default.
   ASSERT(*(CAge*)list.GetAt(pos) == CAge(21));
}

`CObList::FindIndex`

Verwendet den Wert als nIndex Index in der Liste.

POSITION FindIndex(INT_PTR nIndex) const;

Parameter

nIndex
Der nullbasierte Index des zu findenden Listenelements.

Rückgabewert

Ein POSITION Wert, der für iterations- oder Objektzeigerabrufe verwendet werden kann; NULL wenn nIndex dies zu groß ist. (Das Framework generiert eine Assertion, wenn nIndex sie negativ ist.)

Hinweise

Es beginnt eine sequenzielle Überprüfung vom Kopf der Liste, die auf dem nth-Elementbeendet wird.

In der folgenden Tabelle sind andere Memberfunktionen aufgeführt, die ähnlich sind CObList::FindIndex.

Klasse	Memberfunktion
`CPtrList`	`POSITION FindIndex( INT_PTR nIndex ) const;`
`CStringList`	`POSITION FindIndex( INT_PTR nIndex ) const;`

Beispiel

Eine Auflistung der Klasse finden Sie unter.See CObList::CObList for a listing of the CAge class.

CObList list;
POSITION pos;

list.AddHead(new CAge(21));
list.AddHead(new CAge(40)); // List now contains (40, 21).
if ((pos = list.FindIndex(0)) != NULL)
{
   ASSERT(*(CAge*)list.GetAt(pos) == CAge(40));
}

`CObList::GetAt`

Eine Variable vom Typ POSITION ist ein Schlüssel für die Liste.

CObject*& GetAt(POSITION position);
const CObject*& GetAt(POSITION position) const;

Parameter

position
Ein POSITION Wert, der von einem vorherigen GetHeadPosition Oder Find Memberfunktionsaufruf zurückgegeben wird.

Rückgabewert

Weitere Informationen finden Sie in der Beschreibung des Rückgabewerts für GetHead.

Hinweise

Sie ist nicht identisch mit einem Index, und Sie können nicht selbst auf einen POSITION Wert anwenden. GetAt ruft den Zeiger ab, der CObject einer bestimmten Position zugeordnet ist.

Sie müssen sicherstellen, dass Ihr POSITION Wert eine gültige Position in der Liste darstellt. Wenn sie ungültig ist, wird die Debugversion der Microsoft Foundation-Klassenbibliothek bestätigt.

In der folgenden Tabelle sind andere Memberfunktionen aufgeführt, die ähnlich sind CObList::GetAt.

Klasse	Memberfunktion
`CPtrList`	`const void& GetAt( POSITION position ) const;` `void& GetAt( POSITION position );`
`CStringList`	`const CString& GetAt( POSITION position ) const;` `CString& GetAt( POSITION position );`

Beispiel

Ein Beispiel hierfür finden Sie unter FindIndex.

`CObList::GetCount`

Ruft die Anzahl der Elemente in dieser Liste ab.

INT_PTR GetCount() const;

Rückgabewert

Ein ganzzahliger Wert, der die Elementanzahl enthält.

In der folgenden Tabelle sind andere Memberfunktionen aufgeführt, die ähnlich sind CObList::GetCount.

Klasse	Memberfunktion
`CPtrList`	`INT_PTR GetCount( ) const;`
`CStringList`	`INT_PTR GetCount( ) const;`

Beispiel

Eine Auflistung der Klasse finden Sie unter.See CObList::CObList for a listing of the CAge class.

CObList list;

list.AddHead(new CAge(21));
list.AddHead(new CAge(40)); // List now contains (40, 21).
ASSERT(list.GetCount() == 2);

`CObList::GetHead`

Ruft den CObject Zeiger ab, der das Kopfelement dieser Liste darstellt.

CObject*& GetHead();
const CObject*& GetHead() const;

Rückgabewert

Wenn auf die Liste über einen Zeiger auf ein const CObListZeiger zugegriffen wird, wird GetHead ein CObject Zeiger zurückgegeben. Auf diese Weise kann die Funktion nur auf der rechten Seite einer Zuordnungsanweisung verwendet werden und so die Liste vor Änderungen schützen.

Wenn auf die Liste direkt oder über einen Zeiger auf einen CObListZeiger zugegriffen wird, wird GetHead ein Verweis auf einen CObject Zeiger zurückgegeben. Dadurch kann die Funktion auf beiden Seiten einer Zuordnungsanweisung verwendet werden und somit die Listeneinträge geändert werden.

Hinweise

Sie müssen sicherstellen, dass die Liste vor dem Aufrufen GetHeadnicht leer ist. Wenn die Liste leer ist, wird die Debugversion der Microsoft Foundation-Klassenbibliothek bestätigt. Wird verwendet IsEmpty , um zu überprüfen, ob die Liste Elemente enthält.

In der folgenden Tabelle sind andere Memberfunktionen aufgeführt, die ähnlich sind CObList::GetHead.

Klasse	Memberfunktion
`CPtrList`	`const void& GetHead( ) const; void& GetHead( );`
`CStringList`	`const CString& GetHead( ) const; CString& GetHead( );`

Beispiel

Eine Auflistung der Klasse finden Sie unter.See CObList::CObList for a listing of the CAge class.

Im folgenden Beispiel wird die Verwendung GetHead auf der linken Seite einer Zuordnungsanweisung veranschaulicht.

const CObList* cplist;

CObList* plist = new CObList;
CAge* page1 = new CAge(21);
CAge* page2 = new CAge(30);
CAge* page3 = new CAge(40);
plist->AddHead(page1);
plist->AddHead(page2);  // List now contains (30, 21).
// The following statement REPLACES the head element.
plist->GetHead() = page3; // List now contains (40, 21).
ASSERT(*(CAge*)plist->GetHead() == CAge(40));
cplist = plist;  // cplist is a pointer to a const list.
// cplist->GetHead() = page3; // Error: can't assign a pointer to a const list
ASSERT(*(CAge*)plist->GetHead() == CAge(40)); // OK

delete page1;
delete page2;
delete page3;
delete plist; // Cleans up memory.

`CObList::GetHeadPosition`

Ruft die Position des Kopfelements dieser Liste ab.

POSITION GetHeadPosition() const;

Rückgabewert

Ein POSITION Wert, der für iterations- oder Objektzeigerabrufe verwendet werden kann; NULL wenn die Liste leer ist.

In der folgenden Tabelle sind andere Memberfunktionen aufgeführt, die ähnlich sind CObList::GetHeadPosition.

Klasse	Memberfunktion
`CPtrList`	`POSITION GetHeadPosition( ) const;`
`CStringList`	`POSITION GetHeadPosition( ) const;`

Beispiel

Eine Auflistung der Klasse finden Sie unter.See CObList::CObList for a listing of the CAge class.

CObList list;
POSITION pos;

list.AddHead(new CAge(21));
list.AddHead(new CAge(40)); // List now contains (40, 21).
if ((pos = list.GetHeadPosition()) != NULL)
{
   ASSERT(*(CAge*)list.GetAt(pos) == CAge(40));
}

`CObList::GetNext`

Ruft das listenelement, durch rPositiondas identifiziert wird, und legt rPosition dann den POSITION Wert des nächsten Eintrags in der Liste fest.

CObject*& GetNext(POSITION& rPosition);
const CObject* GetNext(POSITION& rPosition) const;

Parameter

rPosition
Ein Verweis auf einen POSITION Wert, der von einem vorherigen GetNext, GetHeadPositionoder einem anderen Memberfunktionsaufruf zurückgegeben wird.

Rückgabewert

Weitere Informationen finden Sie in der Beschreibung des Rückgabewerts für GetHead.

Hinweise

Sie können in einer Vorwärts iterationsschleife verwendenGetNext, wenn Sie die Anfangsposition mit einem Aufruf oder Findeinem Aufruf GetHeadPosition einrichten.

Sie müssen sicherstellen, dass Ihr POSITION Wert eine gültige Position in der Liste darstellt. Wenn sie ungültig ist, wird die Debugversion der Microsoft Foundation-Klassenbibliothek bestätigt.

Wenn das abgerufene Element der letzte in der Liste ist, wird der neue Wert rPosition auf .NULL

Es ist möglich, ein Element während einer Iteration zu entfernen. Ein Beispiel hierfür finden Sie unter RemoveAt.

Hinweis

Ab MFC 8.0 hat sich die const-Version dieser Methode geändert, anstatt const CObject*&zurückzugebenconst CObject*. Diese Änderung wurde vorgenommen, um den Compiler in Übereinstimmung mit dem C++-Standard zu bringen.

In der folgenden Tabelle sind andere Memberfunktionen aufgeführt, die ähnlich sind CObList::GetNext.

Klasse	Memberfunktion
`CPtrList`	`void& GetNext( POSITION&` `rPosition` `);` `const void GetNext( POSITION&` `rPosition` `) const;`
`CStringList`	`CString& GetNext( POSITION&` `rPosition` `);` `const CString& GetNext( POSITION&` `rPosition` `) const;`

Beispiel

Eine Auflistung der Klasse finden Sie unter.See CObList::CObList for a listing of the CAge class.

CObList list;
POSITION pos;
list.AddHead(new CAge(21));
list.AddHead(new CAge(40)); // List now contains (40, 21).
// Iterate through the list in head-to-tail order.
#ifdef _DEBUG
for (pos = list.GetHeadPosition(); pos != NULL;)
{
   afxDump << list.GetNext(pos) << _T("\n");
}
#endif

Die Ergebnisse dieses Programms sind wie folgt:

a CAge at $479C 40
a CAge at $46C0 21

`CObList::GetPrev`

Ruft das listenelement ab, durch rPositiondas identifiziert wird, und legt rPosition es dann auf den POSITION Wert des vorherigen Eintrags in der Liste fest.

CObject*& GetPrev(POSITION& rPosition);
const CObject* GetPrev(POSITION& rPosition) const;

Parameter

rPosition
Ein Verweis auf einen POSITION Wert, der von einem vorherigen GetPrev oder anderen Memberfunktionsaufruf zurückgegeben wird.

Rückgabewert

Weitere Informationen finden Sie in der Beschreibung des Rückgabewerts für GetHead.

Hinweise

Sie können in einer Umgekehrten Iterationsschleife verwendenGetPrev, wenn Sie die Anfangsposition mit einem Aufruf oder Findeinem Aufruf GetTailPosition einrichten.

Sie müssen sicherstellen, dass Ihr POSITION Wert eine gültige Position in der Liste darstellt. Wenn sie ungültig ist, wird die Debugversion der Microsoft Foundation-Klassenbibliothek bestätigt.

Wenn das abgerufene Element der erste in der Liste ist, wird der neue Wert auf rPosition .NULL

Hinweis

In der folgenden Tabelle sind andere Memberfunktionen aufgeführt, die ähnlich sind CObList::GetPrev.

Klasse	Memberfunktion
`CPtrList`	`void& GetPrev( POSITION&` `rPosition` `);` `const void GetPrev( POSITION&` `rPosition` `) const;`
`CStringList`	`CString& GetPrev( POSITION&` `rPosition` `);` `const CString& GetPrev( POSITION&` `rPosition` `) const;`

Beispiel

Eine Auflistung der Klasse finden Sie unter.See CObList::CObList for a listing of the CAge class.

CObList list;
POSITION pos;

list.AddHead(new CAge(21));
list.AddHead(new CAge(40)); // List now contains (40, 21).
// Iterate through the list in tail-to-head order.
for (pos = list.GetTailPosition(); pos != NULL;)
{
#ifdef _DEBUG
   afxDump << list.GetPrev(pos) << _T("\n");
#endif
}

Die Ergebnisse dieses Programms sind wie folgt:

a CAge at $421C 21
a CAge at $421C 40

`CObList::GetSize`

Gibt die Anzahl der Listenelemente zurück.

INT_PTR GetSize() const;

Rückgabewert

Die Anzahl der Elemente in der Liste.

Hinweise

Rufen Sie diese Methode auf, um die Anzahl der Elemente in der Liste abzurufen.

In der folgenden Tabelle sind andere Memberfunktionen aufgeführt, die ähnlich sind CObList::GetSize.

Klasse	Memberfunktion
`CPtrList`	`INT_PTR GetSize( ) const;`
`CStringList`	`INT_PTR GetSize( ) const;`

Beispiel

Eine Auflistung der Klasse finden Sie unter.See CObList::CObList for a listing of the CAge class.

CObList list;

list.AddHead(new CAge(21));
list.AddHead(new CAge(40)); // List now contains (40, 21).
ASSERT(list.GetSize() == 2);

`CObList::GetTail`

Ruft den CObject Zeiger ab, der das Tail-Element dieser Liste darstellt.

CObject*& GetTail();
const CObject*& GetTail() const;

Rückgabewert

Weitere Informationen finden Sie in der Beschreibung des Rückgabewerts für GetHead.

Hinweise

Sie müssen sicherstellen, dass die Liste vor dem Aufrufen GetTailnicht leer ist. Wenn die Liste leer ist, wird die Debugversion der Microsoft Foundation-Klassenbibliothek bestätigt. Wird verwendet IsEmpty , um zu überprüfen, ob die Liste Elemente enthält.

In der folgenden Tabelle sind andere Memberfunktionen aufgeführt, die ähnlich sind CObList::GetTail.

Klasse	Memberfunktion
`CPtrList`	`const void& GetTail( ) const; void& GetTail( );`
`CStringList`	`const CString& GetTail( ) const; CString& GetTail( );`

Beispiel

Eine Auflistung der Klasse finden Sie unter.See CObList::CObList for a listing of the CAge class.

CObList list;

list.AddHead(new CAge(21));
list.AddHead(new CAge(40)); // List now contains (40, 21).
ASSERT(*(CAge*)list.GetTail() == CAge(21));

`CObList::GetTailPosition`

Ruft die Position des Tail-Elements dieser Liste ab; NULL wenn die Liste leer ist.

POSITION GetTailPosition() const;

Rückgabewert

Ein POSITION Wert, der für iterations- oder Objektzeigerabrufe verwendet werden kann; NULL wenn die Liste leer ist.

In der folgenden Tabelle sind andere Memberfunktionen aufgeführt, die ähnlich sind CObList::GetTailPosition.

Klasse	Memberfunktion
`CPtrList`	`POSITION GetTailPosition( ) const;`
`CStringList`	`POSITION GetTailPosition( ) const;`

Beispiel

Eine Auflistung der Klasse finden Sie unter.See CObList::CObList for a listing of the CAge class.

CObList list;
POSITION pos;

list.AddHead(new CAge(21));
list.AddHead(new CAge(40)); // List now contains (40, 21).
if ((pos = list.GetTailPosition()) != NULL)
{
    ASSERT(*(CAge*) list.GetAt(pos) == CAge(21));
}

`CObList::InsertAfter`

Fügt dieser Liste ein Element nach dem Element an der angegebenen Position hinzu.

POSITION InsertAfter(
    POSITION position,
    CObject* newElement);

Parameter

position
Ein POSITION Wert, der von einem vorherigen GetNext, GetPrevoder Find Memberfunktionsaufruf zurückgegeben wird.

newElement
Der Objektzeiger, der dieser Liste hinzugefügt werden soll.

In der folgenden Tabelle sind andere Memberfunktionen aufgeführt, die ähnlich sind CObList::InsertAfter.

Klasse	Memberfunktion
`CPtrList`	`POSITION InsertAfter( POSITION position , void * newElement );`
`CStringList`	`POSITION InsertAfter( POSITION position , const CString& newElement );` `POSITION InsertAfter( POSITION position , LPCTSTR newElement );`

Rückgabewert

Ein POSITION Wert, der position dem Parameter entspricht.

Beispiel

Eine Auflistung der Klasse finden Sie unter.See CObList::CObList for a listing of the CAge class.

CObList list;
POSITION pos1, pos2;
list.AddHead(new CAge(21));
list.AddHead(new CAge(40)); // List now contains (40, 21).
if ((pos1 = list.GetHeadPosition()) != NULL)
{
    pos2 = list.InsertAfter(pos1, new CAge(65));
}
#ifdef _DEBUG
   afxDump.SetDepth(1);
   afxDump << _T("InsertAfter example: ") << &list << _T("\n");
#endif

Die Ergebnisse dieses Programms sind wie folgt:

InsertAfter example: A CObList with 3 elements
a CAge at $4A44 40
a CAge at $4A64 65
a CAge at $4968 21

`CObList::InsertBefore`

Fügt dieser Liste ein Element vor dem Element an der angegebenen Position hinzu.

POSITION InsertBefore(
    POSITION position,
    CObject* newElement);

Parameter

position
Ein POSITION Wert, der von einem vorherigen GetNext, GetPrevoder Find Memberfunktionsaufruf zurückgegeben wird.

newElement
Der Objektzeiger, der dieser Liste hinzugefügt werden soll.

Rückgabewert

Ein POSITION Wert, der für iterations- oder Objektzeigerabrufe verwendet werden kann; NULL wenn die Liste leer ist.

In der folgenden Tabelle sind andere Memberfunktionen aufgeführt, die ähnlich sind CObList::InsertBefore.

Klasse	Memberfunktion
`CPtrList`	`POSITION InsertBefore( POSITION position , void * newElement );`
`CStringList`	`POSITION InsertBefore( POSITION position , const CString& newElement );` `POSITION InsertBefore( POSITION position , LPCTSTR newElement );`

Beispiel

Eine Auflistung der Klasse finden Sie unter.See CObList::CObList for a listing of the CAge class.

CObList list;
POSITION pos1, pos2;
list.AddHead(new CAge(21));
list.AddHead(new CAge(40)); // List now contains (40, 21).
if ((pos1 = list.GetTailPosition()) != NULL)
{
    pos2 = list.InsertBefore(pos1, new CAge(65));
}
#ifdef _DEBUG
   afxDump.SetDepth(1);
   afxDump << _T("InsertBefore example: ") << &list << _T("\n");
#endif

Die Ergebnisse dieses Programms sind wie folgt:

InsertBefore example: A CObList with 3 elements
a CAge at $4AE2 40
a CAge at $4B02 65
a CAge at $49E6 21

`CObList::IsEmpty`

Gibt an, ob diese Liste keine Elemente enthält.

BOOL IsEmpty() const;

Rückgabewert

Nonzero, wenn diese Liste leer ist; andernfalls 0.

In der folgenden Tabelle sind andere Memberfunktionen aufgeführt, die ähnlich sind CObList::IsEmpty.

Klasse	Memberfunktion
`CPtrList`	BOOL IsEmpty( ) const;
`CStringList`	BOOL IsEmpty( ) const;

Beispiel

Ein Beispiel hierfür finden Sie unter RemoveAll.

`CObList::RemoveAll`

Entfernt alle Elemente aus dieser Liste und gibt den zugeordneten CObList Speicher frei.

void RemoveAll();

Hinweise

Wenn die Liste bereits leer ist, wird kein Fehler generiert.

Wenn Sie Elemente aus einem CObListElement entfernen, entfernen Sie die Objektzeiger aus der Liste. Es liegt in Ihrer Verantwortung, die Objekte selbst zu löschen.

In der folgenden Tabelle sind andere Memberfunktionen aufgeführt, die ähnlich sind CObList::RemoveAll.

Klasse	Memberfunktion
`CPtrList`	`void RemoveAll( );`
`CStringList`	`void RemoveAll( );`

Beispiel

Eine Auflistung der Klasse finden Sie unter.See CObList::CObList for a listing of the CAge class.

CObList list;
CAge* pa1;
CAge* pa2;
ASSERT(list.IsEmpty()); // Yes it is.
list.AddHead(pa1 = new CAge(21));
list.AddHead(pa2 = new CAge(40)); // List now contains (40, 21).
ASSERT(!list.IsEmpty()); // No it isn't.
list.RemoveAll(); // CAges aren't destroyed.
ASSERT(list.IsEmpty()); // Yes it is.
delete pa1;     // Now delete the CAge objects.
delete pa2;

`CObList::RemoveAt`

Entfernt das angegebene Element aus dieser Liste.

void RemoveAt(POSITION position);

Parameter

position
Die Position des Elements, das aus der Liste entfernt werden soll.

Hinweise

Wenn Sie ein Element aus einem CObListElement entfernen, entfernen Sie den Objektzeiger aus der Liste. Es liegt in Ihrer Verantwortung, die Objekte selbst zu löschen.

Sie müssen sicherstellen, dass Ihr POSITION Wert eine gültige Position in der Liste darstellt. Wenn sie ungültig ist, wird die Debugversion der Microsoft Foundation-Klassenbibliothek bestätigt.

In der folgenden Tabelle sind andere Memberfunktionen aufgeführt, die ähnlich sind CObList::RemoveAt.

Klasse	Memberfunktion
`CPtrList`	`void RemoveAt( POSITION position );`
`CStringList`	`void RemoveAt( POSITION position );`

Beispiel

Achten Sie beim Entfernen eines Elements während einer Listeniteration darauf. Das folgende Beispiel zeigt eine Entfernungstechnik, die einen gültigen POSITION Wert garantiert.GetNext

Eine Auflistung der Klasse finden Sie unter.See CObList::CObList for a listing of the CAge class.

CObList list;
POSITION pos1, pos2;
CObject* pa;

list.AddHead(new CAge(21));
list.AddHead(new CAge(40));
list.AddHead(new CAge(65)); // List now contains (65 40, 21).
for (pos1 = list.GetHeadPosition(); (pos2 = pos1) != NULL;)
{
   if (*(CAge*)list.GetNext(pos1) == CAge(40))
   {
      pa = list.GetAt(pos2); // Save the old pointer for
                             //deletion.
      list.RemoveAt(pos2);
      delete pa; // Deletion avoids memory leak.
   }
}
#ifdef _DEBUG
afxDump.SetDepth(1);
afxDump << _T("RemoveAt example: ") << &list << _T("\n");
#endif

Die Ergebnisse dieses Programms sind wie folgt:

RemoveAt example: A CObList with 2 elements

a CAge at $4C1E 65

a CAge at $4B22 21

`CObList::RemoveHead`

Entfernt das Element aus dem Kopf der Liste und gibt einen Zeiger darauf zurück.

CObject* RemoveHead();

Rückgabewert

Der CObject Zeiger, der sich zuvor am Anfang der Liste befindet.

Hinweise

Sie müssen sicherstellen, dass die Liste vor dem Aufrufen RemoveHeadnicht leer ist. Wenn die Liste leer ist, wird die Debugversion der Microsoft Foundation-Klassenbibliothek bestätigt. Wird verwendet IsEmpty , um zu überprüfen, ob die Liste Elemente enthält.

In der folgenden Tabelle sind andere Memberfunktionen aufgeführt, die ähnlich sind CObList::RemoveHead.

Klasse	Memberfunktion
`CPtrList`	`void* RemoveHead( );`
`CStringList`	`CString RemoveHead( );`

Beispiel

Eine Auflistung der Klasse finden Sie unter.See CObList::CObList for a listing of the CAge class.

CObList list;
CAge* pa1;
CAge* pa2;

list.AddHead(pa1 = new CAge(21));
list.AddHead(pa2 = new CAge(40)); // List now contains (40, 21).
ASSERT(*(CAge*)list.RemoveHead() == CAge(40));  // Old head
ASSERT(*(CAge*)list.GetHead() == CAge(21));  // New head
delete pa1;
delete pa2;

`CObList::RemoveTail`

Entfernt das Element aus dem Tail der Liste und gibt einen Zeiger darauf zurück.

CObject* RemoveTail();

Rückgabewert

Ein Zeiger auf das Objekt, das sich am Ende der Liste befand.

Hinweise

Sie müssen sicherstellen, dass die Liste vor dem Aufrufen RemoveTailnicht leer ist. Wenn die Liste leer ist, wird die Debugversion der Microsoft Foundation-Klassenbibliothek bestätigt. Wird verwendet IsEmpty , um zu überprüfen, ob die Liste Elemente enthält.

In der folgenden Tabelle sind andere Memberfunktionen aufgeführt, die ähnlich sind CObList::RemoveTail.

Klasse	Memberfunktion
`CPtrList`	`void* RemoveTail( );`
`CStringList`	`CString RemoveTail( );`

Beispiel

Eine Auflistung der Klasse finden Sie unter.See CObList::CObList for a listing of the CAge class.

CObList list;
CAge* pa1;
CAge* pa2;

list.AddHead(pa1 = new CAge(21));
list.AddHead(pa2 = new CAge(40)); // List now contains (40, 21).
ASSERT(*(CAge*)list.RemoveTail() == CAge(21));  // Old tail
ASSERT(*(CAge*)list.GetTail() == CAge(40));  // New tail
delete pa1;
delete pa2; // Clean up memory.

`CObList::SetAt`

Legt das Element an einer bestimmten Position fest.

void SetAt(
    POSITION pos,
    CObject* newElement);

Parameter

pos
Das POSITION festzulegende Element.

newElement
Der CObject Zeiger, der in die Liste geschrieben werden soll.

Hinweise

Eine Variable vom Typ POSITION ist ein Schlüssel für die Liste. Sie ist nicht identisch mit einem Index, und Sie können nicht selbst auf einen POSITION Wert anwenden. SetAt schreibt den CObject Zeiger auf die angegebene Position in der Liste.

Sie müssen sicherstellen, dass Ihr POSITION Wert eine gültige Position in der Liste darstellt. Wenn sie ungültig ist, wird die Debugversion der Microsoft Foundation-Klassenbibliothek bestätigt.

In der folgenden Tabelle sind andere Memberfunktionen aufgeführt, die ähnlich sind CObList::SetAt.

Klasse	Memberfunktion
`CPtrList`	`void SetAt( POSITION pos , const CString& newElement );`
`CStringList`	`void SetAt( POSITION pos , LPCTSTR newElement );`

Beispiel

Eine Auflistung der Klasse finden Sie unter.See CObList::CObList for a listing of the CAge class.

CObList list;
CObject* pa;
POSITION pos;

list.AddHead(new CAge(21));
list.AddHead(new CAge(40)); // List now contains (40, 21).
if ((pos = list.GetTailPosition()) != NULL)
{
   pa = list.GetAt(pos); // Save the old pointer for 
                         //deletion.
   list.SetAt(pos, new CAge(65));  // Replace the tail 
                                     //element.
   delete pa;  // Deletion avoids memory leak.
}
#ifdef _DEBUG
afxDump.SetDepth(1);
afxDump << _T("SetAt example: ") << &list << _T("\n");
#endif

Die Ergebnisse dieses Programms sind wie folgt:

SetAt example: A CObList with 2 elements
a CAge at $4D98 40
a CAge at $4DB8 65

Siehe auch

CObject-Klasse
Hierarchiediagramm
CStringList Klasse
CPtrList Klasse

Freigeben über

CObList-Klasse

Syntax

Member

Öffentliche Konstruktoren

Öffentliche Methoden

Hinweise

Vererbungshierarchie

Anforderungen

CObList::AddHead

Parameter

Rückgabewert

Hinweise

Beispiel

CObList::AddTail

Parameter

Rückgabewert

Hinweise

Beispiel

CObList::CObList

Parameter

Hinweise

Beispiel

CObList::Find

Parameter

Rückgabewert

Hinweise

Beispiel

CObList::FindIndex

Parameter

Rückgabewert

Hinweise

Beispiel

CObList::GetAt

Parameter

Rückgabewert

Hinweise

Beispiel

CObList::GetCount

Rückgabewert

Beispiel

CObList::GetHead

Rückgabewert

Hinweise

Beispiel

CObList::GetHeadPosition

Rückgabewert

Beispiel

CObList::GetNext

Parameter

Rückgabewert

Hinweise

Beispiel

CObList::GetPrev

Parameter

Rückgabewert

Hinweise

Beispiel

CObList::GetSize

Rückgabewert

Hinweise

Beispiel

CObList::GetTail

Rückgabewert

Hinweise

Beispiel

CObList::GetTailPosition

Rückgabewert

Beispiel

CObList::InsertAfter

Parameter

Rückgabewert

Beispiel

CObList::InsertBefore

Parameter

Rückgabewert

Beispiel

CObList::IsEmpty

Rückgabewert

Beispiel

`CObList`-Klasse

`CObList::AddHead`

`CObList::AddTail`

`CObList::CObList`

`CObList::Find`

`CObList::FindIndex`

`CObList::GetAt`

`CObList::GetCount`

`CObList::GetHead`

`CObList::GetHeadPosition`

`CObList::GetNext`

`CObList::GetPrev`

`CObList::GetSize`

`CObList::GetTail`

`CObList::GetTailPosition`

`CObList::InsertAfter`

`CObList::InsertBefore`

`CObList::IsEmpty`

`CObList::RemoveAll`

`CObList::RemoveAt`

`CObList::RemoveHead`

`CObList::RemoveTail`

`CObList::SetAt`