Export (0) Print
Expand All

CTypedPtrArray Class

Provides a type-safe "wrapper" for objects of class CPtrArray or CObArray.

template< class BASE_CLASS, class TYPE >
class CTypedPtrArray : public BASE_CLASS

BASE_CLASS

Base class of the typed pointer array class; must be an array class (CObArray or CPtrArray).

TYPE

Type of the elements stored in the base-class array.

Name

Description

CTypedPtrArray::Add

Adds a new element to the end of an array. Grows the array if necessary

CTypedPtrArray::Append

Adds the contents of one array to the end of another. Grows the array if necessary

CTypedPtrArray::Copy

Copies another array to the array; grows the array if necessary.

CTypedPtrArray::ElementAt

Returns a temporary reference to the element pointer within the array.

CTypedPtrArray::GetAt

Returns the value at a given index.

CTypedPtrArray::InsertAt

Inserts an element (or all the elements in another array) at a specified index.

CTypedPtrArray::SetAt

Sets the value for a given index; array not allowed to grow.

CTypedPtrArray::SetAtGrow

Sets the value for a given index; grows the array if necessary.

Name

Description

CTypedPtrArray::operator [ ]

Sets or gets the element at the specified index.

When you use CTypedPtrArray rather than CPtrArray or CObArray, the C++ type-checking facility helps eliminate errors caused by mismatched pointer types.

In addition, the CTypedPtrArray wrapper performs much of the casting that would be required if you used CObArray or CPtrArray.

Because all CTypedPtrArray functions are inline, use of this template does not significantly affect the size or speed of your code.

For more information on using CTypedPtrArray, see the articles Collections and Template-Based Classes.

BASE_CLASS

CTypedPtrArray

Header: afxtempl.h

Show:
© 2014 Microsoft