Files
llvm-project/lldb/source/API/SBVariablesOptions.cpp
Aman LaChapelle bbf325be7e [lldb] Scaffolding for synthetic variable support. (#181500)
This patch handles most of the scaffolding for synthetic variable support that isn't directly tied to functional changes. This patch will be used by one following patch that actually modifies the lldb_private::StackFrame API to allow us to fetch synthetic variables.

There were a couple important/interesting decisions made in this patch that should be noted:
- Any value type may be synthetic, which is why it's a mask applied over the top of another value type.
- When printing frame variables with `fr v`, default to showing synthetic variables.

This new value type mask makes some of the ValueType handling more interesting, but since nothing generates objects with this mask until the next patch, we can land the concept in this patch in some amount of isolation.
2026-04-16 15:44:18 -07:00

236 lines
6.5 KiB
C++

//===-- SBVariablesOptions.cpp --------------------------------------------===//
//
// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
// See https://llvm.org/LICENSE.txt for license information.
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
//
//===----------------------------------------------------------------------===//
#include "lldb/API/SBVariablesOptions.h"
#include "lldb/API/SBTarget.h"
#include "lldb/Target/Target.h"
#include "lldb/Utility/Instrumentation.h"
#include "lldb/lldb-private.h"
using namespace lldb;
using namespace lldb_private;
class VariablesOptionsImpl {
public:
VariablesOptionsImpl()
: m_include_arguments(false), m_include_locals(false),
m_include_statics(false), m_include_synthetic(false),
m_in_scope_only(false), m_include_runtime_support_values(false) {}
VariablesOptionsImpl(const VariablesOptionsImpl &) = default;
~VariablesOptionsImpl() = default;
VariablesOptionsImpl &operator=(const VariablesOptionsImpl &) = default;
bool GetIncludeArguments() const { return m_include_arguments; }
void SetIncludeArguments(bool b) { m_include_arguments = b; }
bool GetIncludeRecognizedArguments(const lldb::TargetSP &target_sp) const {
if (m_include_recognized_arguments != eLazyBoolCalculate)
return m_include_recognized_arguments;
return target_sp ? target_sp->GetDisplayRecognizedArguments() : false;
}
void SetIncludeRecognizedArguments(bool b) {
m_include_recognized_arguments = b ? eLazyBoolYes : eLazyBoolNo;
}
bool GetIncludeLocals() const { return m_include_locals; }
void SetIncludeLocals(bool b) { m_include_locals = b; }
bool GetIncludeStatics() const { return m_include_statics; }
void SetIncludeStatics(bool b) { m_include_statics = b; }
bool GetIncludeSynthetic() const { return m_include_synthetic; }
void SetIncludeSynthetic(bool b) { m_include_synthetic = b; }
bool GetInScopeOnly() const { return m_in_scope_only; }
void SetInScopeOnly(bool b) { m_in_scope_only = b; }
bool GetIncludeRuntimeSupportValues() const {
return m_include_runtime_support_values;
}
void SetIncludeRuntimeSupportValues(bool b) {
m_include_runtime_support_values = b;
}
lldb::DynamicValueType GetUseDynamic() const { return m_use_dynamic; }
void SetUseDynamic(lldb::DynamicValueType d) { m_use_dynamic = d; }
private:
bool m_include_arguments : 1;
bool m_include_locals : 1;
bool m_include_statics : 1;
bool m_include_synthetic : 1;
bool m_in_scope_only : 1;
bool m_include_runtime_support_values : 1;
LazyBool m_include_recognized_arguments =
eLazyBoolCalculate; // can be overridden with a setting
lldb::DynamicValueType m_use_dynamic = lldb::eNoDynamicValues;
};
SBVariablesOptions::SBVariablesOptions()
: m_opaque_up(new VariablesOptionsImpl()) {
LLDB_INSTRUMENT_VA(this);
}
SBVariablesOptions::SBVariablesOptions(const SBVariablesOptions &options)
: m_opaque_up(new VariablesOptionsImpl(options.ref())) {
LLDB_INSTRUMENT_VA(this, options);
}
SBVariablesOptions &SBVariablesOptions::
operator=(const SBVariablesOptions &options) {
LLDB_INSTRUMENT_VA(this, options);
m_opaque_up = std::make_unique<VariablesOptionsImpl>(options.ref());
return *this;
}
SBVariablesOptions::~SBVariablesOptions() = default;
bool SBVariablesOptions::IsValid() const {
LLDB_INSTRUMENT_VA(this);
return this->operator bool();
}
SBVariablesOptions::operator bool() const {
LLDB_INSTRUMENT_VA(this);
return m_opaque_up != nullptr;
}
bool SBVariablesOptions::GetIncludeArguments() const {
LLDB_INSTRUMENT_VA(this);
return m_opaque_up->GetIncludeArguments();
}
void SBVariablesOptions::SetIncludeArguments(bool arguments) {
LLDB_INSTRUMENT_VA(this, arguments);
m_opaque_up->SetIncludeArguments(arguments);
}
bool SBVariablesOptions::GetIncludeRecognizedArguments(
const lldb::SBTarget &target) const {
LLDB_INSTRUMENT_VA(this, target);
return m_opaque_up->GetIncludeRecognizedArguments(target.GetSP());
}
void SBVariablesOptions::SetIncludeRecognizedArguments(bool arguments) {
LLDB_INSTRUMENT_VA(this, arguments);
m_opaque_up->SetIncludeRecognizedArguments(arguments);
}
bool SBVariablesOptions::GetIncludeLocals() const {
LLDB_INSTRUMENT_VA(this);
return m_opaque_up->GetIncludeLocals();
}
void SBVariablesOptions::SetIncludeLocals(bool locals) {
LLDB_INSTRUMENT_VA(this, locals);
m_opaque_up->SetIncludeLocals(locals);
}
bool SBVariablesOptions::GetIncludeStatics() const {
LLDB_INSTRUMENT_VA(this);
return m_opaque_up->GetIncludeStatics();
}
void SBVariablesOptions::SetIncludeStatics(bool statics) {
LLDB_INSTRUMENT_VA(this, statics);
m_opaque_up->SetIncludeStatics(statics);
}
bool SBVariablesOptions::GetIncludeSynthetic() const {
LLDB_INSTRUMENT_VA(this);
return m_opaque_up->GetIncludeSynthetic();
}
void SBVariablesOptions::SetIncludeSynthetic(bool synthetic) {
LLDB_INSTRUMENT_VA(this, synthetic);
m_opaque_up->SetIncludeSynthetic(synthetic);
}
bool SBVariablesOptions::GetInScopeOnly() const {
LLDB_INSTRUMENT_VA(this);
return m_opaque_up->GetInScopeOnly();
}
void SBVariablesOptions::SetInScopeOnly(bool in_scope_only) {
LLDB_INSTRUMENT_VA(this, in_scope_only);
m_opaque_up->SetInScopeOnly(in_scope_only);
}
bool SBVariablesOptions::GetIncludeRuntimeSupportValues() const {
LLDB_INSTRUMENT_VA(this);
return m_opaque_up->GetIncludeRuntimeSupportValues();
}
void SBVariablesOptions::SetIncludeRuntimeSupportValues(
bool runtime_support_values) {
LLDB_INSTRUMENT_VA(this, runtime_support_values);
m_opaque_up->SetIncludeRuntimeSupportValues(runtime_support_values);
}
lldb::DynamicValueType SBVariablesOptions::GetUseDynamic() const {
LLDB_INSTRUMENT_VA(this);
return m_opaque_up->GetUseDynamic();
}
void SBVariablesOptions::SetUseDynamic(lldb::DynamicValueType dynamic) {
LLDB_INSTRUMENT_VA(this, dynamic);
m_opaque_up->SetUseDynamic(dynamic);
}
VariablesOptionsImpl *SBVariablesOptions::operator->() {
return m_opaque_up.operator->();
}
const VariablesOptionsImpl *SBVariablesOptions::operator->() const {
return m_opaque_up.operator->();
}
VariablesOptionsImpl *SBVariablesOptions::get() { return m_opaque_up.get(); }
VariablesOptionsImpl &SBVariablesOptions::ref() { return *m_opaque_up; }
const VariablesOptionsImpl &SBVariablesOptions::ref() const {
return *m_opaque_up;
}
SBVariablesOptions::SBVariablesOptions(VariablesOptionsImpl *lldb_object_ptr)
: m_opaque_up(std::move(lldb_object_ptr)) {}
void SBVariablesOptions::SetOptions(VariablesOptionsImpl *lldb_object_ptr) {
m_opaque_up.reset(std::move(lldb_object_ptr));
}