CAtlArray::RemoveAt
Rufen Sie diese Methode auf, um eine oder mehrere Elemente aus dem Array zu entfernen.
void RemoveAt(
size_t iElement,
size_t nCount = 1
);
Parameter
iElement
Der Index des ersten zu entfernenden Elements.nCount
Die Anzahl der zu entfernenden Elemente.
Hinweise
Entfernt eine oder mehrere Elemente aus dem Array. Alle übrigen Elemente werden unten verschoben. Die Obergrenze wird verringert, aber Arbeitsspeicher wird erst freigegeben, wenn ein Aufruf CAtlArray::FreeExtra gemacht wird.
In Debugbuilds wird ein ATLASSERT ausgelöst, wenn das Objekt CAtlArray ungültig ist oder wenn die kombinierte Summe von iElement und von nCount die Gesamtzahl der Elemente im Array überschreitet. In den Verkaufsversionsbuildern verursachen ungültige Parameter möglicherweise unvorhersehbare Ergebnisse.
Beispiel
// Declare an array of chars
CAtlArray<char> cMyArray;
// Add ten elements to the array
for (int a = 0; a < 10; a++)
{
cMyArray.Add('*');
}
// Remove five elements starting with
// the element at position 1
cMyArray.RemoveAt(1, 5);
// Free memory
cMyArray.FreeExtra();
// Confirm size of array
ATLASSERT(cMyArray.GetCount() == 5);
Anforderungen
Header: atlcoll.h