CAtlArray::Append
Rufen Sie diese Methode auf, um den Inhalt von einem Array Ende von anderen hinzuzufügen.
size_t Append(
const CAtlArray< E, ETraits >& aSrc
);
Parameter
- aSrc
Das Array anzufügen.
Rückgabewert
Gibt den Index des ersten Elements angefügten zurück.
Hinweise
Die Elemente im angegebenen Array werden am Ende des vorhandenen Arrays hinzugefügt. Falls notwendig wird Arbeitsspeicher zugeordnet, um die neuen Elemente größer.
Die Arrays müssen vom gleichen Typ sein, und es ist nicht möglich, ein Array zu sich anzufügen.
In Debugbuilds wird ein ATLASSERT ausgelöst, wenn das CAtlArray-Argument kein gültiges Array ist, oder wenn aSrc dasselbe Objekt verweist. In Releasebuilds ungültige Argumente führen möglicherweise zu unvorhersehbarem Verhalten führen.
Beispiel
// Declare two integer arrays
CAtlArray<int> iArray1,iArray2;
iArray1.Add(1); // element 0
iArray1.Add(2); // element 1
iArray2.Add(3); // element 0
iArray2.Add(4); // element 1
// Append iArray2 to iArray1
iArray1.Append(iArray2);
ATLASSERT(iArray1.GetCount() == 4);
Anforderungen
Header: atlcoll.h