CStringArray osztály

Megjegyzés:

A Microsoft Foundation Classes (MFC) könyvtár továbbra is támogatott. A továbbiakban azonban nem adunk hozzá funkciókat, és nem frissítjük a dokumentációt.

Támogatja az CString objektumtömböket.

Szemantika

class CStringArray : public CObject

Tagok

A tagfüggvények CStringArray az osztály CObArraytagfüggvényeihez hasonlóak. A hasonlóság miatt a CObArray tagfüggvény-specifikus referenciadokumentációt használhatja. Ha egy mutatót CObject visszatérési értékként lát, helyettesítsen egy CString objektumot (nem mutatót CString ). Ahol egy mutatót CObject függvényparaméterként lát, helyettesítse be a következőt LPCTSTR:

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

például lefordítja a következőre:

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

és

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

lefordítja a

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

Nyilvános konstruktorok

Név	Description
CStringArray::CStringArray	Üres tömböt hoz létre.

Nyilvános metódusok

Név	Description
CStringArray::Add	Hozzáad egy elemet a tömb végéhez; szükség esetén növeli a tömböt.
CStringArray::Append	Egy másik tömb hozzáfűzése a tömbhöz; szükség esetén növeli a tömböt.
CStringArray::Copy	Másik tömb másolása a tömbbe; szükség esetén növeli a tömböt.
CStringArray::ElementAt	A tömbön belüli elemmutatóra mutató ideiglenes hivatkozást ad vissza.
CStringArray::FreeExtra	Felszabadítja az összes fel nem használt memóriát az aktuális felső határ felett.
CStringArray::GetAt	Egy adott index értékét adja vissza.
CStringArray::GetCount	Lekéri a tömb elemeinek számát.
CStringArray::GetData	Lehetővé teszi a tömb elemeinek elérését. Lehet NULL.
CStringArray::GetSize	Lekéri a tömb elemeinek számát.
CStringArray::GetUpperBound	A legnagyobb érvényes indexet adja vissza.
CStringArray::InsertAt	Egy elemet (vagy egy másik tömb összes elemét) szúr be egy adott indexbe.
CStringArray::IsEmpty	Meghatározza, hogy a tömb üres-e.
CStringArray::RemoveAll	Eltávolítja az összes elemet ebből a tömbből.
CStringArray::RemoveAt	Eltávolít egy elemet egy adott indexből.
CStringArray::SetAt	Egy adott index értékét állítja be; tömb nem növekedhet.
CStringArray::SetAtGrow	Egy adott index értékét állítja be; szükség esetén növeli a tömböt.
CStringArray::SetSize	Beállítja a tömbben található elemek számát.

Nyilvános operátorok

Név	Description
CStringArray::operator [ ]	Beállítja vagy lekéri az elemet a megadott indexen.

Megjegyzések

CStringArray a makrót beépíti az IMPLEMENT_SERIAL elemek szerializálásának és memóriaképének támogatására. Ha egy objektumtömböt CString egy archívumban tárol egy túlterhelt beszúrási operátorral vagy a tagfüggvénnyel, az Serialize egyes elemek egymás után szerializálva lesznek.

Megjegyzés:

A tömb használata előtt állítsa SetSize be a méretét, és foglaljon le memóriát. Ha nem használ SetSizeelemeket a tömbhöz, az gyakran újraelosztást és másolást okoz. A gyakori újratelepítés és másolás nem hatékony, és töredezett memóriát okozhat.

Ha a tömb egyes sztringelemeinek memóriaképére van szüksége, a memóriakép-környezet mélységét 1 vagy annál nagyobbra kell állítania.

Egy tömb törlésekor vagy elemeinek eltávolításakor a sztringmemória CString a megfelelő módon felszabadul.

A használatról CStringArraytovábbi információt a Gyűjtemények című cikkben talál.

Öröklési hierarchia

CObject

CStringArray

Requirements

Fejléc:afxcoll.h

Lásd még

CObject osztály
hierarchiadiagram