CTypedPtrArray Class

 

The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.

The latest version of this topic can be found at CTypedPtrArray Class.

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

Syntax

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

Parameters

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.

Members

Public Methods

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.

Public Operators

Name Description
CTypedPtrArray::operator [ ] Sets or gets the element at the specified index.

Remarks

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.

Inheritance Hierarchy

BASE_CLASS

CTypedPtrArray

Requirements

Header: afxtempl.h

CTypedPtrArray::Add

This member function calls BASE_CLASS::Add.

INT_PTR Add(TYPE newElement);

Parameters

TYPE
Template parameter specifying the type of element to be added to the array.

newElement
The element to be added to this array.

Return Value

The index of the added element.

Remarks

For more detailed remarks, see CObArray::Add.

CTypedPtrArray::Append

This member function calls BASE_CLASS::Append.

INT_PTR Append(const CTypedPtrArray<BASE_CLASS, TYPE>& src);

Parameters

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.

src
Source of the elements to be appended to an array.

Return Value

The index of the first appended element.

Remarks

For more detailed remarks, see CObArray::Append.

CTypedPtrArray::Copy

This member function calls BASE_CLASS::Copy.

void Copy(const CTypedPtrArray<BASE_CLASS, TYPE>& src);

Parameters

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.

src
Source of the elements to be copied to an array.

Remarks

For more detailed remarks, see CObArray::Copy.

CTypedPtrArray::ElementAt

This inline function calls BASE_CLASS::ElementAt.

TYPE& ElementAt(INT_PTR nIndex);

Parameters

TYPE
Template parameter specifying the type of elements stored in this array.

nIndex
An integer index that is greater than or equal to 0 and less than or equal to the value returned by BASE_CLASS::GetUpperBound.

Return Value

A temporary reference to the element at the location specified by nIndex. This element is of the type specified by the template parameter TYPE.

Remarks

For more detailed remarks, see CObArray::ElementAt.

CTypedPtrArray::GetAt

This inline function calls BASE_CLASS::GetAt.

TYPE GetAt(INT_PTR nIndex) const;  

Parameters

TYPE
Template parameter specifying the type of elements stored in the array.

nIndex
An integer index that is greater than or equal to 0 and less than or equal to the value returned by BASE_CLASS::GetUpperBound.

Return Value

A copy of the element at the location specified by nIndex. This element is of the type specified by the template parameter TYPE.

Remarks

For more detailed remarks, see CObArray::GetAt

CTypedPtrArray::InsertAt

This member function calls BASE_CLASS::InsertAt.

void InsertAt(
    INT_PTR nIndex,  
    TYPE newElement,  
    INT_PTR nCount = 1);

 
void InsertAt(
    INT_PTR nStartIndex,  
    CTypedPtrArray<BASE_CLASS, TYPE>* pNewArray);

Parameters

nIndex
An integer index that may be greater than the value returned by CObArray::GetUpperBound.

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

newElement
The object pointer to be placed in this array. A newElement of value NULL is allowed.

nCount
The number of times this element should be inserted (defaults to 1).

nStartIndex
An integer index that may be greater than the value returned by CObArray::GetUpperBound.

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

pNewArray
Another array that contains elements to be added to this array.

Remarks

For more detailed remarks, see CObArray::InsertAt.

CTypedPtrArray::operator [ ]

These inline operators call BASE_CLASS::operator [ ].

TYPE& operator[](INT_PTR nIndex);

 
TYPE operator[](INT_PTR nIndex) const;

 

Parameters

TYPE
Template parameter specifying the type of elements stored in the array.

nIndex
An integer index that is greater than or equal to 0 and less than or equal to the value returned by BASE_CLASS::GetUpperBound.

Remarks

The first operator, called for arrays that are not const, can be used on either the right (r-value) or the left (l-value) of an assignment statement. The second, invoked for const arrays, can be used only on the right.

The Debug version of the library asserts if the subscript (either on the left or right side of an assignment statement) is out of bounds.

CTypedPtrArray::SetAt

This member function calls BASE_CLASS::SetAt.

void SetAt(
    INT_PTR nIndex,  
    TYPE ptr);

Parameters

nIndex
An integer index that is greater than or equal to 0 and less than or equal to the value returned by CObArray::GetUpperBound.

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

ptr
A pointer to the element to be inserted in the array at the nIndex. A NULL value is allowed.

Remarks

For more detailed remarks, see CObArray::SetAt.

CTypedPtrArray::SetAtGrow

This member function calls BASE_CLASS::SetAtGrow.

void SetAtGrow(
    INT_PTR nIndex,  
    TYPE newElement);

Parameters

nIndex
An integer index that is greater than or equal to 0.

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

newElement
The object pointer to be added to this array. A NULL value is allowed.

Remarks

For more detailed remarks, see CObArray::SetAtGrow.

See Also

MFC Sample COLLECT
Hierarchy Chart
CPtrArray Class
CObArray Class