CAtlList::RemoveAt

2011-08-09

リストから要素を 1 つ削除します。

void RemoveAt(
   POSITION pos 
) throw( );

パラメーター

pos
削除する要素の POSITION 値。

解説

pos で参照される要素を削除し、メモリを解放します。 RemoveAt を使用して、リストの先頭または末尾を削除することもできます。

デバッグビルドでは、リストが無効な場合、または要素が削除されたことによってリストがリスト構造体以外のメモリにアクセスする場合にアサーションエラーが発生します。

使用例

// Define the integer list
CAtlList<int> myList;

// Populate the list
myList.AddTail(100);
myList.AddTail(200);
myList.AddTail(300);

// Use RemoveAt to remove elements one by one
myList.RemoveAt(myList.Find(100));
myList.RemoveAt(myList.Find(200));
myList.RemoveAt(myList.Find(300));

// Confirm all have been deleted
ATLASSERT(myList.IsEmpty() == true);