Symbols

final class ntoseye.Symbols

Symbol lookup scoped to an address space: dbg.symbols, proc.symbols.

__contains__(name: str, /) → bool

Whether at least one symbol candidate has this name.

__getitem__(name: str, /) → int

Resolve a symbol to its address, raising SymbolNotFoundError when absent.

candidates(name: str) → list[Record]

Return every exact candidate, including module and private-compiland provenance.

get(name: str) → int | None

Resolve a symbol to its address, or return None when absent.

locals_at(addr: int) → list[Record]

List PDB local/parameter layouts covering addr, without evaluating values.

nearest(addr: int) → Symbol | None

Return the nearest symbol identity, or None if no symbol covers addr.

property path: list[str]

Ordered symbol sources (.sympath); assignment replaces the full path.

reload() → Record

Reload symbols in this space and re-resolve symbolic breakpoints.

reset_path() → None

Restore the default symbol sources (.symfix).

search(query: str, limit: int = 50) → list[Record]

Fuzzy-search symbol names; module!query scopes the search to a module.

source_addresses(file: str, line: int) → list[int]

Resolve a source file and line to every matching loaded address.

source_location(addr: int) → Record | None

Resolve an address to PDB source metadata and its remapped local path.

property source_path: list[str]

Ordered source-path mappings (.srcpath); assignment replaces them.