Synthetic children frontend for std::coroutine_handle<promise_type> from libc++, libstdc++ and MSVC STL. More...

#include <Coroutines.h>

Inheritance diagram for lldb_private::formatters::StdlibCoroutineHandleSyntheticFrontEnd:

Public Member Functions
	StdlibCoroutineHandleSyntheticFrontEnd (lldb::ValueObjectSP valobj_sp)
	~StdlibCoroutineHandleSyntheticFrontEnd () override
llvm::Expected< uint32_t >	CalculateNumChildren () override
lldb::ValueObjectSP	GetChildAtIndex (uint32_t idx) override
lldb::ChildCacheState	Update () override
	This function is assumed to always succeed and if it fails, the front-end should know to deal with it in the correct way (most probably, by refusing to return any children).
llvm::Expected< size_t >	GetIndexOfChildWithName (ConstString name) override
Public Member Functions inherited from lldb_private::SyntheticChildrenFrontEnd
	SyntheticChildrenFrontEnd (ValueObject &backend)
virtual	~SyntheticChildrenFrontEnd ()=default
virtual llvm::Expected< uint32_t >	CalculateNumChildren (uint32_t max)
uint32_t	CalculateNumChildrenIgnoringErrors (uint32_t max=UINT32_MAX)
virtual bool	MightHaveChildren ()
virtual lldb::ValueObjectSP	GetSyntheticValue ()
virtual ConstString	GetSyntheticTypeName ()

Private Attributes
std::vector< lldb::ValueObjectSP >	m_children

Additional Inherited Members
Public Types inherited from lldb_private::SyntheticChildrenFrontEnd
typedef std::shared_ptr< SyntheticChildrenFrontEnd >	SharedPointer
typedef std::unique_ptr< SyntheticChildrenFrontEnd >	AutoPointer
Protected Member Functions inherited from lldb_private::SyntheticChildrenFrontEnd
void	SetValid (bool valid)
bool	IsValid ()
lldb::ValueObjectSP	CreateValueObjectFromExpression (llvm::StringRef name, llvm::StringRef expression, const ExecutionContext &exe_ctx)
lldb::ValueObjectSP	CreateValueObjectFromAddress (llvm::StringRef name, uint64_t address, const ExecutionContext &exe_ctx, CompilerType type, bool do_deref=true)
lldb::ValueObjectSP	CreateValueObjectFromData (llvm::StringRef name, const DataExtractor &data, const ExecutionContext &exe_ctx, CompilerType type)
Protected Attributes inherited from lldb_private::SyntheticChildrenFrontEnd
ValueObject &	m_backend

Detailed Description

Synthetic children frontend for std::coroutine_handle<promise_type> from libc++, libstdc++ and MSVC STL.

Shows the compiler-generated resume and destroy function pointers as well as the promise, if the promise type is promise_type != void.

Definition at line 30 of file Coroutines.h.

Constructor & Destructor Documentation

◆ StdlibCoroutineHandleSyntheticFrontEnd()

lldb_private::formatters::StdlibCoroutineHandleSyntheticFrontEnd::StdlibCoroutineHandleSyntheticFrontEnd ( lldb::ValueObjectSP valobj_sp )

Definition at line 100 of file Coroutines.cpp.

References lldb_private::SyntheticChildrenFrontEnd::SyntheticChildrenFrontEnd(), and Update().

◆ ~StdlibCoroutineHandleSyntheticFrontEnd()

lldb_private::formatters::StdlibCoroutineHandleSyntheticFrontEnd::~StdlibCoroutineHandleSyntheticFrontEnd ( )

overridedefault

Member Function Documentation

◆ CalculateNumChildren()

llvm::Expected< uint32_t > lldb_private::formatters::StdlibCoroutineHandleSyntheticFrontEnd::CalculateNumChildren ( )

overridevirtual

Implements lldb_private::SyntheticChildrenFrontEnd.

Definition at line 110 of file Coroutines.cpp.

References m_children.

◆ GetChildAtIndex()

lldb::ValueObjectSP lldb_private::formatters::StdlibCoroutineHandleSyntheticFrontEnd::GetChildAtIndex ( uint32_t idx )

overridevirtual

Implements lldb_private::SyntheticChildrenFrontEnd.

Definition at line 115 of file Coroutines.cpp.

References m_children.

◆ GetIndexOfChildWithName()

llvm::Expected< size_t > StdlibCoroutineHandleSyntheticFrontEnd::GetIndexOfChildWithName ( ConstString name )

overridevirtual

Implements lldb_private::SyntheticChildrenFrontEnd.

Definition at line 197 of file Coroutines.cpp.

References lldb_private::ConstString::AsCString(), and m_children.

◆ Update()

lldb::ChildCacheState lldb_private::formatters::StdlibCoroutineHandleSyntheticFrontEnd::Update ( )

overridevirtual

This function is assumed to always succeed and if it fails, the front-end should know to deal with it in the correct way (most probably, by refusing to return any children).

The return value of Update should actually be interpreted as "ValueObjectSynthetic cache is good/bad". If this function returns lldb::ChildCacheState::eReuse, ValueObjectSynthetic is allowed to use the children it fetched previously and cached. Otherwise, ValueObjectSynthetic must throw away its cache, and query again for children.

Implements lldb_private::SyntheticChildrenFrontEnd.

Definition at line 121 of file Coroutines.cpp.

References lldb_private::SyntheticChildrenFrontEnd::CreateValueObjectFromAddress(), lldb::eBasicTypeVoid, lldb::eRefetch, ExtractDestroyFunction(), GetCoroFramePtrFromHandle(), lldb_private::CompilerType::GetPointerType(), lldb_private::CompilerType::GetTypeTemplateArgument(), InferArtificialCoroType(), lldb_private::CompilerType::IsVoidType(), LLDB_INVALID_ADDRESS, lldb_private::SyntheticChildrenFrontEnd::m_backend, and m_children.