lldb_private::Language Class Reference

#include <Language.h>

Inheritance diagram for lldb_private::Language:

Collaboration diagram for lldb_private::Language:

Classes
class	EitherTypeScavenger
class	ImageListTypeScavenger
class	MethodNameVariant
class	TypeScavenger
class	UnionTypeScavenger

Public Types
enum	FunctionNameRepresentation { FunctionNameRepresentation::eName, FunctionNameRepresentation::eNameWithArgs, FunctionNameRepresentation::eNameWithNoArgs }

Public Member Functions
	~Language () override
virtual lldb::LanguageType	GetLanguageType () const =0
virtual bool	IsTopLevelFunction (Function &function)
virtual bool	IsSourceFile (llvm::StringRef file_path) const =0
virtual const Highlighter *	GetHighlighter () const
virtual lldb::TypeCategoryImplSP	GetFormatters ()
virtual HardcodedFormatters::HardcodedFormatFinder	GetHardcodedFormats ()
virtual HardcodedFormatters::HardcodedSummaryFinder	GetHardcodedSummaries ()
virtual HardcodedFormatters::HardcodedSyntheticFinder	GetHardcodedSynthetics ()
virtual std::vector< FormattersMatchCandidate >	GetPossibleFormattersMatches (ValueObject &valobj, lldb::DynamicValueType use_dynamic)
virtual std::unique_ptr< TypeScavenger >	GetTypeScavenger ()
virtual const char *	GetLanguageSpecificTypeLookupHelp ()
virtual std::vector< Language::MethodNameVariant >	GetMethodNameVariants (ConstString method_name) const
virtual bool	SymbolNameFitsToLanguage (Mangled name) const
	Returns true iff the given symbol name is compatible with the mangling scheme of this language. More...
virtual bool	GetFormatterPrefixSuffix (ValueObject &valobj, ConstString type_hint, std::string &prefix, std::string &suffix)
virtual bool	DemangledNameContainsPath (llvm::StringRef path, ConstString demangled) const
virtual DumpValueObjectOptions::DeclPrintingHelper	GetDeclPrintingHelper ()
virtual LazyBool	IsLogicalTrue (ValueObject &valobj, Status &error)
virtual bool	IsNilReference (ValueObject &valobj)
virtual llvm::StringRef	GetNilReferenceSummaryString ()
	Returns the summary string for ValueObjects for which IsNilReference() is true. More...
virtual bool	IsUninitializedReference (ValueObject &valobj)
virtual bool	GetFunctionDisplayName (const SymbolContext *sc, const ExecutionContext *exe_ctx, FunctionNameRepresentation representation, Stream &s)
virtual ConstString	GetDemangledFunctionNameWithoutArguments (Mangled mangled) const
virtual void	GetExceptionResolverDescription (bool catch_on, bool throw_on, Stream &s)
virtual std::vector< ConstString >	GenerateAlternateFunctionManglings (const ConstString mangled) const
virtual ConstString	FindBestAlternateFunctionMangledName (const Mangled mangled, const SymbolContext &sym_ctx) const
Public Member Functions inherited from lldb_private::PluginInterface
	PluginInterface ()=default
virtual	~PluginInterface ()=default
virtual llvm::StringRef	GetPluginName ()=0
	PluginInterface (const PluginInterface &)=delete
PluginInterface &	operator= (const PluginInterface &)=delete

Static Public Member Functions
static Language *	FindPlugin (lldb::LanguageType language)
static Language *	FindPlugin (llvm::StringRef file_path)
	Returns the Language associated with the given file path or a nullptr if there is no known language. More...
static Language *	FindPlugin (lldb::LanguageType language, llvm::StringRef file_path)
static void	ForEach (std::function< bool(Language *)> callback)
static void	GetDefaultExceptionResolverDescription (bool catch_on, bool throw_on, Stream &s)
static lldb::LanguageType	GetLanguageTypeFromString (const char *string)=delete
static lldb::LanguageType	GetLanguageTypeFromString (llvm::StringRef string)
static const char *	GetNameForLanguageType (lldb::LanguageType language)
static void	PrintAllLanguages (Stream &s, const char *prefix, const char *suffix)
static void	ForAllLanguages (std::function< bool(lldb::LanguageType)> callback)
static bool	LanguageIsCPlusPlus (lldb::LanguageType language)
static bool	LanguageIsObjC (lldb::LanguageType language)
static bool	LanguageIsC (lldb::LanguageType language)
static bool	LanguageIsCFamily (lldb::LanguageType language)
	Equivalent to LanguageIsC||LanguageIsObjC||LanguageIsCPlusPlus. More...
static bool	LanguageIsPascal (lldb::LanguageType language)
static lldb::LanguageType	GetPrimaryLanguage (lldb::LanguageType language)
static std::set< lldb::LanguageType >	GetSupportedLanguages ()
static LanguageSet	GetLanguagesSupportingTypeSystems ()
static LanguageSet	GetLanguagesSupportingTypeSystemsForExpressions ()
static LanguageSet	GetLanguagesSupportingREPLs ()

Protected Member Functions
	Language ()

Private Member Functions
	Language (const Language &)=delete
const Language &	operator= (const Language &)=delete

Detailed Description

Definition at line 29 of file Language.h.

Member Enumeration Documentation

FunctionNameRepresentation

enum lldb_private::Language::FunctionNameRepresentation

strong

Enumerator
eName
eNameWithArgs
eNameWithNoArgs

Definition at line 141 of file Language.h.

Constructor & Destructor Documentation

~Language()

Language::~Language ( )

overridedefault

Language() [1/2]

Language::Language ( )

protecteddefault

Language() [2/2]

lldb_private::Language::Language ( const Language &  )

privatedelete

Member Function Documentation

DemangledNameContainsPath()

bool Language::DemangledNameContainsPath ( llvm::StringRef  path, ConstString  demangled  ) const

virtual

Reimplemented in lldb_private::CPlusPlusLanguage.

Definition at line 431 of file Language.cpp.

References lldb_private::ConstString::GetStringRef().

FindBestAlternateFunctionMangledName()

virtual ConstString lldb_private::Language::FindBestAlternateFunctionMangledName ( const Mangled  mangled, const SymbolContext &  sym_ctx  ) const

inlinevirtual

Reimplemented in lldb_private::CPlusPlusLanguage.

Definition at line 314 of file Language.h.

FindPlugin() [1/3]

Language * Language::FindPlugin ( lldb::LanguageType  language )

static

Definition at line 53 of file Language.cpp.

References GetLanguagesMap(), and GetLanguagesMutex().

Referenced by lldb_private::BreakpointResolverName::AddNameLookup(), lldb_private::IRExecutionUnit::CollectCandidateCPlusPlusNames(), lldb_private::FormatEntity::Format(), ExceptionBreakpointResolver::GetDescription(), lldb_private::HighlighterManager::getHighlighterFor(), lldb_private::ValueObject::IsLogicalTrue(), lldb_private::ValueObject::IsNilReference(), lldb_private::Function::IsTopLevelFunction(), lldb_private::ValueObject::IsUninitializedReference(), lldb_private::LanguageCategory::LanguageCategory(), lldb_private::Module::LookupInfo::NameMatchesLookupInfo(), and lldb_private::formatters::NSDictionarySummaryProvider().

FindPlugin() [2/3]

Language * Language::FindPlugin ( lldb::LanguageType  language, llvm::StringRef  file_path  )

static

Definition at line 90 of file Language.cpp.

FindPlugin() [3/3]

Language * Language::FindPlugin ( llvm::StringRef  file_path )

static

Returns the Language associated with the given file path or a nullptr if there is no known language.

Definition at line 78 of file Language.cpp.

References IsSourceFile().

ForAllLanguages()

void Language::ForAllLanguages ( std::function< bool(lldb::LanguageType)>  callback )

static

Definition at line 231 of file Language.cpp.

References language_names, num_languages, and language_name_pair::type.

ForEach()

void Language::ForEach ( std::function< bool(Language *)>  callback )

static

Definition at line 100 of file Language.cpp.

References lldb::eLanguageTypeUnknown, lldb::eNumLanguageTypes, GetLanguagesMap(), and GetLanguagesMutex().

Referenced by lldb_private::BreakpointResolverName::AddNameLookup(), and lldb_private::Symtab::InitNameIndexes().

GenerateAlternateFunctionManglings()

virtual std::vector<ConstString> lldb_private::Language::GenerateAlternateFunctionManglings ( const ConstString  mangled ) const

inlinevirtual

Reimplemented in lldb_private::CPlusPlusLanguage.

Definition at line 309 of file Language.h.

GetDeclPrintingHelper()

DumpValueObjectOptions::DeclPrintingHelper Language::GetDeclPrintingHelper ( )

virtual

Definition at line 439 of file Language.cpp.

GetDefaultExceptionResolverDescription()

void Language::GetDefaultExceptionResolverDescription ( bool  catch_on, bool  throw_on, Stream &  s  )

static

Definition at line 463 of file Language.cpp.

References lldb_private::Stream::Printf().

Referenced by ExceptionBreakpointResolver::GetDescription().

GetDemangledFunctionNameWithoutArguments()

virtual ConstString lldb_private::Language::GetDemangledFunctionNameWithoutArguments ( Mangled  mangled ) const

inlinevirtual

Reimplemented in lldb_private::CPlusPlusLanguage.

Definition at line 257 of file Language.h.

GetExceptionResolverDescription()

void Language::GetExceptionResolverDescription ( bool  catch_on, bool  throw_on, Stream &  s  )

virtual

Definition at line 458 of file Language.cpp.

Referenced by ExceptionBreakpointResolver::GetDescription().

GetFormatterPrefixSuffix()

bool Language::GetFormatterPrefixSuffix ( ValueObject &  valobj, ConstString  type_hint, std::string &  prefix, std::string &  suffix  )

virtual

Reimplemented in lldb_private::ObjCLanguage.

Definition at line 424 of file Language.cpp.

GetFormatters()

lldb::TypeCategoryImplSP Language::GetFormatters ( )

virtual

Reimplemented in lldb_private::ObjCLanguage, and lldb_private::CPlusPlusLanguage.

Definition at line 132 of file Language.cpp.

GetFunctionDisplayName()

bool Language::GetFunctionDisplayName ( const SymbolContext *  sc, const ExecutionContext *  exe_ctx, FunctionNameRepresentation  representation, Stream &  s  )

virtual

Reimplemented in lldb_private::CPlusPlusLanguage.

Definition at line 451 of file Language.cpp.

Referenced by lldb_private::FormatEntity::Format().

GetHardcodedFormats()

HardcodedFormatters::HardcodedFormatFinder Language::GetHardcodedFormats ( )

virtual

Definition at line 134 of file Language.cpp.

GetHardcodedSummaries()

HardcodedFormatters::HardcodedSummaryFinder Language::GetHardcodedSummaries ( )

virtual

Reimplemented in lldb_private::CPlusPlusLanguage.

Definition at line 138 of file Language.cpp.

GetHardcodedSynthetics()

HardcodedFormatters::HardcodedSyntheticFinder Language::GetHardcodedSynthetics ( )

virtual

Reimplemented in lldb_private::CPlusPlusLanguage.

Definition at line 143 of file Language.cpp.

GetHighlighter()

virtual const Highlighter* lldb_private::Language::GetHighlighter ( ) const

inlinevirtual

Reimplemented in lldb_private::ObjCLanguage, lldb_private::CPlusPlusLanguage, and lldb_private::ObjCPlusPlusLanguage.

Definition at line 167 of file Language.h.

Referenced by lldb_private::HighlighterManager::getHighlighterFor().

GetLanguageSpecificTypeLookupHelp()

const char * Language::GetLanguageSpecificTypeLookupHelp ( )

virtual

Definition at line 374 of file Language.cpp.

GetLanguagesSupportingREPLs()

LanguageSet Language::GetLanguagesSupportingREPLs ( )

static

Definition at line 366 of file Language.cpp.

Referenced by lldb_private::Target::GetREPL(), and lldb_private::Debugger::RunREPL().

GetLanguagesSupportingTypeSystems()

LanguageSet Language::GetLanguagesSupportingTypeSystems ( )

static

Definition at line 358 of file Language.cpp.

Referenced by lldb_private::CommandCompletions::TypeLanguages().

GetLanguagesSupportingTypeSystemsForExpressions()

LanguageSet Language::GetLanguagesSupportingTypeSystemsForExpressions ( )

static

Definition at line 362 of file Language.cpp.

Referenced by lldb_private::Target::GetScratchTypeSystemForLanguage(), and lldb_private::Target::GetScratchTypeSystems().

GetLanguageType()

virtual lldb::LanguageType lldb_private::Language::GetLanguageType ( ) const

pure virtual

Implemented in lldb_private::CPlusPlusLanguage, lldb_private::ObjCLanguage, and lldb_private::ObjCPlusPlusLanguage.

Referenced by GetSupportedLanguages().

GetLanguageTypeFromString() [1/2]

static lldb::LanguageType lldb_private::Language::GetLanguageTypeFromString ( const char *  string )

staticdelete

Referenced by lldb_private::BreakpointResolverName::CreateFromStructuredData(), and lldb_private::Property::Property().

GetLanguageTypeFromString() [2/2]

LanguageType Language::GetLanguageTypeFromString ( llvm::StringRef  string )

static

Definition at line 208 of file Language.cpp.

References lldb::eLanguageTypeUnknown, and language_names.

GetMethodNameVariants()

virtual std::vector<Language::MethodNameVariant> lldb_private::Language::GetMethodNameVariants ( ConstString  method_name ) const

inlinevirtual

Reimplemented in lldb_private::ObjCLanguage.

Definition at line 200 of file Language.h.

GetNameForLanguageType()

const char * Language::GetNameForLanguageType ( lldb::LanguageType  language )

static

Definition at line 217 of file Language.cpp.

References lldb::eLanguageTypeUnknown, language_names, language_name_pair::name, and num_languages.

Referenced by lldb_private::ClangExpressionParser::ClangExpressionParser(), lldb_private::Target::CreateUtilityFunction(), lldb_private::FormatEntity::Format(), lldb_private::CompileUnit::GetCachedLanguage(), lldb_private::BreakpointResolverName::GetDescription(), lldb_private::TypeCategoryImpl::GetDescription(), lldb_private::Target::GetFunctionCallerForLanguage(), lldb_private::Target::GetPersistentExpressionStateForLanguage(), lldb_private::Target::GetREPL(), lldb_private::Target::GetScratchTypeSystems(), lldb_private::TypeSystemMap::GetTypeSystemForLanguage(), lldb_private::Target::GetUserExpressionForLanguage(), lldb_private::ClangExpressionParser::PrepareForExecution(), lldb_private::Module::ReportWarningUnsupportedLanguage(), lldb_private::Debugger::RunREPL(), lldb_private::BreakpointResolverName::SerializeToStructuredData(), and lldb_private::CommandCompletions::TypeLanguages().

GetNilReferenceSummaryString()

virtual llvm::StringRef lldb_private::Language::GetNilReferenceSummaryString ( )

inlinevirtual

Returns the summary string for ValueObjects for which IsNilReference() is true.

Reimplemented in lldb_private::ObjCLanguage, lldb_private::CPlusPlusLanguage, and lldb_private::ObjCPlusPlusLanguage.

Definition at line 243 of file Language.h.

GetPossibleFormattersMatches()

std::vector< FormattersMatchCandidate > Language::GetPossibleFormattersMatches ( ValueObject &  valobj, lldb::DynamicValueType  use_dynamic  )

virtual

Reimplemented in lldb_private::ObjCLanguage.

Definition at line 148 of file Language.cpp.

GetPrimaryLanguage()

LanguageType Language::GetPrimaryLanguage ( lldb::LanguageType  language )

static

Definition at line 301 of file Language.cpp.

References lldb::eLanguageTypeAda83, lldb::eLanguageTypeAda95, lldb::eLanguageTypeC, lldb::eLanguageTypeC11, lldb::eLanguageTypeC89, lldb::eLanguageTypeC99, lldb::eLanguageTypeC_plus_plus, lldb::eLanguageTypeC_plus_plus_03, lldb::eLanguageTypeC_plus_plus_11, lldb::eLanguageTypeC_plus_plus_14, lldb::eLanguageTypeCobol74, lldb::eLanguageTypeCobol85, lldb::eLanguageTypeD, lldb::eLanguageTypeDylan, lldb::eLanguageTypeExtRenderScript, lldb::eLanguageTypeFortran03, lldb::eLanguageTypeFortran08, lldb::eLanguageTypeFortran77, lldb::eLanguageTypeFortran90, lldb::eLanguageTypeFortran95, lldb::eLanguageTypeGo, lldb::eLanguageTypeHaskell, lldb::eLanguageTypeJava, lldb::eLanguageTypeJulia, lldb::eLanguageTypeMipsAssembler, lldb::eLanguageTypeModula2, lldb::eLanguageTypeModula3, lldb::eLanguageTypeObjC, lldb::eLanguageTypeObjC_plus_plus, lldb::eLanguageTypeOCaml, lldb::eLanguageTypeOpenCL, lldb::eLanguageTypePascal83, lldb::eLanguageTypePLI, lldb::eLanguageTypePython, lldb::eLanguageTypeRust, lldb::eLanguageTypeSwift, lldb::eLanguageTypeUnknown, and lldb::eLanguageTypeUPC.

Referenced by lldb_private::Process::GetLanguageRuntime(), and lldb_private::BreakpointResolverName::SearchCallback().

GetSupportedLanguages()

std::set< lldb::LanguageType > Language::GetSupportedLanguages ( )

static

Definition at line 349 of file Language.cpp.

References GetLanguageType().

Referenced by lldb_private::Process::GetLanguageRuntimes(), lldb_private::LanguageRuntime::GetRuntimeUnwindPlan(), and lldb_private::Process::ModulesDidLoad().

GetTypeScavenger()

std::unique_ptr< Language::TypeScavenger > Language::GetTypeScavenger ( )

virtual

Reimplemented in lldb_private::ObjCLanguage, and lldb_private::CPlusPlusLanguage.

Definition at line 370 of file Language.cpp.

IsLogicalTrue()

LazyBool Language::IsLogicalTrue ( ValueObject &  valobj, Status &  error  )

virtual

Definition at line 443 of file Language.cpp.

References lldb_private::eLazyBoolCalculate.

IsNilReference()

bool Language::IsNilReference ( ValueObject &  valobj )

virtual

Reimplemented in lldb_private::ObjCLanguage, and lldb_private::CPlusPlusLanguage.

Definition at line 447 of file Language.cpp.

IsSourceFile()

virtual bool lldb_private::Language::IsSourceFile ( llvm::StringRef  file_path ) const

pure virtual

Implemented in lldb_private::ObjCLanguage, lldb_private::CPlusPlusLanguage, and lldb_private::ObjCPlusPlusLanguage.

Referenced by FindPlugin().

IsTopLevelFunction()

bool Language::IsTopLevelFunction ( Function &  function )

virtual

Definition at line 130 of file Language.cpp.

IsUninitializedReference()

bool Language::IsUninitializedReference ( ValueObject &  valobj )

virtual

Definition at line 449 of file Language.cpp.

LanguageIsC()

bool Language::LanguageIsC ( lldb::LanguageType  language )

static

Definition at line 262 of file Language.cpp.

References lldb::eLanguageTypeC, lldb::eLanguageTypeC11, lldb::eLanguageTypeC89, and lldb::eLanguageTypeC99.

Referenced by lldb_private::ClangExpressionDeclMap::AddOneFunction().

LanguageIsCFamily()

bool Language::LanguageIsCFamily ( lldb::LanguageType  language )

static

Equivalent to LanguageIsC||LanguageIsObjC||LanguageIsCPlusPlus.

Definition at line 274 of file Language.cpp.

References lldb::eLanguageTypeC, lldb::eLanguageTypeC11, lldb::eLanguageTypeC89, lldb::eLanguageTypeC99, lldb::eLanguageTypeC_plus_plus, lldb::eLanguageTypeC_plus_plus_03, lldb::eLanguageTypeC_plus_plus_11, lldb::eLanguageTypeC_plus_plus_14, lldb::eLanguageTypeObjC, and lldb::eLanguageTypeObjC_plus_plus.

Referenced by lldb_private::ValueObject::GetObjectDescription().

LanguageIsCPlusPlus()

bool Language::LanguageIsCPlusPlus ( lldb::LanguageType  language )

static

Definition at line 239 of file Language.cpp.

References lldb::eLanguageTypeC_plus_plus, lldb::eLanguageTypeC_plus_plus_03, lldb::eLanguageTypeC_plus_plus_11, lldb::eLanguageTypeC_plus_plus_14, and lldb::eLanguageTypeObjC_plus_plus.

Referenced by lldb_private::ClangExpressionDeclMap::AddOneFunction().

LanguageIsObjC()

bool Language::LanguageIsObjC ( lldb::LanguageType  language )

static

Definition at line 252 of file Language.cpp.

References lldb::eLanguageTypeObjC, and lldb::eLanguageTypeObjC_plus_plus.

Referenced by lldb_private::ClangExpressionDeclMap::AddOneFunction(), and lldb_private::ValueObject::Dereference().

LanguageIsPascal()

bool Language::LanguageIsPascal ( lldb::LanguageType  language )

static

Definition at line 292 of file Language.cpp.

References lldb::eLanguageTypePascal83.

operator=()

const Language& lldb_private::Language::operator= ( const Language &  )

privatedelete

PrintAllLanguages()

void Language::PrintAllLanguages ( Stream &  s, const char *  prefix, const char *  suffix  )

static

Definition at line 224 of file Language.cpp.

References language_names, language_name_pair::name, num_languages, and lldb_private::Stream::Printf().

SymbolNameFitsToLanguage()

virtual bool lldb_private::Language::SymbolNameFitsToLanguage ( Mangled  name ) const

inlinevirtual

Returns true iff the given symbol name is compatible with the mangling scheme of this language.

This function should only return true if there is a high confidence that the name actually belongs to this language.

Reimplemented in lldb_private::CPlusPlusLanguage, and lldb_private::ObjCLanguage.

Definition at line 209 of file Language.h.

---

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

• Language.h
• Language.cpp