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
CStringArray
Gereksinimler
Üstbilgi: afxcoll.h