Share via

CObArray::GetAt

  • Article

CObject*GetAt(intnIndex**)const;**

Return Value

The CObject pointer element currently at this index.

Parameters

nIndex

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

Remarks

Returns the array element at the specified index.

Note   Passing a negative value or a value greater than the value returned by GetUpperBound will result in a failed assertion.

The following table shows other member functions that are similar to CObArray::GetAt.

Class Member Function
CByteArray BYTE GetAt( int nIndex ) const;
CDWordArray DWORD GetAt( int nIndex ) const;
CPtrArray void* GetAt( int nIndex ) const;
CStringArray CString GetAt( int nIndex ) const;
CUIntArray UINT GetAt( int nIndex ) const;
CWordArray WORD GetAt( int nIndex ) const;

Example

See CObList::CObList for a listing of the CAge class used in all collection examples.

// example for CObArray::GetAt

CObArray array;

array.Add( new CAge( 21 ) ); // Element 0
array.Add( new CAge( 40 ) ); // Element 1
ASSERT( *(CAge*) array.GetAt( 0 ) == CAge( 21 ) );

CObArray Overview |  Class Members |  Hierarchy Chart

See Also   CObArray::SetAt, CObArray::operator []