Udostępnij za pośrednictwem

CObArray::SetSize

  • Artykuł

Określa rozmiar tablicy pusty lub istniejące; Jeśli to konieczne, przydziela pamięć.

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

Parametry

  • nNewSize
    Nowy rozmiar tablicy (liczba elementów).Musi być większa lub równa 0.

  • nGrowBy
    Minimalna liczba gniazd element przydzielić, jeśli konieczne jest zwiększenie rozmiaru.

Uwagi

Jeśli nowy rozmiar jest mniejszy niż rozmiar stare, tablica zostanie obcięta i wszystkie nieużywane pamięci jest zwolnione.Wydajność, call SetSize , aby ustawić rozmiar tablicy przed jej użyciem.Zapobiega to potrzebę ponownego przydzielenia i skopiować każdym dodany element tablicy.

nGrowBy Parametr ma wpływ alokacji pamięci wewnętrznej podczas rośnie tablicy.Jej użycia nigdy nie dotyczy rozmiaru tablicy zgłoszone przez GetSize i GetUpperBound.

Jeśli rozmiar tablicy wzrosła, wszystkie nowo przydzielone CObject * wskaźniki mają wartość NULL.

W poniższej tabeli przedstawiono funkcje, które są podobne do innego członka CObArray::SetSize.

Klasa

Funkcja Członkowskie

CByteArray

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

    rzut CMemoryException **;

CDWordArray

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

    rzut CMemoryException **;

CPtrArray

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

    rzut CMemoryException **;

CStringArray

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

    rzut CMemoryException **;

CUIntArray

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

    rzut CMemoryException **;

CWordArray

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

    rzut CMemoryException **;

Przykład

Zobacz przykład dla CObArray::GetData.

Wymagania

Nagłówek: afxcoll.h

Zobacz też

Informacje

Klasa CObArray

Wykres hierarchii