Extending Qt Creator Manual | SymbolGroupNode

Extending Qt Creator Manual 4.11.2

# SymbolGroupNode Class

The SymbolGroupNode class represents a real node within a symbol group, identified by its index in IDebugSymbolGroup. More...

Header: | #include <SymbolGroupNode>
Inherits: | BaseSymbolGroupNode

## Detailed Description

Provides accessors for fixed-up symbol group value and a dumping facility consisting of:

- 'Simple' dumping done when running the DumpVisitor. This produces one line of formatted output shown for the class. These values values are always displayed, while still allowing for expansion of the structure in the debugger. It also pre-determines some information for complex dumping (type, container).
- 'Complex' dumping: Obscures the symbol group children by fake children, for example container children, to be run when calling SymbolGroup::dump with an iname. The fake children are appended to the child list (other children are just marked as obscured for GDBMI dumping so that SymbolGroupValue expressions still work as before).

The dumping is mostly based on SymbolGroupValue expressions. in the debugger. Evaluating those dumpers might expand symbol nodes, but those are not marked as 'ExpandedByRequest'. This stops the dump recursion to prevent outputting data that were not explicitly expanded by the watch handler.