CTypedPtrArray osztály

Típusbiztos "burkolót" biztosít az osztály CPtrArray vagy CObArraya .

Szemantika

template<class BASE_CLASS, class TYPE>
class CTypedPtrArray : public BASE_CLASS

Paraméterek

BASE_CLASS
A beírt mutatótömbosztály alaposztálya; tömbosztálynak (CObArray vagy CPtrArray).

TÍPUS
Az alaposztály tömbjében tárolt elemek típusa.

Tagok

Nyilvános metódusok

Név	Leírás
CTypedPtrArray::Hozzáadás	Új elemet ad hozzá egy tömb végéhez. Szükség esetén növeli a tömböt
CTypedPtrArray::Append	Hozzáadja az egyik tömb tartalmát a másik végéhez. Szükség esetén növeli a tömböt
CTypedPtrArray::Copy	Másik tömb másolása a tömbbe; szükség esetén növeli a tömböt.
CTypedPtrArray::ElementAt	A tömbön belüli elemmutatóra mutató ideiglenes hivatkozást ad vissza.
CTypedPtrArray::GetAt	Egy adott index értékét adja vissza.
CTypedPtrArray::InsertAt	Egy elemet (vagy egy másik tömb összes elemét) szúr be egy adott indexbe.
CTypedPtrArray::SetAt	Egy adott index értékét állítja be; tömb nem növekedhet.
CTypedPtrArray::SetAtGrow	Egy adott index értékét állítja be; szükség esetén növeli a tömböt.

Nyilvános operátorok

Név	Leírás
CTypedPtrArray::operátor [ ]	Beállítja vagy lekéri az elemet a megadott indexen.

Megjegyzések

A CTypedPtrArray C++ típusellenőrző eszköz használata vagy helyett CPtrArrayCObArraysegít kiküszöbölni a nem egyező mutatótípusok által okozott hibákat.

Emellett a burkoló elvégzi az CTypedPtrArray öntvény nagy részét, amelyre szükség lenne a használat vagy CObArrayCPtrArraya .

Mivel minden CTypedPtrArray függvény beágyazott, a sablon használata nem befolyásolja jelentősen a kód méretét vagy sebességét.

További információ a használatról CTypedPtrArray: Gyűjtemények és Template-Based osztályok.

Öröklési hierarchia

BASE_CLASS

CTypedPtrArray

Követelmények

Fejléc: afxtempl.h

CTypedPtrArray::Hozzáadás

Ez a tagfüggvény meghívja BASE_CLASSa következőt: :Add.

INT_PTR Add(TYPE newElement);

Paraméterek

TÍPUS
A tömbhöz hozzáadni kívánt elem típusát meghatározó sablonparaméter.

newElement
A tömbhöz hozzáadandó elem.

Visszaadott érték

A hozzáadott elem indexe.

Megjegyzések

További részletekért lásd: CObArray::Add.

CTypedPtrArray::Append

Ez a tagfüggvény meghívja BASE_CLASSa következőt: :Append**.

INT_PTR Append(const CTypedPtrArray<BASE_CLASS, TYPE>& src);

Paraméterek

BASE_CLASS
A beírt mutatótömbosztály alaposztálya; tömbosztálynak ( CObArray vagy CPtrArray) kell lennie.

TÍPUS
Az alaposztály tömbjében tárolt elemek típusa.

Src
A tömbhöz fűzendő elemek forrása.

Visszaadott érték

Az első hozzáfűzött elem indexe.

Megjegyzések

Részletesebb megjegyzésekért lásd: CObArray::Append.

CTypedPtrArray::Copy

Ez a tagfüggvény meghívja BASE_CLASSa következőt: :Copy.

void Copy(const CTypedPtrArray<BASE_CLASS, TYPE>& src);

Paraméterek

BASE_CLASS
A beírt mutatótömbosztály alaposztálya; tömbosztálynak ( CObArray vagy CPtrArray) kell lennie.

TÍPUS
Az alaposztály tömbjében tárolt elemek típusa.

Src
A tömbbe másolandó elemek forrása.

Megjegyzések

Részletesebb megjegyzésekért lásd: CObArray::Copy.

CTypedPtrArray::ElementAt

Ez a beágyazott függvény meghívja BASE_CLASSa következőt: :ElementAt.

TYPE& ElementAt(INT_PTR nIndex);

Paraméterek

TÍPUS
A tömbben tárolt elemek típusát meghatározó sablonparaméter.

nIndex
0-nál nagyobb vagy egyenlő egész számindex, amely kisebb, mint a BASE_CLASS által visszaadott érték.

Visszaadott érték

Ideiglenes hivatkozás az nIndex által megadott helyen található elemre. Ez az elem a TYPE sablonparaméter által megadott típusú.

Megjegyzések

Részletesebb megjegyzésekért lásd: CObArray::ElementAt.

CTypedPtrArray::GetAt

Ez a beágyazott függvény meghívja BASE_CLASSa következőt: :GetAt.

TYPE GetAt(INT_PTR nIndex) const;

Paraméterek

TÍPUS
A tömbben tárolt elemek típusát meghatározó sablonparaméter.

nIndex
0-nál nagyobb vagy egyenlő egész számindex, amely kisebb, mint a BASE_CLASS által visszaadott érték.

Visszaadott érték

Az elem másolata az nIndex által megadott helyen. Ez az elem a TYPE sablonparaméter által megadott típusú.

Megjegyzések

Részletesebb megjegyzésekért lásd: CObArray::GetAt

CTypedPtrArray::InsertAt

Ez a tagfüggvény a következőt hívja BASE_CLASS: :InsertAt.

void InsertAt(
    INT_PTR nIndex,
    TYPE newElement,
    INT_PTR nCount = 1);

void InsertAt(
    INT_PTR nStartIndex,
    CTypedPtrArray<BASE_CLASS, TYPE>* pNewArray);

Paraméterek

nIndex
Egy olyan egész számindex, amely nagyobb lehet, mint a CObArray::GetUpperBound által visszaadott érték.

TÍPUS
Az alaposztály tömbjében tárolt elemek típusa.

newElement
A tömbbe helyezendő objektummutató. A NULL érték új értéke engedélyezett.

nCount
Az elem beszúrásának száma (alapértelmezés szerint 1).

nStartIndex
Egy egész szám index, amely nagyobb lehet, mint a visszaadott CObArray::GetUpperBoundérték.

BASE_CLASS
A beírt mutatótömbosztály alaposztálya; tömbosztálynak ( CObArray vagy CPtrArray) kell lennie.

pNewArray
Egy másik tömb, amely a tömbhöz hozzáadandó elemeket tartalmazza.

Megjegyzések

Részletesebb megjegyzésekért lásd: CObArray::InsertAt.

CTypedPtrArray::operátor [ ]

Ezek a beágyazott operátorok a következőt hívják BASE_CLASS: :operátor [ ].

TYPE& operator[ ](int_ptr nindex);
TYPE operator[ ](int_ptr nindex) const;

Paraméterek

TÍPUS
A tömbben tárolt elemek típusát meghatározó sablonparaméter.

nIndex
0-nál nagyobb vagy egyenlő egész számindex, amely kisebb, mint a BASE_CLASS által visszaadott érték.

Megjegyzések

A nem consttömbökhöz hívott első operátor a hozzárendelési utasítás jobb oldalán (r-érték) vagy bal oldalán (l-érték) használható. A második tömbökhöz const hívható meg, csak a jobb oldalon használható.

A kódtár hibakeresési verziója azt állítja, hogy az alsó index (a hozzárendelési utasítás bal vagy jobb oldalán) kívül esik-e a korlátokon.

CTypedPtrArray::SetAt

Ez a tagfüggvény meghívja BASE_CLASSa következőt: :SetAt.

void SetAt(
    INT_PTR nIndex,
    TYPE ptr);

Paraméterek

nIndex
A CObArray::GetUpperBound által visszaadott értéknél nagyobb vagy egyenlő egész számindex, amely 0-nál nagyobb vagy egyenlő.

TÍPUS
Az alaposztály tömbjében tárolt elemek típusa.

ptr
Mutató az nIndex tömbbe beszúrandó elemére. NULL érték engedélyezett.

Megjegyzések

Részletesebb megjegyzésekért lásd: CObArray::SetAt.

CTypedPtrArray::SetAtGrow

Ez a tagfüggvény a következőt hívja BASE_CLASS: :SetAtGrow.

void SetAtGrow(
    INT_PTR nIndex,
    TYPE newElement);

Paraméterek

nIndex
0-nál nagyobb vagy egyenlő egész számindex.

TÍPUS
Az alaposztály tömbjében tárolt elemek típusa.

newElement
A tömbhöz hozzáadandó objektummutató. NULL érték engedélyezett.

Megjegyzések

További részletekért lásd: CObArray::SetAtGrow.

Lásd még

MFC-minta COLLECT
hierarchiadiagram
CPtrArray osztály
CObArray osztály