GDB (xrefs)
Loading...
Searching...
No Matches
Public Member Functions | Public Attributes | Protected Member Functions | List of all members
gdb.dap.varref.BaseReference Class Reference
Inheritance diagram for gdb.dap.varref.BaseReference:
gdb.dap.scopes._ScopeReference gdb.dap.scopes._ScopeReference gdb.dap.varref.VariableReference gdb.dap.varref.VariableReference gdb.dap.scopes._RegisterReference gdb.dap.scopes._RegisterReference gdb.dap.scopes._RegisterReference gdb.dap.scopes._RegisterReference gdb.dap.evaluate.EvaluateResult gdb.dap.evaluate.EvaluateResult gdb.dap.evaluate._SetResult gdb.dap.evaluate._SetResult gdb.dap.evaluate.EvaluateResult gdb.dap.evaluate.EvaluateResult gdb.dap.evaluate._SetResult gdb.dap.evaluate._SetResult

Public Member Functions

 __init__ (self, name)
 
 to_object (self)
 
 has_children (self)
 
 reset_children (self)
 
 fetch_one_child (self, index)
 
 child_count (self)
 
 fetch_children (self, start, count)
 
 find_child_by_name (self, name)
 
 __init__ (self, name)
 
 to_object (self)
 
 has_children (self)
 
 reset_children (self)
 
 fetch_one_child (self, index)
 
 child_count (self)
 
 fetch_children (self, start, count)
 
 find_child_by_name (self, name)
 

Public Attributes

 ref
 
 name
 
 children
 
 by_name
 
 name_counts
 

Protected Member Functions

 _compute_name (self, name)
 
 _compute_name (self, name)
 

Detailed Description

Represent a variable or a scope.

This class is just a base class, some methods must be implemented in
subclasses.

The 'ref' field can be used as the variablesReference in the protocol.

Definition at line 56 of file varref.py.

Constructor & Destructor Documentation

◆ __init__() [1/2]

gdb.dap.varref.BaseReference.__init__ ( self,
name )
Create a new variable reference with the given name.

NAME is a string or None.  None means this does not have a
name, e.g., the result of expression evaluation.

Reimplemented in gdb.dap.scopes._RegisterReference, gdb.dap.scopes._RegisterReference, gdb.dap.scopes._ScopeReference, gdb.dap.scopes._ScopeReference, gdb.dap.varref.VariableReference, gdb.dap.varref.VariableReference, gdb.dap.evaluate.EvaluateResult, gdb.dap.evaluate._SetResult, gdb.dap.evaluate.EvaluateResult, and gdb.dap.evaluate._SetResult.

Definition at line 66 of file varref.py.

◆ __init__() [2/2]

gdb.dap.varref.BaseReference.__init__ ( self,
name )
Create a new variable reference with the given name.

NAME is a string or None.  None means this does not have a
name, e.g., the result of expression evaluation.

Reimplemented in gdb.dap.scopes._RegisterReference, gdb.dap.scopes._RegisterReference, gdb.dap.scopes._ScopeReference, gdb.dap.scopes._ScopeReference, gdb.dap.varref.VariableReference, gdb.dap.varref.VariableReference, gdb.dap.evaluate.EvaluateResult, gdb.dap.evaluate._SetResult, gdb.dap.evaluate.EvaluateResult, and gdb.dap.evaluate._SetResult.

Definition at line 66 of file varref.py.

References gdb-gdb.TypeFlag.name, name, cache_entry.name, cache_entry_search.name, ada_exc_info.name, amd_dbgapi_register_type_flags::field.name, amd_dbgapi_register_type_enum::enumerator.name, arc_register_feature.name, async_signal_handler.name, async_event_handler.name, loaded_script.name, aop_map.name, block_iterator.name, subfile.name, context_stack.name, cmd_list_element.name, gdb::option::option_def.name, cli_style_option.name(), amd_dbgapi_register_type_flags.name(), amd_dbgapi_register_type_enum.name(), scope_component.name, header_file_location.name, attr_abbrev.name, attribute.name, cooked_index_entry.name, delayed_method_info.name, symtab_index_entry.name, file_entry.name, dwp_file.name, fnfieldlist.name, cooked_indexer::deferred_entry.name, extension_language_defn.name, f77_boolean_val.name, frame_unwind.name, gdbarch_types.Component.name, thread_info.name(), field.name(), type.name(), interp.name(), mi_command.name(), language_defn.name(), ada_language.name(), c_language.name(), cplus_language.name(), asm_language.name(), minimal_language.name(), d_language.name(), f_language.name(), go_language.name(), unknown_language.name(), m2_language.name(), csky_supported_tdesc_register.name, elf_gnu_ifunc_cache.name, ada_task_info.name, main_type.name, fn_fieldlist.name, decl_field.name, scheme_variable.name, scheme_function.name, scheme_integer_constant.name, command_smob.name, cmdscm_completer.name, param_smob.name, pretty_printer_smob.name, interp_factory.name, gdb_block.name, m32c_reg.name, m68hc11_soft_reg.name, oso_el.name, macro_name_list.name, macro_key.name, single_bfd_flag_info.name, mi_opt.name, register_alias.name, windows_nat::windows_thread_info.name, nto_thread_info.name, objc_class.name, objc_method.name, objc_language.name(), objc_methcall.name, opencl_language.name(), osdata_column.name, pascal_language.name(), trans.name, gdb.dap.varref.BaseReference.name, gdb.disassembler.Disassembler.name, gdb.printing.PrettyPrinter.name, gdb.printing.SubPrettyPrinter.name, gdb.types.TypePrinter.name, gdb.unwinder.Unwinder.name(), gdb.xmethod.XMethod.name, gdb.xmethod.XMethodMatcher.name, pybp_code.name, cmdpy_completer.name, pyty_code.name, gdb::reg.name, reggroup.name(), notif_client.name, packet_description.name, memory_packet_config.name, remote_thread_info.name, thread_item.name, protocol_feature.name, riscv_register_feature.name(), ppc_variant.name, token_info.name, serial.name, serial_ops.name, probe_info.name, lm_info_target.name, header_file.name, lookup_name_info.name(), rust_language.name(), other_sections.name, symbol_cache_slot.name, compunit_symtab.name, selftests::xml_test_tdesc.name, syscall.name, trace_state_variable.name, uploaded_tsv.name, tui_win_info.name(), tui_cmd_window.name(), tui_disasm_window.name(), tui_data_window.name(), tui_source_window.name(), tui_locator_window.name(), tui_translate.name, base_field_s.name, item_with_base.name, item_with_member.name, selftests::observers::dependency_observer_data.name, user_reg.name, internal_problem.name, internal_function.name, internalvar.name, varobj_item.name, varobj.name, windows_solib.name, enum_value_name.name, _inclTable.name, gdb_xml_value.name, gdb_xml_attribute.name, gdb_xml_element.name, gdb_xml_enum.name, xtensa_register_t.name, xtensa_regtable_t.name, gdb.dap.varref.BaseReference.ref, and gdb.dap.varref.BaseReference.reset_children().

Member Function Documentation

◆ _compute_name() [1/2]

gdb.dap.varref.BaseReference._compute_name ( self,
name )
protected

◆ _compute_name() [2/2]

gdb.dap.varref.BaseReference._compute_name ( self,
name )
protected

◆ child_count() [1/2]

gdb.dap.varref.BaseReference.child_count ( self)

◆ child_count() [2/2]

gdb.dap.varref.BaseReference.child_count ( self)

◆ fetch_children() [1/2]

gdb.dap.varref.BaseReference.fetch_children ( self,
start,
count )

◆ fetch_children() [2/2]

gdb.dap.varref.BaseReference.fetch_children ( self,
start,
count )

◆ fetch_one_child() [1/2]

gdb.dap.varref.BaseReference.fetch_one_child ( self,
index )
Fetch one child of this variable.

INDEX is the index of the child to fetch.
This should return a tuple of the form (NAME, VALUE), where
NAME is the name of the variable, and VALUE is a gdb.Value.

Reimplemented in gdb.dap.scopes._ScopeReference, gdb.dap.scopes._RegisterReference, gdb.dap.varref.VariableReference, gdb.dap.scopes._ScopeReference, gdb.dap.scopes._RegisterReference, and gdb.dap.varref.VariableReference.

Definition at line 107 of file varref.py.

Referenced by gdb.dap.varref.BaseReference.fetch_children().

◆ fetch_one_child() [2/2]

gdb.dap.varref.BaseReference.fetch_one_child ( self,
index )
Fetch one child of this variable.

INDEX is the index of the child to fetch.
This should return a tuple of the form (NAME, VALUE), where
NAME is the name of the variable, and VALUE is a gdb.Value.

Reimplemented in gdb.dap.scopes._ScopeReference, gdb.dap.scopes._RegisterReference, gdb.dap.varref.VariableReference, gdb.dap.scopes._ScopeReference, gdb.dap.scopes._RegisterReference, and gdb.dap.varref.VariableReference.

Definition at line 107 of file varref.py.

Referenced by gdb.dap.varref.BaseReference.fetch_children().

◆ find_child_by_name() [1/2]

gdb.dap.varref.BaseReference.find_child_by_name ( self,
name )
Find a child of this variable, given its name.

Returns the value of the child, or throws if not found.

Definition at line 159 of file varref.py.

References gdb.dap.varref.BaseReference.by_name.

◆ find_child_by_name() [2/2]

gdb.dap.varref.BaseReference.find_child_by_name ( self,
name )
Find a child of this variable, given its name.

Returns the value of the child, or throws if not found.

Definition at line 159 of file varref.py.

References gdb.dap.varref.BaseReference.by_name.

◆ has_children() [1/2]

gdb.dap.varref.BaseReference.has_children ( self)

◆ has_children() [2/2]

gdb.dap.varref.BaseReference.has_children ( self)

◆ reset_children() [1/2]

gdb.dap.varref.BaseReference.reset_children ( self)

◆ reset_children() [2/2]

gdb.dap.varref.BaseReference.reset_children ( self)
Reset any cached information about the children of this object.

Definition at line 94 of file varref.py.

Referenced by gdb.dap.varref.BaseReference.__init__(), and gdb.dap.varref.VariableReference._update_value().

◆ to_object() [1/2]

gdb.dap.varref.BaseReference.to_object ( self)
Return a dictionary that describes this object for DAP.

The resulting object is a starting point that can be filled in
further.  See the Scope or Variable types in the spec

Reimplemented in gdb.dap.scopes._ScopeReference, gdb.dap.varref.VariableReference, gdb.dap.scopes._ScopeReference, and gdb.dap.varref.VariableReference.

Definition at line 79 of file varref.py.

References abbrev_info.has_children, die_info.has_children, gdb.dap.scopes._ScopeReference.has_children(), gdb.dap.varref.BaseReference.has_children(), gdb.dap.varref.VariableReference.has_children(), gdb-gdb.TypeFlag.name, name, cache_entry.name, cache_entry_search.name, ada_language.name(), ada_task_info.name, ada_exc_info.name, amd_dbgapi_register_type_flags::field.name, amd_dbgapi_register_type_flags.name(), amd_dbgapi_register_type_enum::enumerator.name, amd_dbgapi_register_type_enum.name(), arc_register_feature.name, async_signal_handler.name, async_event_handler.name, loaded_script.name, aop_map.name, block_iterator.name, subfile.name, context_stack.name, minimal_language.name(), gdb::option::option_def.name, cli_style_option.name(), c_language.name(), cplus_language.name(), asm_language.name(), cmd_list_element.name, scope_component.name, d_language.name(), csky_supported_tdesc_register.name, header_file_location.name, attr_abbrev.name, attribute.name, cooked_index_entry.name, delayed_method_info.name, symtab_index_entry.name, file_entry.name, dwp_file.name, fnfieldlist.name, cooked_indexer::deferred_entry.name, extension_language_defn.name, f77_boolean_val.name, frame_unwind.name, gdbarch_types.Component.name, thread_info.name(), field.name(), main_type.name, type.name(), fn_fieldlist.name, decl_field.name, scheme_variable.name, scheme_function.name, scheme_integer_constant.name, command_smob.name, cmdscm_completer.name, param_smob.name, pretty_printer_smob.name, interp_factory.name, interp.name(), gdb_block.name, mi_command.name(), language_defn.name(), f_language.name(), go_language.name(), unknown_language.name(), m2_language.name(), elf_gnu_ifunc_cache.name, m32c_reg.name, m68hc11_soft_reg.name, oso_el.name, macro_name_list.name, macro_key.name, single_bfd_flag_info.name, mi_opt.name, register_alias.name, windows_nat::windows_thread_info.name, nto_thread_info.name, objc_class.name, objc_method.name, objc_language.name(), objc_methcall.name, opencl_language.name(), osdata_column.name, pascal_language.name(), trans.name, gdb.dap.varref.BaseReference.name, gdb.disassembler.Disassembler.name, gdb.printing.PrettyPrinter.name, gdb.printing.SubPrettyPrinter.name, gdb.types.TypePrinter.name, gdb.unwinder.Unwinder.name(), gdb.xmethod.XMethod.name, gdb.xmethod.XMethodMatcher.name, pybp_code.name, cmdpy_completer.name, pyty_code.name, gdb::reg.name, reggroup.name(), notif_client.name, packet_description.name, memory_packet_config.name, remote_thread_info.name, thread_item.name, protocol_feature.name, riscv_register_feature.name(), ppc_variant.name, rust_language.name(), token_info.name, serial.name, serial_ops.name, probe_info.name, lm_info_target.name, header_file.name, other_sections.name, symbol_cache_slot.name, lookup_name_info.name(), compunit_symtab.name, selftests::xml_test_tdesc.name, syscall.name, trace_state_variable.name, uploaded_tsv.name, tui_win_info.name(), tui_cmd_window.name(), tui_disasm_window.name(), tui_data_window.name(), tui_source_window.name(), tui_locator_window.name(), tui_translate.name, base_field_s.name, item_with_base.name, item_with_member.name, selftests::observers::dependency_observer_data.name, user_reg.name, internal_problem.name, internal_function.name, internalvar.name, varobj_item.name, varobj.name, windows_solib.name, enum_value_name.name, _inclTable.name, gdb_xml_value.name, gdb_xml_attribute.name, gdb_xml_element.name, gdb_xml_enum.name, xtensa_register_t.name, xtensa_regtable_t.name, and gdb.dap.varref.BaseReference.ref.

◆ to_object() [2/2]

gdb.dap.varref.BaseReference.to_object ( self)
Return a dictionary that describes this object for DAP.

The resulting object is a starting point that can be filled in
further.  See the Scope or Variable types in the spec

Reimplemented in gdb.dap.scopes._ScopeReference, gdb.dap.varref.VariableReference, gdb.dap.scopes._ScopeReference, and gdb.dap.varref.VariableReference.

Definition at line 79 of file varref.py.

References abbrev_info.has_children, die_info.has_children, gdb.dap.scopes._ScopeReference.has_children(), gdb.dap.varref.BaseReference.has_children(), gdb.dap.varref.VariableReference.has_children(), gdb-gdb.TypeFlag.name, name, cache_entry.name, cache_entry_search.name, ada_language.name(), ada_task_info.name, ada_exc_info.name, amd_dbgapi_register_type_flags::field.name, amd_dbgapi_register_type_flags.name(), amd_dbgapi_register_type_enum::enumerator.name, amd_dbgapi_register_type_enum.name(), arc_register_feature.name, async_signal_handler.name, async_event_handler.name, loaded_script.name, aop_map.name, block_iterator.name, subfile.name, context_stack.name, minimal_language.name(), gdb::option::option_def.name, cli_style_option.name(), c_language.name(), cplus_language.name(), asm_language.name(), cmd_list_element.name, scope_component.name, d_language.name(), csky_supported_tdesc_register.name, header_file_location.name, attr_abbrev.name, attribute.name, cooked_index_entry.name, delayed_method_info.name, symtab_index_entry.name, file_entry.name, dwp_file.name, fnfieldlist.name, cooked_indexer::deferred_entry.name, extension_language_defn.name, f77_boolean_val.name, frame_unwind.name, gdbarch_types.Component.name, thread_info.name(), field.name(), main_type.name, type.name(), fn_fieldlist.name, decl_field.name, scheme_variable.name, scheme_function.name, scheme_integer_constant.name, command_smob.name, cmdscm_completer.name, param_smob.name, pretty_printer_smob.name, interp_factory.name, interp.name(), gdb_block.name, mi_command.name(), language_defn.name(), f_language.name(), go_language.name(), unknown_language.name(), m2_language.name(), elf_gnu_ifunc_cache.name, m32c_reg.name, m68hc11_soft_reg.name, oso_el.name, macro_name_list.name, macro_key.name, single_bfd_flag_info.name, mi_opt.name, register_alias.name, windows_nat::windows_thread_info.name, nto_thread_info.name, objc_class.name, objc_method.name, objc_language.name(), objc_methcall.name, opencl_language.name(), osdata_column.name, pascal_language.name(), trans.name, gdb.dap.varref.BaseReference.name, gdb.disassembler.Disassembler.name, gdb.printing.PrettyPrinter.name, gdb.printing.SubPrettyPrinter.name, gdb.types.TypePrinter.name, gdb.unwinder.Unwinder.name(), gdb.xmethod.XMethod.name, gdb.xmethod.XMethodMatcher.name, pybp_code.name, cmdpy_completer.name, pyty_code.name, gdb::reg.name, reggroup.name(), notif_client.name, packet_description.name, memory_packet_config.name, remote_thread_info.name, thread_item.name, protocol_feature.name, riscv_register_feature.name(), ppc_variant.name, rust_language.name(), token_info.name, serial.name, serial_ops.name, probe_info.name, lm_info_target.name, header_file.name, other_sections.name, symbol_cache_slot.name, lookup_name_info.name(), compunit_symtab.name, selftests::xml_test_tdesc.name, syscall.name, trace_state_variable.name, uploaded_tsv.name, tui_win_info.name(), tui_cmd_window.name(), tui_disasm_window.name(), tui_data_window.name(), tui_source_window.name(), tui_locator_window.name(), tui_translate.name, base_field_s.name, item_with_base.name, item_with_member.name, selftests::observers::dependency_observer_data.name, user_reg.name, internal_problem.name, internal_function.name, internalvar.name, varobj_item.name, varobj.name, windows_solib.name, enum_value_name.name, _inclTable.name, gdb_xml_value.name, gdb_xml_attribute.name, gdb_xml_element.name, gdb_xml_enum.name, xtensa_register_t.name, xtensa_regtable_t.name, and gdb.dap.varref.BaseReference.ref.

Member Data Documentation

◆ by_name

gdb.dap.varref.BaseReference.by_name

◆ children

gdb.dap.varref.BaseReference.children

◆ name

gdb.dap.varref.BaseReference.name

◆ name_counts

gdb.dap.varref.BaseReference.name_counts

◆ ref

gdb.dap.varref.BaseReference.ref

The documentation for this class was generated from the following files: