CMapEx v1.06

CMapEx is a class derived from the MFC template class "CMap". It is designed to allow the "CompareElements" method which CMap uses at runtime, to be specified via a template parameter rather than via a global function. This approach is much more flexible and allows the way data is stored in the map to be configured at an instance level, rather than the annoying limitation in CMap which due to its design only allows you to control this globally i.e. if you have multiple map instances which happen to store the same types of data, then all of these instances must use the same "CompareElements" method. This is quite a limitation which I have just recently encountered in one of my projects. Finally, please note that there is a std::map class in the C++ runtime which is much more fully featured than the MFC CMap class and you should aim to use this in preference to CMap/CMapEx in all your Visual C++ development work.

Usage

• To use CMapEx in your code simply include "MapEx.h" in your project and #include it in which ever modules you want to instantiate it in.
• Since it is designed to enhance CMap, you will need to include MFC in your project and reference "afxtempl.h".
• The code is designed for VC 2017 or later. They will not compile on earlier releases of VC.

Copyright

• You are allowed to include the source code in any product (commercial, shareware, freeware or otherwise) when your product is released in binary form.
• You are allowed to modify the source code in any way you want except you cannot modify the copyright details at the top of each module.
• If you want to distribute source code with your application, then you are only allowed to distribute versions released by the author. This is to maintain a single distribution point for the source code.

History

v1.06 (8 April 2022)

• Updated copyright details.
• Updated the code to use C++ uniform initialization for all variable declarations.

v1.05 (3 May 2020)

• Fixed more Clang-Tidy static code analysis warnings in the code.

v1.04 (12 March 2020)

• Updated copyright details.
• Fixed more Clang-Tidy static code analysis warnings in the code.

v1.03 (26 December 2018)

• Updated copyright details.
• Fixed a number of C++ core guidelines compiler warnings. These changes mean that the code will now only compile on VC 2017 or later.

v1.02 (29 April 2017)

• Updated copyright details.
• Updated the code to compile cleanly using /permissive-.

v1.01 (21 February 2016)

• Updated copyright details.
• Updated the code to clean compile on VC 2010 - VC 2015

v1.0 (11 June 2009)

• Initial Public Release.

API Reference

As the class is designed to be a direct replacement for CMap, it provides no new functionality compared to CMap. Please see the CMap documentation for full details on using it. Bear in mind that due to how CMap is itself implemented, CMapEx must re-implement some of CMap's functionality and in the process intentionally hide the CMap base implementation.

Contacting the Author

PJ Naughter
Email: pjna@naughter.com
Web: http://www.naughter.com
8 April 2022