Share via

CTypedPtrArray クラス

  • [アーティクル]

CPtrArray クラスまたは CObArrayクラスのオブジェクトに対してタイプセーフな "ラッパー" を提供します。

構文

template<class BASE_CLASS, class TYPE>
class CTypedPtrArray : public BASE_CLASS

パラメーター

BA Standard Edition_CLASS
型指定されたポインター配列クラスの基底クラス。は配列クラス ( CObArray または CPtrArray) である必要があります。

TYPE
基底クラス配列に格納されている要素の型。

メンバー

パブリック メソッド

名前 説明
CTypedPtrArray::Add 配列の末尾に新しい要素を追加します。 必要に応じて配列を拡大する
CTypedPtrArray::Append ある配列の内容を別の配列の末尾に追加します。 必要に応じて配列を拡大する
CTypedPtrArray::Copy 配列に別の配列をコピーします。必要に応じて、配列を大きくします。
CTypedPtrArray::ElementAt 配列内の要素ポインターへの一時的な参照を返します。
CTypedPtrArray::GetAt 指定されたインデックス位置にある値を返します。
CTypedPtrArray::InsertAt 指定されたインデックス位置に要素 (または別の配列内のすべての要素) を挿入します。
CTypedPtrArray::SetAt 指定されたインデックスの値を設定します。配列は大きくできません。
CTypedPtrArray::SetAtGrow 指定されたインデックスの値を設定します。必要に応じて、配列を大きくします。

パブリック演算子

名前 説明
CTypedPtrArray::operator [ ] 指定されたインデックス位置にある要素を設定または取得します。

解説

ではなく、またはCObArray使用CTypedPtrArrayCPtrArrayする場合、C++ 型チェック機能は、ポインター型の不一致によって発生するエラーを排除するのに役立ちます。

さらに、ラッパーは CTypedPtrArray 、使用 CObArray した場合に必要になるキャストの多くを実行します CPtrArray。

すべての CTypedPtrArray 関数はインラインであるため、このテンプレートを使用してもコードのサイズや速度に大きな影響はありません。

使用CTypedPtrArrayの詳細については、コレクションとテンプレート ベースのクラスに関する記事を参照してください。

継承階層

BASE_CLASS

CTypedPtrArray

必要条件

ヘッダー: afxtempl.h

CTypedPtrArray::Add

このメンバー関数は、::Add を呼び出しますBASE_CLASS。

INT_PTR Add(TYPE newElement);

パラメーター

TYPE
配列に追加する要素の型を指定するテンプレート パラメーター。

newElement
この配列に追加する要素。

戻り値

追加された要素のインデックス。

解説

詳細な解説については、CObArray::Add を参照してください。

CTypedPtrArray::Append

このメンバー関数は、::Append** を呼び出 BASE_CLASSします。

INT_PTR Append(const CTypedPtrArray<BASE_CLASS, TYPE>& src);

パラメーター

BA Standard Edition_CLASS
型指定されたポインター配列クラスの基底クラス。は配列クラス ( CObArray または CPtrArray) である必要があります。

TYPE
基底クラス配列に格納されている要素の型。

src
配列に追加する要素のソース。

戻り値

最初に追加された要素のインデックス。

解説

詳細な解説については、CObArray::Append を参照してください。

CTypedPtrArray::Copy

このメンバー関数は、::Copy を呼び出しますBASE_CLASS。

void Copy(const CTypedPtrArray<BASE_CLASS, TYPE>& src);

パラメーター

BA Standard Edition_CLASS
型指定されたポインター配列クラスの基底クラス。は配列クラス ( CObArray または CPtrArray) である必要があります。

TYPE
基底クラス配列に格納されている要素の型。

src
配列にコピーする要素のソース。

解説

詳細な解説については、CObArray::Copy を参照してください。

CTypedPtrArray::ElementAt

このインライン関数は、::ElementAt を呼び出 BASE_CLASSします。

TYPE& ElementAt(INT_PTR nIndex);

パラメーター

TYPE
この配列に格納されている要素の型を指定するテンプレート パラメーター。

Nindex
0 以上で、::GetUpperBound によってBASE_CLASS返される値以下の整数インデックス。

戻り値

nIndex で指定された場所にある要素への一時的な参照。 この要素は、テンプレート パラメーター TYPE で指定された型です。

解説

詳細な解説については、CObArray::ElementAt を参照してください。

CTypedPtrArray::GetAt

このインライン関数は、::GetAt を呼び出 BASE_CLASSします。

TYPE GetAt(INT_PTR nIndex) const;

パラメーター

TYPE
配列に格納されている要素の型を指定するテンプレート パラメーター。

Nindex
0 以上で、::GetUpperBound によってBASE_CLASS返される値以下の整数インデックス。

戻り値

nIndex で指定された場所にある要素のコピー。 この要素は、テンプレート パラメーター TYPE で指定された型です。

解説

詳細な解説については、CObArray::GetAt を参照してください 。

CTypedPtrArray::InsertAt

このメンバー関数は、::InsertAt を呼び出 BASE_CLASSします。

void InsertAt(
    INT_PTR nIndex,
    TYPE newElement,
    INT_PTR nCount = 1);

void InsertAt(
    INT_PTR nStartIndex,
    CTypedPtrArray<BASE_CLASS, TYPE>* pNewArray);

パラメーター

Nindex
CObArray::GetUpperBound によって返される値より大きい整数インデックス。

TYPE
基底クラス配列に格納されている要素の型。

newElement
この配列に配置するオブジェクト ポインター。 値 NULL の newElement を使用できます。

nCount
この要素を挿入する回数 (既定値は 1)。

nStartIndex
によって返される CObArray::GetUpperBound値より大きい可能性がある整数インデックス。

BA Standard Edition_CLASS
型指定されたポインター配列クラスの基底クラス。は配列クラス ( CObArray または CPtrArray) である必要があります。

pNewArray
この配列に追加する要素を含む別の配列。

解説

詳細な解説については、CObArray::InsertAt を参照してください。

CTypedPtrArray::operator [ ]

これらのインライン演算子は、::operator [ ]を呼び出しますBASE_CLASS。

TYPE& operator[ ](int_ptr nindex);
TYPE operator[ ](int_ptr nindex) const;

パラメーター

TYPE
配列に格納されている要素の型を指定するテンプレート パラメーター。

Nindex
0 以上で、::GetUpperBound によってBASE_CLASS返される値以下の整数インデックス。

解説

指定されていない const配列に対して呼び出される最初の演算子は、代入ステートメントの右 (r 値) または左 (l 値) で使用できます。 2 つ目は、配列に対して const 呼び出され、右側でのみ使用できます。

ライブラリのデバッグ バージョンは、下付き文字 (代入ステートメントの左側または右側) が範囲外の場合にアサートします。

CTypedPtrArray::SetAt

このメンバー関数は、::SetAt を呼び出しますBASE_CLASS。

void SetAt(
    INT_PTR nIndex,
    TYPE ptr);

パラメーター

Nindex
0 以上で、CObArray::GetUpperBound によって返される値以下の整数インデックス。

TYPE
基底クラス配列に格納されている要素の型。

ptr
nIndex の配列に挿入される要素へのポインター。 NULL 値を使用できます。

解説

詳細な解説については、CObArray::SetAt を参照してください。

CTypedPtrArray::SetAtGrow

このメンバー関数は、::SetAtGrow を呼び出しますBASE_CLASS。

void SetAtGrow(
    INT_PTR nIndex,
    TYPE newElement);

パラメーター

Nindex
0 以上の整数インデックス。

TYPE
基底クラス配列に格納されている要素の型。

newElement
この配列に追加するオブジェクト ポインター。 NULL 値を使用できます。

解説

詳細な解説については、CObArray::SetAtGrow を参照してください。

関連項目

MFC サンプル COLLECT
階層図
CPtrArray クラス
CObArray クラス