CAtlArray::RemoveAt

  • 發行項

呼叫這個方法會從陣列中移除一或多個項目。

void RemoveAt(
   size_t iElement,
   size_t nCount = 1 
);

參數

  • iElement
    要移除之第一個項目的索引。

  • nCount
    要移除的元素數目。

備註

從陣列中移除一或多個項目。其餘項目向下移動。這個上限會遞減，不過，記憶體不會釋放，直到 CAtlArray::FreeExtra 呼叫一次。

在偵錯組建中， ATLASSERT 時會引發事件，如果 CAtlArray 物件無效，或者，如果合併的總數 iElement 和 nCount 超過項目總數的陣列中的。在零售版本時，無效的參數可能會導致無法預期的結果。

範例

// 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);

需求

Header: atlcoll.h

請參閱

參考

CAtlArray 類別

CAtlArray::RemoveAll