CObList::CObList

[アーティクル]
08/09/2011

空の CObject ポインターのリストを構築します。

CObList(
   INT_PTR nBlockSize = 10 
);

パラメーター

nBlockSize
リストを拡張するときに割り当てるメモリの単位を指定します。

解説

リストが拡張されるときに、nBlockSize のエントリで指定された単位でメモリが割り当てられます。メモリの割り当てができなかったときは、CMemoryException がスローされます。

CObList::CObList に類似している他のメンバー関数を以下に示します。

Class	メンバー関数
CPtrList	CPtrList( INT_PTR nBlockSize = 10 );
CStringList	CStringList( INT_PTR nBlockSize = 10 );

使用例

すべてのコレクションの例で使われている CObject の派生クラス CAge のリストを次に示します。

// Simple CObject-derived class for CObList and other examples
class CAge : public CObject
{
    DECLARE_SERIAL( CAge )
private:
    int   m_years;
public:
    CAge() { m_years = 0; }
    CAge(int age) { m_years = age; }
    CAge(const CAge& a) { m_years = a.m_years; } // Copy constructor
    void Serialize(CArchive& ar);
    void AssertValid() const;
    const CAge& operator=(const CAge& a)
    {
        m_years = a.m_years; return *this;
    }
    BOOL operator==(CAge a)
    {
        return m_years == a.m_years;
    }
#ifdef _DEBUG
    void Dump(CDumpContext& dc) const
    {
        CObject::Dump(dc);
        dc << m_years; 
    }
#endif
};

CObList コンストラクターの使い方の例を次に示します。

CObList list(20);  // List on the stack with blocksize = 20.

CObList* plist = new CObList; // List on the heap with default 
                              // blocksize.