- \n
- %VSINSTALLDIR%\\Common7\\Packages\\Debugger\\Visualizers (requires admin access)<\/li>\n
- %USERPROFILE%\\My Documents\\Visual Studio 2012\\Visualizers\\<\/li>\n
- VS extension folders<\/li>\n<\/ul>\n
You can read how to write visualizers in these articles:<\/p>\n
- \n
- Creating custom views of native objects in the debugger<\/a><\/li>\n
- Writing debugger type visualizers for C++ using .natvis files<\/a><\/li>\n<\/ul>\n
Writing the visualizer<\/h3>\n
There are two things you must do to enable Visual Studio debugger to display CPtrArray<\/tt>s in a nice way.<\/p>\n
The first step is to define a type derived from CPtrArray<\/tt>. This type will not be used in code, but will allow the visualizer to figure what is the type of the array elements.<\/p>\n
\r\ntemplate <typename T>\r\nclass CPtrArrayT : public CPtrArray\r\n{\r\n};\r\n<\/pre>\nThe second step is to create a .natvis file (let’s call it mfc.natvis<\/strong>) under %USERPROFILE%\\My Documents\\Visual Studio 2012\\Visualizers\\<\/strong> with the following content:<\/p>\n
\r\n<?xml version=\"1.0\" encoding=\"utf-8\"?>\r\n<AutoVisualizer xmlns=\"http:\/\/schemas.microsoft.com\/vstudio\/debugger\/natvis\/2010\">\r\n \r\n <Type Name=\"CPtrArrayT<*>\">\r\n <DisplayString>{{CPtrArray m_nSize={m_nSize}}}<\/DisplayString> \r\n <Expand>\r\n <Item Name=\"m_nSize\">m_nSize<\/Item>\r\n <Item Name=\"m_nMaxSize\">m_nMaxSize<\/Item>\r\n <Item Name=\"m_nGrowBy\">m_nGrowBy<\/Item>\r\n <IndexListItems>\r\n <Size>m_nSize<\/Size>\r\n <ValueNode>($T1*)m_pData[$i]<\/ValueNode>\r\n <\/IndexListItems>\r\n <\/Expand> \r\n <\/Type>\r\n \r\n<\/AutoVisualizer>\r\n<\/pre>\nAnd that’s all. Let’s see how this works. Assume we have the following code:<\/p>\n
\r\nstruct FOO\r\n{\r\n int a;\r\n double b;\r\n CString c;\r\n};\r\n\r\nvoid TestArray()\r\n{\r\n CPtrArray arr;\r\n\r\n FOO* f1 = new FOO;\r\n f1->a = 1;\r\n f1->b = 1.1;\r\n f1->c = \"one\";\r\n\r\n FOO* f2 = new FOO;\r\n f2->a = 2;\r\n f2->b = 2.2;\r\n f2->c = \"two\";\r\n\r\n FOO* f3 = new FOO;\r\n f3->a = 3;\r\n f3->b = 3.3;\r\n f3->c = \"three\";\r\n\r\n arr.Add(f1);\r\n arr.Add(f2);\r\n arr.Add(f3);\r\n\r\n delete f1;\r\n delete f2;\r\n delete f3;\r\n}\r\n<\/pre>\nIn the Watch window cast the pointer to the array object to CPtrArray<T><\/tt>. This is where the template type defined above is used. Even though your array is not an instance of CPtrArray<T><\/tt> it will still work since the derived type does not add anything.<\/p>\n
(CPtrArrayT<FOO>*)&arr,nd<\/pre>\n
![\"vscptrarrayvis1\"](\"http:\/\/mariusbancila.ro\/blog\/wp-content\/uploads\/2013\/07\/vscptrarrayvis1.png\")
<\/a>
\nAs you can see in the screenshot, the content of the CPtrArray<\/tt> is nicely expanded. <\/p>\nYou probably noticed the nd<\/strong> specifier in the watch expression. This specifier (probably standing for “no derived”) displays only the base class info of the object, and not the derived parts (see Format Specifiers in C++<\/a>). Without this specifier, when the MFC symbols are loaded (for mfc110xx.dll) the array is not visualized correctly.
\n![\"vscptrarrayvis2\"](\"http:\/\/mariusbancila.ro\/blog\/wp-content\/uploads\/2013\/07\/vscptrarrayvis2.png\")
<\/a><\/p>\nA simpler hard-coded solution<\/h3>\n
If you don’t want (or cannot) add the generic type CPtrArray<T><\/tt> you can still accomplish the same, but with some drawbacks.<\/p>\n
In this case the .natvis file should look like this:<\/p>\n
\r\n<?xml version=\"1.0\" encoding=\"utf-8\"?>\r\n<AutoVisualizer xmlns=\"http:\/\/schemas.microsoft.com\/vstudio\/debugger\/natvis\/2010\">\r\n \r\n <Type Name=\"CPtrArray\">\r\n <DisplayString>{{CPtrArray m_nSize={m_nSize}}}<\/DisplayString> \r\n <Expand>\r\n <Item Name=\"m_nSize\">m_nSize<\/Item>\r\n <Item Name=\"m_nMaxSize\">m_nMaxSize<\/Item>\r\n <Item Name=\"m_nGrowBy\">m_nGrowBy<\/Item>\r\n <IndexListItems>\r\n <Size>m_nSize<\/Size>\r\n <ValueNode>(TYPE*)m_pData[$i]<\/ValueNode>\r\n <\/IndexListItems>\r\n <\/Expand> \r\n <\/Type>\r\n \r\n<\/AutoVisualizer>\r\n<\/pre>\nYou must change the placeholder TYPE<\/strong> with the actual type of the array elements in ValueNode<\/strong><\/em>. Then, all you have to do is add the object in the watch window.<\/p>\n
However, the big disadvantage of this solution is that all the CPtrArray<\/tt>s in your code are treated in the same manner, as storing elements of type TYPE*. That means if you want to watch arrays of different types, you have to stop the debugger, change the visualizer and attach again. It is impossible to watch arrays that store different element types in the same debugging session.<\/p>\n","protected":false},"excerpt":{"rendered":"
CPtrArray is a nasty MFC container that should not be used. However, if you deal with legacy code you may not have a choice and have to work with it. Unfortunately, the Visual Studio debugger is not able to display its elements, since these are pointers to void and that can be anything. In this … 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,52,10],"tags":[366,35,453,365,55,317],"class_list":["post-1567","post","type-post","status-publish","format-standard","hentry","category-c","category-mfc","category-tools","category-visual-studio","tag-cptrarray","tag-debugger","tag-mfc","tag-visualizers","tag-visualstudio","tag-vs2012"],"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
- Writing debugger type visualizers for C++ using .natvis files<\/a><\/li>\n<\/ul>\n
- Creating custom views of native objects in the debugger<\/a><\/li>\n