CStringArray Sınıf

Nesne dizilerini CString destekler.

Sözdizimi

class CStringArray : public CObject

Üyeler

öğesinin CStringArray üye işlevleri, sınıfının CObArrayüye işlevlerine benzer. Bu benzerlik nedeniyle, üye işlevi özellikleri için başvuru belgelerini kullanabilirsiniz CObArray . bir işaretçiyi dönüş değeri olarak gördüğünüz CObject her yerde, bir CString nesneyi (işaretçi değil CString ) yerine kullanın. bir işaretçiyi işlev parametresi olarak gördüğünüz CObject her yerde yerine bir LPCTSTRyazın.

CObject* CObArray::GetAt( int <nIndex> ) const;

örneğin,

const CString& CStringArray::GetAt( int <nIndex> ) const;

ile

void SetAt( int <nIndex>, CObject* <newElement> )

şu şekilde çevrilir:

void SetAt( int <nIndex>, LPCTSTR <newElement> )

Ortak Oluşturucular

Veri Akışı Adı	Açıklama
CStringArray::CStringArray	Boş bir dizi oluşturur.

Genel Yöntemler

Veri Akışı Adı	Açıklama
CStringArray::Add	Dizinin sonuna bir öğe ekler; gerekirse diziyi büyütür.
CStringArray::Append	Diziye başka bir dizi ekler; gerekirse diziyi büyütür.
CStringArray::Copy	Diziye başka bir dizi kopyalar; gerekirse diziyi büyütür.
CStringArray::ElementAt	Dizi içindeki öğe işaretçisine geçici bir başvuru döndürür.
CStringArray::FreeExtra	Kullanılmayan tüm belleği geçerli üst sınırın üzerinde serbest bırakır.
CStringArray::GetAt	Belirli bir dizindeki değeri döndürür.
CStringArray::GetCount	Bu dizideki öğelerin sayısını alır.
CStringArray::GetData	Dizideki öğelere erişime izin verir. olabilir NULL.
CStringArray::GetSize	Bu dizideki öğelerin sayısını alır.
CStringArray::GetUpperBound	En büyük geçerli dizini döndürür.
CStringArray::InsertAt	Belirtilen dizine bir öğe (veya başka bir dizideki tüm öğeler) ekler.
CStringArray::IsEmpty	Dizinin boş olup olmadığını belirler.
CStringArray::RemoveAll	Bu dizideki tüm öğeleri kaldırır.
CStringArray::RemoveAt	Belirli bir dizindeki bir öğeyi kaldırır.
CStringArray::SetAt	Belirli bir dizinin değerini ayarlar; dizisinin büyümesine izin verilmiyor.
CStringArray::SetAtGrow	Belirli bir dizinin değerini ayarlar; gerekirse diziyi büyütür.
CStringArray::SetSize	Bu dizide yer alan öğelerin sayısını ayarlar.

Ortak İşleçler

Veri Akışı Adı	Açıklama
CStringArray::operator [ ]	Belirtilen dizinde öğesini ayarlar veya alır.

Açıklamalar

CStringArray öğelerinin seri hale getirilmesini IMPLEMENT_SERIAL ve dökümünün atılması için makroyu birleştirir. Bir nesne dizisi CString , aşırı yüklenmiş ekleme işleciyle veya üye işleviyle Serialize bir arşivde depolanıyorsa, her öğe sırayla serileştirilir.

Not

Diziyi kullanmadan önce, boyutunu oluşturmak ve bunun için bellek ayırmak için kullanın SetSize . kullanmazsanız SetSize, dizinize öğe eklemek sık sık yeniden ayrılmalarına ve kopyalanmalarına neden olur. Sık yeniden konumlandırma ve kopyalama verimsizdir ve belleği parçalayabilir.

Dizideki tek tek dize öğelerinin dökümünü almanız gerekiyorsa, döküm bağlamının derinliğini 1 veya daha büyük olarak ayarlamanız gerekir.

Bir CString dizi silindiğinde veya öğeleri kaldırıldığında, dize belleği uygun şekilde serbest bırakılır.

kullanma CStringArrayhakkında daha fazla bilgi için Koleksiyonlar makalesine bakın.

Devralma Hiyerarşisi

CObject

CStringArray

Gereksinimler

Üstbilgi: afxcoll.h

Ayrıca bkz.

CObject Sınıf
Hiyerarşi Grafiği