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

Ad	Tanım
CTypedPtrArray::Add	Dizinin sonuna yeni bir öğe ekler. Gerekirse diziyi büyütür
CTypedPtrArray::Append	Bir dizinin içeriğini başka bir dizinin sonuna ekler. Gerekirse diziyi büyütür
CTypedPtrArray::Copy	Diziye başka bir dizi kopyalar; gerekirse diziyi büyütür.
CTypedPtrArray::ElementAt	Dizi içindeki öğe işaretçisine geçici bir başvuru döndürür.
CTypedPtrArray::GetAt	Belirli bir dizindeki değeri döndürür.
CTypedPtrArray::InsertAt	Belirtilen dizine bir öğe (veya başka bir dizideki tüm öğeler) ekler.
CTypedPtrArray::SetAt	Belirli bir dizinin değerini ayarlar; dizisinin büyümesine izin verilmiyor.
CTypedPtrArray::SetAtGrow	Belirli bir dizinin değerini ayarlar; gerekirse diziyi büyütür.

Ortak İşleçler

Ad	Tanım
CTypedPtrArray::operator [ ]	Belirtilen dizinde öğesini ayarlar veya alır.

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.

İade 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ğı.

İade 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.

Nındex
::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.

İade 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.

Nındex
::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.

İade 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

Nındex
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.

Nındex
::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

Nındex
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

Nındex
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ı