CList クラス

オブジェクト (重複あり) を順に並べたリストをサポートします。このリストには、シーケンシャル アクセスまたは値指定によるアクセスを行うことができます。

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

メンバー

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

名前	説明
CList::CList	空の順序付きリストを構築します。

パブリック メソッド

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

パラメーター

• TYPE
  リストに格納されているオブジェクトの型。

• ARG*_*TYPE
  リストに格納されているオブジェクト参照に使用される型。参照である場合があります。

解説

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

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

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

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

このクラスの一部のメンバー関数は、グローバルなヘルパー関数を呼び出します。したがって、CList クラスの主な用途に合わせて、これらのヘルパー関数をカスタマイズする必要があります。「MFC マクロとグローバル」の コレクション クラスのヘルパー を参照してください。

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

使用例

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

継承階層

CObject

CList

必要条件

Header: afxtempl.h

参照

関連項目

CObject クラス

階層図

CMap クラス

CArray クラス

概念

MFC のサンプルが収集されます