class Location

Symbolized location.

Unlocated variable.

Offsets the code addresses in this by adding an amount. This is used to convert module-relative

addresses to global ones by adding the module load address.

Returns if this location is the same as the other one, ignoring the symbol() object. Comparing

symbol objects is dicy because the same symbol can result in a different object depending on

how it is found or whether it was re-queried.

This function is primarily used for tests, in which case comparing object pointer equality

might be good enough. For non-tests, one might compare symbols by name.

Returns a string version of the State enum for debugging purposes.

Returns a description of this Location for debugging purposes.

The different between "symbolized" and "has_symbols" is that the former means we tried to

symbolize it, and the latter means we actually succeeded to symbolize EITHER the line or the

function. One or the other could be missing, however.

The absolute address of this location.

The symbol associated with this address, if any. In the case of code this will most commonly be

a Function. It will not be a non-function code block inside the function (code wanting lexical

blocks can look inside the function's children as needed). It could also be a variable symbol

corresponding to a global or static variable or an ELF symbol.

When looking up code locations from the symbol system and the address is non-ambiguous,

this will be the most specific (possibly inline) function covering the address in

question. For ambiguous inline locations this will either be the most specific inline function

or the non-inline function (least-specific) according to ResolveOptions.ambiguous_inline (see

that variable for more on ambiguous inline locations).

A function can have different scopes inside of it. To get the current lexical scope inside the

function, use GetMostSpecificChild() on it.

This isn't necessarily valid, even if the State == kSymbolized. It could be the symbol table

indicates file/line info for this address but could lack a function record for it.

Symbolized locations will have a valid symbol context for converting addresses.

A location can be invalid (has no address), can have an address that we haven't tried to

symbolize, and a symbolized address. The latter two states allow symbolizing on demand without

having additional types.

The "symbolized" state doesn't necessarily mean there are symbols, it just means we tried to

symbolize it.