mirror of
https://github.com/go-delve/delve.git
synced 2025-10-30 02:07:58 +08:00
dwarf/reader: minor comments around variable resolving (#2253)
Fix some stale comments and add some comments that I would have found useful.
This commit is contained in:
@ -8,6 +8,11 @@ import (
|
||||
|
||||
type Variable struct {
|
||||
*godwarf.Tree
|
||||
// Depth represents the depth of the lexical block in which this variable
|
||||
// was declared, relative to a root scope (e.g. a function) passed to
|
||||
// Variables(). The depth is used to figure out if a variable is shadowed at
|
||||
// a particular pc by another one with the same name declared in an inner
|
||||
// block.
|
||||
Depth int
|
||||
}
|
||||
|
||||
@ -21,12 +26,16 @@ const (
|
||||
)
|
||||
|
||||
// Variables returns a list of variables contained inside 'root'.
|
||||
// If onlyVisible is true only variables visible at pc will be returned.
|
||||
// If skipInlinedSubroutines is true inlined subroutines will be skipped
|
||||
//
|
||||
// If the VariablesOnlyVisible flag is set, only variables visible at 'pc' will be
|
||||
// returned. If the VariablesSkipInlinedSubroutines is set, variables from
|
||||
// inlined subroutines will be skipped.
|
||||
func Variables(root *godwarf.Tree, pc uint64, line int, flags VariablesFlags) []Variable {
|
||||
return variablesInternal(nil, root, 0, pc, line, flags)
|
||||
}
|
||||
|
||||
// variablesInternal appends to 'v' variables from 'root'. The function calls
|
||||
// itself with an incremented scope for all sub-blocks in 'root'.
|
||||
func variablesInternal(v []Variable, root *godwarf.Tree, depth int, pc uint64, line int, flags VariablesFlags) []Variable {
|
||||
switch root.Tag {
|
||||
case dwarf.TagInlinedSubroutine:
|
||||
@ -35,6 +44,8 @@ func variablesInternal(v []Variable, root *godwarf.Tree, depth int, pc uint64, l
|
||||
}
|
||||
fallthrough
|
||||
case dwarf.TagLexDwarfBlock, dwarf.TagSubprogram:
|
||||
// Recurse into blocks and functions, if the respective block contains
|
||||
// pc (or if we don't care about visibility).
|
||||
if (flags&VariablesOnlyVisible == 0) || root.ContainsPC(pc) {
|
||||
for _, child := range root.Children {
|
||||
v = variablesInternal(v, child, depth+1, pc, line, flags)
|
||||
|
||||
@ -200,7 +200,7 @@ func isAssignment(err error) (int, bool) {
|
||||
return 0, false
|
||||
}
|
||||
|
||||
// Locals fetches all variables of a specific type in the current function scope.
|
||||
// Locals returns all variables in 'scope'.
|
||||
func (scope *EvalScope) Locals() ([]*Variable, error) {
|
||||
if scope.Fn == nil {
|
||||
return nil, errors.New("unable to find function context")
|
||||
|
||||
Reference in New Issue
Block a user