CTypedPtrArray Sınıfı

veya CObArraysınıfı CPtrArray nesneleri için tür açısından güvenli bir "sarmalayıcı" sağlar.

Sözdizimi

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

Parametreler

BASE_CLASS
Yazılan işaretçi dizisi sınıfının temel sınıfı; bir dizi sınıfı ( CObArray veya CPtrArray) olmalıdır.

TÜR
Temel sınıf dizisinde depolanan öğelerin türü.

Üyeler

Genel Yöntemler

Ortak İşleçler

Açıklamalar

veya CObArrayyerine CPtrArray kullandığınızdaCTypedPtrArray, C++ tür denetimi özelliği eşleşmeyen işaretçi türlerinin neden olduğu hataların giderilmesine yardımcı olur.

Buna ek olarak, CTypedPtrArray sarmalayıcı veya CPtrArraykullanırsanız CObArray gerekli olan atamanın büyük bir kısmını gerçekleştirir.

Tüm CTypedPtrArray işlevler satır içi olduğundan, bu şablonun kullanılması kodunuzun boyutunu veya hızını önemli ölçüde etkilemez.

kullanma CTypedPtrArrayhakkında daha fazla bilgi için Koleksiyonlar ve Şablon Tabanlı Sınıflar makalelerine bakın.

Devralma Hiyerarşisi

BASE_CLASS

CTypedPtrArray

Gereksinimler

Üst bilgi: afxtempl.h

CTypedPtrArray::Add

Bu üye işlevi ::Add öğesini çağırır.BASE_CLASS

INT_PTR Add(TYPE newElement);

Parametreler

TÜR
Diziye eklenecek öğe türünü belirten şablon parametresi.

newElement
Bu diziye eklenecek öğe.

Dönüş Değeri

Eklenen öğenin dizini.

Açıklamalar

Daha ayrıntılı açıklamalar için bkz . CObArray::Add.

CTypedPtrArray::Append

Bu üye işlevi ::Append** öğesini çağırır BASE_CLASS.

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

Parametreler

BASE_CLASS
Yazılan işaretçi dizisi sınıfının temel sınıfı; bir dizi sınıfı ( CObArray veya CPtrArray) olmalıdır.

TÜR
Temel sınıf dizisinde depolanan öğelerin türü.

Src
Bir diziye eklenecek öğelerin kaynağı.

Dönüş Değeri

Eklenen ilk öğenin dizini.

Açıklamalar

Daha ayrıntılı açıklamalar için bkz . CObArray::Append.

CTypedPtrArray::Copy

Bu üye işlevi ::Copy öğesini çağırır.BASE_CLASS

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

Parametreler

BASE_CLASS
Yazılan işaretçi dizisi sınıfının temel sınıfı; bir dizi sınıfı ( CObArray veya CPtrArray) olmalıdır.

TÜR
Temel sınıf dizisinde depolanan öğelerin türü.

Src
Bir diziye kopyalanacak öğelerin kaynağı.

Açıklamalar

Daha ayrıntılı açıklamalar için bkz . CObArray::Copy.

CTypedPtrArray::ElementAt

Bu satır içi işlev ::ElementAt öğesini çağırır.BASE_CLASS

TYPE& ElementAt(INT_PTR nIndex);

Parametreler

TÜR
Bu dizide depolanan öğelerin türünü belirten şablon parametresi.

nIndex
::GetUpperBound tarafından BASE_CLASSdöndürülen değerden küçük veya buna eşit veya 0'a eşit veya ondan büyük bir tamsayı dizini.

Dönüş Değeri

nIndex tarafından belirtilen konumdaki öğesine geçici başvuru. Bu öğe, şablon parametresi TYPE tarafından belirtilen türdedir.

Açıklamalar

Daha ayrıntılı açıklamalar için bkz . CObArray::ElementAt.

CTypedPtrArray::GetAt

Bu satır içi işlev ::GetAt öğesini çağırır.BASE_CLASS

TYPE GetAt(INT_PTR nIndex) const;

Parametreler

TÜR
Dizide depolanan öğelerin türünü belirten şablon parametresi.

nIndex
::GetUpperBound tarafından BASE_CLASSdöndürülen değerden küçük veya buna eşit veya 0'a eşit veya ondan büyük bir tamsayı dizini.

Dönüş Değeri

nIndex tarafından belirtilen konumda öğesinin bir kopyası. Bu öğe, şablon parametresi TYPE tarafından belirtilen türdedir.

Açıklamalar

Daha ayrıntılı açıklamalar için bkz . CObArray::GetAt

CTypedPtrArray::InsertAt

Bu üye işlevi ::InsertAt öğesini çağırır.BASE_CLASS

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

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

Parametreler

nIndex
CObArray::GetUpperBound tarafından döndürülen değerden büyük olabilecek bir tamsayı dizini.

TÜR
Temel sınıf dizisinde depolanan öğelerin türü.

newElement
Bu diziye yerleştirilecek nesne işaretçisi. NULL değerinin newElement değerine izin verilir.

nCount
Bu öğenin kaç kez eklenmesi gerektiği (varsayılan olarak 1' olur).

nStartIndex
tarafından CObArray::GetUpperBounddöndürülen değerden büyük olabilecek bir tamsayı dizini.

BASE_CLASS
Yazılan işaretçi dizisi sınıfının temel sınıfı; bir dizi sınıfı ( CObArray veya CPtrArray) olmalıdır.

pNewArray
Bu diziye eklenecek öğeleri içeren başka bir dizi.

Açıklamalar

Daha ayrıntılı açıklamalar için bkz . CObArray::InsertAt.

CTypedPtrArray::operator [ ]

Bu satır içi işleçler ::operator [ ] öğesini çağırır.BASE_CLASS

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

Parametreler

TÜR
Dizide depolanan öğelerin türünü belirten şablon parametresi.

nIndex
::GetUpperBound tarafından BASE_CLASSdöndürülen değerden küçük veya buna eşit veya 0'a eşit veya ondan büyük bir tamsayı dizini.

Açıklamalar

olmayan constdiziler için çağrılan ilk işleç, atama deyiminin sağ (r-value) veya solunda (l-value) kullanılabilir. Diziler için const çağrılan ikinci, yalnızca sağda kullanılabilir.

Kitaplığın Hata Ayıklama sürümü, alt simgenin (atama deyiminin solunda veya sağ tarafında) sınırların dışında olup olmadığını onaylar.

CTypedPtrArray::SetAt

Bu üye işlevi ::SetAt öğesini çağırır.BASE_CLASS

void SetAt(
    INT_PTR nIndex,
    TYPE ptr);

Parametreler

nIndex
CObArray::GetUpperBound tarafından döndürülen değerden küçük veya buna eşit veya 0'a eşit veya ondan büyük bir tamsayı dizini.

TÜR
Temel sınıf dizisinde depolanan öğelerin türü.

ptr
nIndex dizinine eklenecek öğe işaretçisi. NULL değere izin verilir.

Açıklamalar

Daha ayrıntılı açıklamalar için bkz . CObArray::SetAt.

CTypedPtrArray::SetAtGrow

Bu üye işlevi ::SetAtGrow öğesini çağırır.BASE_CLASS

void SetAtGrow(
    INT_PTR nIndex,
    TYPE newElement);

Parametreler

nIndex
0'dan büyük veya 0'a eşit bir tamsayı dizini.

TÜR
Temel sınıf dizisinde depolanan öğelerin türü.

newElement
Bu diziye eklenecek nesne işaretçisi. NULL değere izin verilir.

Açıklamalar

Daha ayrıntılı açıklamalar için bkz . CObArray::SetAtGrow.

Ayrıca bkz.

MFC Örneği COLLECT
Hiyerarşi Grafiği
CPtrArray Sınıfı
CObArray Sınıfı