Enhanced collection template classes: CArrayEx, CMapEx and CSortedArray

Environment: WinNT, VC 6.0

This article describes three enhanced collection template classes, CArrayEx, CMapEx and CSortedArrayCArrayEx and CMapEx each provide an assignment operator and class copy constructor that allow us to easily craft two dimensional arrays and mappings.  In addition, CMapEx provides the ability to map CStrings, by providing a template hash function.  CSortedArray is a dynamic array template class that provides "sort after insertion" functionality.

Motivation for CArrayEx, CMapEx

Many of us have tried to create a 2 dimensional array using MFC's standard CArray class, only to encounter the following error:
error C2582: 'operator =' function is unavailable

Example 1:

  typedef CArray <int,int> CIntArray;
  CArray<CIntArray, CIntArray &> a2D;
  CIntArray aInt;

  a2D.Add (aInt);   // error C2582 ****

Example 2:

  typedef CMap<int,int,int,int> CIntMap;
  CMap<int,int,CIntMap,CIntMap &> m2D;
  CIntMap mInt;

  m2D.SetAt (1, mInt);   // error C2582 ****

The error occurs because CArray doesn't have copy a constructor and an assignment operator.  The need for these is obvious.  If we create array of pointers [CArray<void,void>], we need to copy not only the pointer, but also the values.  Microsoft refers us to their knowledge base articles "Collection Class Helpers" and "Collections: How to Make a Type-Safe Collection" for more information.

The problem is solved using CArrayEx:

  typedef CArrayEx<int,int> CIntArray;
  CArrayEx<CIntArray, CIntArray &> a2D;
  CIntArray aInt;

  a2D.Add (aInt);    // OK

and by using CMapEx:

  typedef CMapEx<int,int,int,int> CIntMap;
  CMapEx<int,int,CIntMap,CIntMap &> m2D;
  CIntMap mInt;

  m2D.SetAt (1, mInt);    // OK

Another motivation for CMapEx

If you've tried to create a mapping (using CMap) with a CString key, you'd have encountered the following error:

  CMap<CString,CString,int,int> a;
  a.SetAt (CString("a"), 1);
  // error: cannot convert from 'class CString' to 'unsigned long'

This happens because there's no function to hash a CString to an unsigned long.  CMapEx addresses this problem by providing a HashKey() function.

  template<> inline UINT AFXAPI HashKey<CString> (CString strKey)
  {
    LPCSTR key = strKey;
    UINT nHash = 0;
    while (*key)
          nHash = (nHash<<5) + nHash + *key++;
    return nHash;
  }

Motivation for CSortedArray

CSortedArray allows you to easily find data (by doing a binary search) because it maintains itself in sorted order.

Downloads

Download demo project - 17 Kb


Comments

Leave a Comment
  • Your email address will not be published. All fields are required.

Top White Papers and Webcasts

  • Featuring Kate Leggett, VP and Principal Analyst, Forrester Research Live Event Date: October 19, 2016 @ 10 AM PT / 1 PM ET Omnichannel self-service is the new paradigm. Firms are organizing to provide self-service options across all channels in order to meet customer needs and expectations—going beyond traditional IVR. Are you prepared to offer your customers personalized self-service across all channels including legacy applications like your IVR?

  • If you're like most businesses, you probably assume that for faxing must involve the ineffective and costly environment of clunky hardware and costly phone lines. But you'd be wrong. Cloud-based, paperless hosted faxing service require no onsite hardware, are as easy to use as email, reduces costs, and enhances the security and regulatory compliance of your business faxes. Read this white paper for learn ten benefits a business like yours will enjoy when you switch from your existing analog fax infrastructure …

Most Popular Programming Stories

More for Developers

RSS Feeds

Thanks for your registration, follow us on our social networks to keep up-to-date