{"id":1496,"date":"2016-03-07T12:23:19","date_gmt":"2016-03-07T20:23:19","guid":{"rendered":"http:\/\/visualgdb.com\/w\/?p=1496"},"modified":"2022-11-28T09:02:30","modified_gmt":"2022-11-28T17:02:30","slug":"visualizing-complex-data-structures-with-natvis-and-visualgdb","status":"publish","type":"post","link":"https:\/\/visualgdb.com\/tutorials\/custom\/natvis\/","title":{"rendered":"Visualizing complex data structures with Natvis and VisualGDB"},"content":{"rendered":"

This tutorial shows how to visualize complex data structures using the Microsoft Natvis files<\/a> and VisualGDB. Before you begin, install VisualGDB 5.1 or later.<\/p>\n

    \n
  1. Start Visual Studio and open any of the VisualGDB Project Wizards. In this example we will create a Linux project, however the same technique will also work for Embedded, Windows and Android projects.\"01-natvistest\"<\/a><\/li>\n
  2. As Natvis files do not require any special steps in the project wizard, you can simply proceed with the default ones. In this example we will create a basic Linux project: \"02-prjtype\"<\/a><\/li>\n
  3. If you are creating a Linux project, select your target computer and press “Next”. Otherwise, proceed with the default settings of the wizard you are using:\"03-computer\"<\/a><\/li>\n
  4. On the last page of the wizard press “Finish” to generate a basic project:\"04-fileloc\"<\/a><\/li>\n
  5. Press Ctrl-Shift-B to build it. Ensure that there are no build errors:\"05-build\"<\/a><\/li>\n
  6. Now we will add a very basic class template for linked lists. Simply replace the contents of your main file with the following:\n
    template <typename _Ty> class LinkedList\r\n{\r\npublic:\r\n\u00a0\u00a0 \u00a0struct Node\r\n\u00a0\u00a0 \u00a0{\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0_Ty Value;\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0Node *pNext;\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0Node(const _Ty &val, Node *next = NULL)\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0{\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0Value = val;\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0pNext = next;\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0}\r\n\u00a0\u00a0 \u00a0};\r\n\u00a0\u00a0 \u00a0\r\n\u00a0\u00a0 \u00a0void Add(const _Ty &value)\r\n\u00a0\u00a0 \u00a0{\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0Node *pNode = new Node(value);\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0if (!m_pFirst)\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0m_pFirst = pNode;\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0if (m_pLast)\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0m_pLast->pNext = pNode;\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0m_pLast = pNode;\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0m_Size++;\r\n\u00a0\u00a0 \u00a0}\r\n\u00a0\u00a0 \u00a0\r\n\u00a0\u00a0 \u00a0LinkedList()\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0: m_pFirst(NULL)\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0, m_pLast(NULL)\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0, m_Size(0)\r\n\u00a0\u00a0 \u00a0{\r\n\u00a0\u00a0 \u00a0}\r\n\u00a0\u00a0 \u00a0\r\n\u00a0\u00a0 \u00a0~LinkedList()\r\n\u00a0\u00a0 \u00a0{\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0for (Node *pNode = m_pFirst, *pNextNode; pNode; pNode = pNextNode)\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0{\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0pNextNode = pNode->pNext;\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0delete pNode;\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0}\r\n\u00a0\u00a0 \u00a0}\r\n\u00a0\u00a0 \u00a0\r\nprivate:\r\n\u00a0\u00a0 \u00a0Node *m_pFirst;\r\n\u00a0\u00a0 \u00a0Node *m_pLast;\r\n\u00a0\u00a0 \u00a0int m_Size;\r\n};\r\n\r\nint main(int argc, char *argv[])\r\n{\r\n\u00a0\u00a0 \u00a0LinkedList<int> list;\r\n\u00a0\u00a0 \u00a0for (int i = 0; i < 5; i++)\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0list.Add(i * i);\r\n\u00a0\u00a0 \u00a0return 0;\r\n}<\/pre>\n<\/li>\n
  7. Then press F5 to build and debug your project:\"06-list\"<\/a>Hover the mouse over the instance of your list. Notice that by default you won’t easily see the contents of the entire list, as only the first and the last elements are directly referenced from the list object.<\/li>\n
  8. We will now create a .natvis file that will tell VisualGDB how to display the contents of your list. Right-click in the Solution Explorer, select Add->New Item<\/strong> and pick the Debugger visualization file from Visual C++->Utility: \"07-newnatvis\"<\/a>\u00a0If this item type does not appear, simply create a .txt file and change its extension to .natvis later.<\/li>\n
  9. If you are using Advanced CMake, please make sure you add the file under the project-wide “Special Files<\/strong>” node and not under target-wide “Source Files<\/strong>“:\"\"<\/a><\/li>\n
  10. Replace the contents of the .natvis file with the following:\n
    <?xml version=\"1.0\" encoding=\"utf-8\"?> \r\n<AutoVisualizer xmlns=\"http:\/\/schemas.microsoft.com\/vstudio\/debugger\/natvis\/2010\"> \r\n\u00a0 <Type Name=\"LinkedList&lt;*&gt;\">\r\n\u00a0\u00a0\u00a0 <DisplayString>List of {m_Size} elements<\/DisplayString>\r\n\u00a0\u00a0\u00a0 <Expand HideRawView=\"0\">\r\n\u00a0\u00a0\u00a0\u00a0\u00a0 <LinkedListItems>\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 <Size>m_Size<\/Size>\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 <HeadPointer>m_pFirst<\/HeadPointer>\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 <NextPointer>pNext<\/NextPointer>\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 <ValueNode>Value<\/ValueNode>\r\n\u00a0\u00a0\u00a0\u00a0\u00a0 <\/LinkedListItems>\r\n\u00a0\u00a0\u00a0 <\/Expand>\r\n\u00a0 <\/Type>\r\n<\/AutoVisualizer><\/pre>\n
    \"08-natvisxml\"<\/a>This will tell VisualGDB to:<\/p>\n