CObArray::operator

These subscript operators are a convenient substitute for the SetAt and GetAt functions.

CObject*& operator []( 
   INT_PTR nIndex  
); 
CObject* operator []( 
   INT_PTR nIndex  
) const;

Remarks

The first operator, called for arrays that are not const, may be used on either the right (r-value) or the left (l-value) of an assignment statement. The second, called for const arrays, may 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.

The following table shows other operators that are similar to CObArray::operator [].

Class

Operator

CByteArray

BYTE& operator []( INT_PTRnIndex );

BYTE operator []( INT_PTR nIndex ) const;

CDWordArray

DWORD& operator []( INT_PTR nIndex );

DWORD operator []( INT_PTR nIndex ) const;

CPtrArray

void*& operator []( INT_PTR nIndex );

void* operator []( INT_PTR nIndex ) const;

CStringArray

CString& operator []( INT_PTR nIndex );

CString operator []( INT_PTR nIndex ) const;

CUIntArray

UINT& operator []( INT_PTR nIndex );

UINT operator []( INT_PTR nIndex ) const;

CWordArray

WORD& operator []( INT_PTR nIndex );

WORD operator []( INT_PTR nIndex ) const;

Example

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

CObArray arr;
CAge* pa;

arr.Add(new CAge(21)); // Element 0
arr.Add(new CAge(40)); // Element 1
pa = (CAge*)arr[0]; // Get element 0
ASSERT(*pa == CAge(21)); // Get element 0
arr[0] = new CAge(30); // Replace element 0 
delete pa;
ASSERT(*(CAge*) arr[0] == CAge(30)); // Get new element 0      

Requirements

Header: afxcoll.h

See Also

Reference

CObArray Class

Hierarchy Chart

CObArray::GetAt

CObArray::SetAt