CObArray::SetSize

Článek
03/04/2013

Zjistí velikost existující nebo prázdné pole; v případě potřeby přidělí paměť.

void SetSize(
   INT_PTR nNewSize,
   INT_PTR nGrowBy = -1 
);

Parametry

nNewSize
Nové pole velikost (počet prvků).Musí být větší nebo rovna 0.
nGrowBy
Minimální počet slotů prvek přidělení, pokud je nezbytné zvýšení velikosti.

Poznámky

Pokud je nová velikost menší než původní velikost, pole je oříznuto a všechny nevyužité paměti je uvolněna.Účinnost, volání SetSize nastavit velikost pole před jeho použitím.Tím nutnost přerozdělit a kopírovat pole pokaždé, když byla položka přidána.

nGrowBy Parametr ovlivňuje přidělení vnitřní paměti, zatímco pole roste.Jeho použití nikdy ovlivňuje velikost pole v GetSize a GetUpperBound .

Pokud velikost pole vzrostla, všechny nově přiděleno CObject * ukazatele jsou nastaveny na hodnotu NULL.

Následující tabulka obsahuje další členské funkce, které jsou podobné CObArray::SetSize .

Třída	Členská funkce
CByteArray	void SetSize( INT_PTR nNewSize, int nGrowBy = -1 ); vyvoláním CMemoryException ;**
CDWordArray	void SetSize( INT_PTR nNewSize, int nGrowBy = -1 ); vyvoláním CMemoryException ;**
CPtrArray	void SetSize( INT_PTR nNewSize, int nGrowBy = -1 ); vyvoláním CMemoryException ;**
CStringArray	void SetSize( INT_PTR nNewSize, int nGrowBy = -1 ); vyvoláním CMemoryException ;**
CUIntArray	void SetSize( INT_PTR nNewSize, int nGrowBy = -1 ); vyvoláním CMemoryException ;**
CWordArray	void SetSize( INT_PTR nNewSize, int nGrowBy = -1 ); vyvoláním CMemoryException ;**