Const Versus Non-Const CObList Objects

MS-DOS | WINDOWS             | WINDOWS NT

• The Microsoft Foundation Classes (MFC) included with:

      - Microsoft C/C++ version 7.0
      - Microsoft Visual C++ for Windows, versions 1.0, 1.5, 1.51, and 1.52
      - Microsoft Visual C++ 32-bit Edition, versions 1.0, 2.0, 2.1, and 4.0
  

SUMMARY

When you write an application with the CObList class provided by the Microsoft Foundation Class (MFC) libraries, you may note that many of the member functions have both const and non-const forms. For example, the CObList class has two GetNext() member functions, as follows:

   CObject * & GetNext(POSITION & rPosition);
   CObject *   GetNext(POSITION & rPosition) const;

Note that the first member function returns a reference to a CObject pointer. The item returned is the actual CObject pointer in the list, not its value. Through this reference, you can modify the CObject pointer and use the return value of the member function to modify the list. The second member function does not provide access to modify the CObList.

MORE INFORMATION

The code sample below demonstrates using the GetNext() member function that returns a reference to a CObject pointer. Note the comment in the code. If you remove the comment from the indicated line, an error results.

Sample Code

// Sample program to create a CObList, fill it, display the "set"
// member of each CObject pointed to by the CObList, reassign the
// elements of the CObList, and display the "set" member of each
// CObject pointed to by the CObList a second time.

/*
 * Compiler options needed: Visual C++ 4.0 - /MT[d] or /MD[d]
 *                          Others - None
 */

#define _DOS
#include <iostream.h>
#include <afx.h>
#include <afxcoll.h>

   CMyObject(int i):set(i) { }
   int set;

                // assign set = 2

void main(void)

   CObList * pMyList = new CObList;
   const CObList * pMyListAlso = pMyList;

   // load list
   for (int nCount = 0; nCount < 10; nCount++)
      pMyList->AddHead(new CMyObject(1));   // Fill up list with
                   // CMyObject objects that have set equal to 1

   for (POSITION p = pMyList->GetHeadPosition(); p != NULL; )
      cout << ((CMyObject*)pMyList->GetNext(p))->set;

   for (p = pMyList->GetHeadPosition(); p != NULL; )
      (pMyList->GetNext(p)) = &MyObject;

// If you remove the comments from the following lines, the compiler
// generates the following error:
//
//    error C2106: '=' : left operand must be lvalue
//
// The error occurs because pMyListAlso is a pointer to a const
// CObList object and the GetNext() member function that returns a
// CObject pointer is called.
//
// for (p = pMyList->GetHeadPosition(); p != NULL; )
//    (pMyListAlso->GetNext(p)) = &MyObject;

   for (p = pMyList->GetHeadPosition(); p != NULL; )
      cout << ((CMyObject*)pMyList->GetNext(p))->set;