Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

◄CObArray►                                    ◄Up► ◄Contents► ◄Index► ◄Back►
──Microsoft Foundation Classes──────────────────────────────────────────────
 
  void RemoveAt( int nIndex, int nCount = 1 );
 
  Parameter   Description
 
  <nIndex>    An integer index that is greater than or equal to 0 and less
              than or equal to GetUpperBound().
 
  <nCount>    The number of elements to remove.
 
  Remarks
 
  Removes one or more elements starting at a specified index in an array.
  In the process, it shifts down all the elements above the removed
  element(s). It decrements the upper bound of the array but does not free
  memory.
 
  If you try to remove more elements than are contained in the array above
  the removal point, then the Debug version of the library asserts.
 
  The RemoveAt function removes the CObject pointer from the array, but it
  does not delete the object itself.
 
  Example
 
  CObArray array;
  CObject* pa;
 
  array.Add( new CAge( 21 ) ); // Element 0
  array.Add( new CAge( 40 ) ); // Element 1
  if( ( pa = array.GetAt( 0 ) ) != NULL )
  {
      array.RemoveAt( 0 );  // Element 1 moves to 0
      delete pa; // Delete the original element at 0
  }
 
  The results from this program are as follows:
 
  RemoveAt example: A CObArray with 1 elements
      [0] = a CAge at $4606 40
 
  See Also
 
  ◄CObArray::SetAt►, ◄CObArray::SetAtGrow►, ◄CObArray::InsertAt►
 
 
                                     -♦-