CObArray::SetSize

Artikel
02/26/2013

Richtet die Größe eines leeren oder vorhandenen Arrays ein; ggf. Speicher belegt.

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

Parameter

nNewSize
Die neue Arraygröße Zahl (- Elemente).Muss mindestens 0 sein.
nGrowBy
Die Mindestanzahl von den Elementslots, zuzuordnen, wenn eine Größenzunahme erforderlich ist.

Hinweise

Wenn die neue Größe kleiner als die alte Größe ist, wird das Array abgeschnitten und aller nicht verwendete Arbeitsspeicher freigegeben wird.Vor Verwendung es Effizienzgründen rufen Sie SetSize auf, um die Größe des Arrays festzulegen.Dies verhindert die Anforderung, das Array neu belegen und zu kopieren, wenn ein Element hinzugefügt wird.

Der nGrowBy-Parameter beeinflusst Zuordnung des internen Speicher, während das Array zu ist.Die Verwendung beeinflusst nie die Arraygröße, wie durch GetSize und GetUpperBound gemeldet.

Wenn die Größe des Arrays gewachsen ist, werden alle neu reserviertes CObject * Zeiger festgelegt, um auf NULL.

In der folgenden Tabelle werden andere Memberfunktionen auf, die mit CObArray::SetSize ähneln.

Klasse	Memberfunktion
CByteArray	void SetSize( INT_PTR nNewSize, int nGrowBy = -1 ); *Throw (CMemoryException);**
CDWordArray	void SetSize( INT_PTR nNewSize, int nGrowBy = -1 ); *Throw (CMemoryException);**
CPtrArray	void SetSize( INT_PTR nNewSize, int nGrowBy = -1 ); *Throw (CMemoryException);**
CStringArray	void SetSize( INT_PTR nNewSize, int nGrowBy = -1 ); *Throw (CMemoryException);**
CUIntArray	void SetSize( INT_PTR nNewSize, int nGrowBy = -1 ); *Throw (CMemoryException);**
CWordArray	void SetSize( INT_PTR nNewSize, int nGrowBy = -1 ); *Throw (CMemoryException);**

Beispiel

Im Beispiel für CObArray::GetData.

Anforderungen

Header: afxcoll.h

Siehe auch

Referenz

CObArray-Klasse

Hierarchien-Diagramm

Freigeben über