CSimpleArray Sınıfı

Bu sınıf, basit bir diziyi yönetmek için yöntemler sağlar.

Sözdizimi

template <class T, class TEqual = CSimpleArrayEqualHelper<T>>
class CSimpleArray

Parametreler

T
Dizide depoacak veri türü.

TEqual
T türündeki öğeler için eşitlik testini tanımlayan bir özellik nesnesi.

Üyeler

Ortak Oluşturucular

Genel Yöntemler

Ortak İşleçler

Açıklamalar

CSimpleArray , herhangi bir türde Tbasit bir dizi oluşturmak ve yönetmek için yöntemler sağlar.

parametresi TEqual , türünde Tiki öğe için bir eşitlik işlevi tanımlamanın bir aracı sağlar. CSimpleArrayEqualHelper'a benzer bir sınıf oluşturarak, belirli bir dizi için eşitlik testinin davranışını değiştirmek mümkündür. Örneğin, bir işaretçi dizisiyle ilgilenirken, işaretçilerin başvuracağı değerlere bağlı olarak eşitliği tanımlamak yararlı olabilir. Varsayılan uygulama operator=() kullanır.

Hem hem de CSimpleArray CSimpleMap az sayıda öğe için tasarlanmıştır. Dizi çok sayıda öğe içerdiğinde CAtlArray ve CAtlMap kullanılmalıdır.

Gereksinimler

Üst bilgi: atlsimpcoll.h

Örnek

// Create an array of integers
CSimpleArray<int> iArray;

// Create an array of char pointers
// and use a new equality function
CSimpleArray<char *, MyEqualityEqualHelper<char *> > cMyArray;   

CSimpleArray::Add

Diziye yeni bir öğe ekler.

BOOL Add(const T& t);

Parametreler

t
Diziye eklenecek öğe.

Dönüş Değeri

Öğesi diziye başarıyla eklenirse TRUE, aksi takdirde YANLIŞ döndürür.

Örnek

// Create an array of integers and add some elements
CSimpleArray<int> iMyArray;
for (int i = 0; i < 10; i++)
   iMyArray.Add(i);  

CSimpleArray::CSimpleArray

Dizi nesnesinin oluşturucusunun.

CSimpleArray(const CSimpleArray<T, TEqual>& src);
CSimpleArray();

Parametreler

Src
Varolan bir CSimpleArray nesnesi.

Açıklamalar

Veri üyelerini başlatır, yeni bir boş CSimpleArray nesne veya var olan CSimpleArray bir nesnenin kopyasını oluşturur.

CSimpleArray::~CSimpleArray

Yok edici.

~CSimpleArray();

Açıklamalar

Ayrılan tüm kaynakları serbesttir.

CSimpleArray::Find

Dizideki bir öğeyi bulur.

int Find(const T& t) const;

Parametreler

t
Aranacak öğe.

Dönüş Değeri

Bulunan öğenin dizinini veya öğe bulunamazsa -1 değerini döndürür.

Örnek

// Create an array of floats and search for a particular element

CSimpleArray<float> fMyArray;

for (int i = 0; i < 10; i++)
   fMyArray.Add((float)i * 100);

int e = fMyArray.Find(200);
if (e == -1)
   _tprintf_s(_T("Could not find element\n"));
else
   _tprintf_s(_T("Found the element at location %d\n"), e);   

CSimpleArray::GetData

Dizide depolanan verilere bir işaretçi döndürür.

T* GetData() const;

Dönüş Değeri

Dizideki verilere bir işaretçi döndürür.

CSimpleArray::GetSize

Dizide depolanan öğelerin sayısını döndürür.

int GetSize() const;

Dönüş Değeri

Dizide depolanan öğelerin sayısını döndürür.

CSimpleArray::operator []

Diziden bir öğe alır.

T& operator[](int nindex);

Parametreler

nIndex
Öğe dizini.

Dönüş Değeri

nIndex tarafından başvuruda bulunan dizinin öğesini döndürür.

Örnek

// Create an array and display its contents
 CSimpleArray<int> iMySampleArray;

 for (int i = 0; i < 10; i++)
    iMySampleArray.Add(i);

 for (int i = 0; i < iMySampleArray.GetSize(); i++)
    _tprintf_s(_T("Array index %d contains %d\n"), i, iMySampleArray[i]);

CSimpleArray::operator =

Atama işleci.

CSimpleArray<T, TEqual>
& operator=(
    const CSimpleArray<T, TEqual>& src);

Parametreler

Src
Kopyalanacak dizi.

Dönüş Değeri

Güncelleştirilmiş CSimpleArray nesneye bir işaretçi döndürür.

Açıklamalar

src tarafından başvuruda bulunan nesnedeki CSimpleArray tüm öğeleri geçerli dizi nesnesine kopyalayarak var olan tüm verileri değiştirir.

Örnek

// Create an array of chars and copy it to a second array
CSimpleArray<char> cMyArray1;
cMyArray1.Add('a');
CSimpleArray<char> cMyArray2;
cMyArray2 = cMyArray1;
ATLASSERT(cMyArray2[0] == 'a');   

CSimpleArray::Remove

Belirli bir öğeyi diziden kaldırır.

BOOL Remove(const T& t);

Parametreler

t
Diziden kaldırılacak öğe.

Dönüş Değeri

Öğesi bulunur ve kaldırılırsa TRUE, aksi takdirde YANLIŞ döndürür.

Açıklamalar

Bir öğe kaldırıldığında, dizideki kalan öğeler boş alanı dolduracak şekilde yeniden numaralandırılır.

CSimpleArray::RemoveAll

Dizideki tüm öğeleri kaldırır.

void RemoveAll();

Açıklamalar

Dizide depolanan tüm öğeleri kaldırır.

CSimpleArray::RemoveAt

Belirtilen öğeyi diziden kaldırır.

BOOL RemoveAt(int nIndex);

Parametreler

nIndex
Kaldırılacak öğeye işaret eden dizin.

Dönüş Değeri

Öğesi kaldırıldıysa TRUE, dizin geçersizse YANLIŞ döndürür.

Açıklamalar

Bir öğe kaldırıldığında, dizideki kalan öğeler boş alanı dolduracak şekilde yeniden numaralandırılır.

CSimpleArray::SetAtIndex

Dizide belirtilen öğeyi ayarlayın.

BOOL SetAtIndex(
    int nIndex,
    const T& t);

Parametreler

nIndex
Değiştirecek öğenin dizini.

t
Belirtilen öğeye atanacak değer.

Dönüş Değeri

Başarılı olursa TRUE, dizin geçerli değilse YANLIŞ döndürür.

Ayrıca bkz.

Sınıfa Genel Bakış