CObList クラス

アクセスできる CObject の一意でないポインターの順次またはポインター値によるサポートの順序付きリスト。

class CObList : public CObject

メンバー

パブリック コンストラクター

名前	説明
CObList::CObList	CObject ポインターの空のリストを構築します。

パブリック メソッド

名前	説明
CObList::AddHead	要素 (またはほかのリストのすべての要素) をリストの先頭に追加します (その要素を新たに先頭とします)。
CObList::AddTail	要素 (またはほかのリストのすべての要素) をリストの末尾に追加します (その要素を新たに末尾とします)。
CObList::Find	ポインターの値で指定された要素の位置を取得します。
CObList::FindIndex	0 から始まるインデックスで示される要素の位置を取得します。
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	指定した位置に要素を設定します。

解説

CObList の一覧には、二重リンク リストのようになります。

POSITION 型の変数は、リストのキーです。反復子とブックマークとして場所を保持するリストを順番に検索するに POSITION の変数を使用できます。ただし、インデックス位置は、と同じではありません。

要素の挿入はリストの先頭、末尾、および既知の POSITIONに非常に高速です。シーケンシャル サーチに、値またはインデックスで要素を調べて必要です。この検索はリストが分かかることがあります。

CObList は、要素のシリアル化とダンプをサポートするために IMPLEMENT_SERIAL のマクロが組み込まれています。CObject のポインターのリストがオーバーロードされた挿入演算子を使用して、または Serialize のメンバー関数のアーカイブに格納されている場合、CObject の各要素では、シリアル化されます。

リストで CObject の各要素をダンプする必要があるときは、1 にダンプ コンテキストの深さを設定するより大きい。

CObList のオブジェクトを削除または要素が削除されたときに、CObject のポインターだけが削除されますが、参照する、オブジェクト。

CObListから独自のクラスを派生させることができます。CObjectから派生したオブジェクトへのポインターを保持するための、新しいリスト クラスは、新しいデータ メンバー、および新しいメンバー関数を追加します。CObject のすべてのポインターの挿入を使用すると、リストが、タイプ セーフでないことに注意してください。

[!メモ]

リストをシリアル化する場合は、派生クラスの実装で IMPLEMENT_SERIAL のマクロを使用する必要があります。

CObListの使用の詳細については、" " [コレクション]を参照してください。

継承階層

CObject

CObList

必要条件

Header: afxcoll.h

参照

関連項目

CObject クラス

階層図

CStringList クラス

CPtrList クラス