{"id":1944,"date":"2014-10-29T00:12:18","date_gmt":"2014-10-28T22:12:18","guid":{"rendered":"http:\/\/mariusbancila.ro\/blog\/?p=1944"},"modified":"2018-01-02T23:50:02","modified_gmt":"2018-01-02T21:50:02","slug":"mfc-collection-utilities-library","status":"publish","type":"post","link":"https:\/\/mariusbancila.ro\/blog\/2014\/10\/29\/mfc-collection-utilities-library\/","title":{"rendered":"MFC Collection Utilities library"},"content":{"rendered":"
\nThis project has been moved to GitHub.<\/p>\n

New location: https:\/\/github.com\/mariusbancila\/mfccollectionutilities<\/a>\n<\/div>\n

C++11 has provided support for range-based for loops<\/a>. They allow iterating over the elements of a range without using an index.<\/p>\n

\r\nstd::vector<int> v = {1, 2, 3, 4, 5};\r\nfor(auto& e : v)\r\n  e *= 2;\r\n<\/pre>\n
However, if you try the following MFC code you get some errors because the compiler is looking for a begin()<\/tt> and end()<\/tt> function that provides access to the first and last element of the range:<\/p>\n
\r\nvoid func(CStringArray const & arr)\r\n{\r\n   for(auto const & str : arr)\r\n   {\r\n      \/\/ do something with str\r\n   }\r\n}<\/pre>\n
\n1>error C3312: no callable ‘begin’ function found for type ‘CStringArray’
\n1>error C3312: no callable ‘end’ function found for type ‘CStringArray’\n<\/p><\/blockquote>\n
MFC does not define such functions for its containers.<\/p>\n
Enter MFC Collection Utilities<\/h2>\n
Tom Kirby-Green<\/a> and I have developed a small open-source library that enables the use of all MFC collection types in range-based for loops. The library is called MFC Collection Utilities<\/strong> and is available on codeplex<\/a>.<\/p>\n
The library consists of a single header, called mfciterators.h<\/strong>, that you include in your MFC projects.<\/p>\n
\r\n#include \"mfciterators.h\"\r\n\r\nvoid func(CStringArray const & arr)\r\n{\r\n   for(auto const & str : arr)\r\n   {\r\n      \/\/ do something with str\r\n   }\r\n}<\/pre>\n
Compiler and collections support<\/h2>\n
The library works in Visual Studio 2012 (the first version of the C++ compiler that supports range-based for loops) or a newer version. <\/p>\n
The library enables all the MFC collections, both template and non-template, to be used in range-based for loops. This means arrays, lists and maps. For maps you get access to the content through a key-value pair that has two fields: key<\/strong> and value<\/strong>.<\/p>\n
Supported template collections
\n<\/p>\n\n\n\n\n\n
Arrays <\/th>\nLists <\/th>\nMaps <\/th>\n<\/tr>\n
CArray <\/td>\nCList <\/td>\nCMap <\/td>\n<\/tr>\n
CTypedPtrArray <\/td>\nCTypedPtrList <\/td>\nCTypedPtrMap <\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
\nSupported non-template collections<\/p>\n\n\n\n\n\n\n\n\n\n\n
Arrays <\/th>\nLists <\/th>\nMaps <\/th>\n<\/tr>\n
CObArray <\/td>\nCObList <\/td>\nCMapPtrToWord <\/td>\n<\/tr>\n
CByteArray <\/td>\nCPtrList <\/td>\nCMapPtrToPtr <\/td>\n<\/tr>\n
CDWordArray <\/td>\nCStringList <\/td>\nCMapStringToOb <\/td>\n<\/tr>\n
CPtrArray <\/td>\n<\/td>\nCMapStringToPtr <\/td>\n<\/tr>\n
CStringArray <\/td>\n<\/td>\nCMapStringToString <\/td>\n<\/tr>\n
CWordArray <\/td>\n<\/td>\nCMapWordToOb <\/td>\n<\/tr>\n
CUIntArray <\/td>\n<\/td>\nCMapWordToPtr <\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
<\/p>\n
Examples<\/h2>\n
CStringArray arr;\r\narr.Add(\"this\");\r\narr.Add(\"is\");\r\narr.Add(\"a\");\r\narr.Add(\"sample\");\r\n\r\nfor(auto & s : arr)\r\n{\r\n   s.MakeUpper();\r\n}<\/pre>\n
class CFoo\r\n{\r\npublic:\r\n   int value;\r\n\r\n   CFoo(int const v): value(v) {}\r\n};\r\n\r\nCTypedPtrList<CPtrList, CBar*> ptrlist;\r\nptrlist.AddTail(new CFoo(1));\r\nptrlist.AddTail(new CFoo(2));\r\nptrlist.AddTail(new CFoo(3));\r\n\r\nfor(auto & o : ptrlist)\r\n   o->value *= 2;<\/pre>\n
CMap<int, int, CString, CString> map;\r\n\r\nmap.SetAt(1, \"one\");\r\nmap.SetAt(2, \"two\");\r\nmap.SetAt(3, \"three\");\r\n\r\nfor(auto & kvp : map)\r\n{\r\n   kvp.value.MakeUpper();\r\n}\r\n\r\nfor(auto const & kvp : map)\r\n{\r\n   CString temp;\r\n   temp.Format(\"key=%d, value=%s\", kvp.key, kvp.value);\r\n}<\/pre>\n
Download<\/h2>\n
Version 1.0 can be downloaded from codeplex from here<\/a>.<\/p>\n
For simpler installation you can use the available nuget package<\/a>.<\/p>\n
\"mfccollectionutilitiesnuget\"<\/a><\/p>\n
Let us know<\/a> if you encounter any issues.<\/p>\n","protected":false},"excerpt":{"rendered":"
This project has been moved to GitHub. New location: https:\/\/github.com\/mariusbancila\/mfccollectionutilities C++11 has provided support for range-based for loops. They allow iterating over the elements of a range without using an index. std::vector<int> v = {1, 2, 3, 4, 5}; for(auto& e : v) e *= 2; However, if you try the following MFC code you … Read more<\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_uag_custom_page_level_css":"","advgb_blocks_editor_width":"","advgb_blocks_columns_visual_guide":"","_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_feature_clip_id":0,"_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_publicize_message":"","jetpack_publicize_feature_enabled":true,"jetpack_social_post_already_shared":true,"jetpack_social_options":{"image_generator_settings":{"template":"highway","default_image_id":0,"font":"","enabled":false},"version":2},"jetpack_post_was_ever_published":false},"categories":[7,12,10],"tags":[451,345,383,431,430,453,384,432],"class_list":["post-1944","post","type-post","status-publish","format-standard","hentry","category-c","category-mfc","category-visual-studio","tag-c","tag-c11","tag-codeplex","tag-collections","tag-iterators","tag-mfc","tag-open-source","tag-utilities"],"aioseo_notices":[],"aioseo_head":"\n\t\t\n\t\n\t\n\t\n\t\n\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t