CObArray::SetAt

Artikel
02/26/2013

Legt das Arrayelement am angegebenen Index fest.

void SetAt(
   INT_PTR nIndex,
   CObject* newElement 
);

Parameter

nIndex
Ein ganzzahlige Index, der größer oder gleich 0 und kleiner oder gleich dem Wert, der von GetUpperBound zurückgegeben wird.
newElement
Der in diesem Array eingefügt werden Objektzeiger.Ein NULL-Wert zulässig.

Hinweise

SetAt bewirkt das Array nicht vergrößert.Verwenden Sie SetAtGrow, wenn Sie das Array automatisch wachsen soll.

Sie müssen sicherstellen, dass der Indexwert eine gültige Position im Array darstellt.Wenn er aus Grenzen liegt, dann die Debugversion der Bibliotheksassertionen.

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

Klasse	Memberfunktion
CByteArray	void SetAt( INT_PTRnIndex, BYTE newElement);
CDWordArray	void SetAt( INT_PTRnIndex, DWORD newElement);
CPtrArray	void SetAt( INT_PTRnIndex, void* newElement);
CStringArray	void SetAt( INT_PTRnIndex, LPCTSTR newElement);
CUIntArray	void SetAt( INT_PTRnIndex, UINT newElement);
CWordArray	void SetAt( INT_PTRnIndex, WORD newElement);

Beispiel

Siehe CObList::CObList für Listen der CAge-Klasse, die in allen Auflistungsbeispielen verwendet wird.

CObArray arr;
CObject* pa;

arr.Add(new CAge(21)); // Element 0
arr.Add(new CAge(40)); // Element 1
if ((pa = arr.GetAt(0)) != NULL)
{
   arr.SetAt(0, new CAge(30));  // Replace element 0.
   delete pa; // Delete the original element at 0.
}
#ifdef _DEBUG
   afxDump.SetDepth(1);
   afxDump << _T("SetAt example: ") << &arr << _T("\n");
#endif

Die Ergebnisse dieses Programms sind, wie folgt:

SetAt example: A CObArray with 2 elements

[0] = a CAge at $47E0 30

[1] = a CAge at $47A0 40