CTypedPtrList::GetHead
更新 : 2007 年 11 月
リストの先頭要素を表すポインタを取得します。
TYPE& GetHead( );
TYPE GetHead( ) const;
パラメータ
- TYPE
リストに格納されている要素の型を指定するテンプレート パラメータ。
戻り値
リストが const CTypedPtrList へのポインタを使ってアクセスされた場合、GetHead 関数はテンプレート パラメータ TYPE で指定された型のポインタを返します。このとき、この関数は代入ステートメントの右辺にしか使用できないため、リストは変更されません。
リストが直接または CTypedPtrList へのポインタを使ってアクセスされた場合、GetHead 関数はテンプレート パラメータ TYPE で指定された型のポインタへの参照を返します。このとき、この関数は代入ステートメントの右辺にも左辺にも使用できるので、リストのエントリを変更できます。
解説
GetHead 関数を呼び出す前に、リストが空でないことを確認する必要があります。リストが空の場合、MFC ライブラリのデバッグ環境ではアサートされます。リストに要素があるかどうかは、IsEmpty 関数で確認できます。
必要条件
ヘッダー : afxtempl.h