A class that encapsulates name lookup information. More...

#include "lldb/Core/Module.h"

Public Member Functions
	LookupInfo ()=default
ConstString	GetName () const
void	SetName (ConstString name)
ConstString	GetLookupName () const
void	SetLookupName (ConstString name)
lldb::FunctionNameType	GetNameTypeMask () const
void	SetNameTypeMask (lldb::FunctionNameType mask)
lldb::LanguageType	GetLanguageType () const
bool	NameMatchesLookupInfo (ConstString function_name, lldb::LanguageType language_type=lldb::eLanguageTypeUnknown) const
void	Prune (SymbolContextList &sc_list, size_t start_idx) const

Static Public Member Functions
static std::vector< LookupInfo >	MakeLookupInfos (ConstString name, lldb::FunctionNameType name_type_mask, lldb::LanguageType lang_type)
	Creates a vector of lookup infos for function name resolution.

Protected Attributes
ConstString	m_name
	What the user originally typed.
ConstString	m_lookup_name
	The actual name will lookup when calling in the object or symbol file.
lldb::LanguageType	m_language = lldb::eLanguageTypeUnknown
	Limit matches to only be for this language.
lldb::FunctionNameType	m_name_type_mask = lldb::eFunctionNameTypeNone
	One or more bits from lldb::FunctionNameType that indicate what kind of names we are looking for.
bool	m_match_name_after_lookup = false
	If true, then demangled names that match will need to contain "m_name" in order to be considered a match.

Private Member Functions
	LookupInfo (ConstString name, lldb::FunctionNameType name_type_mask, lldb::LanguageType lang_type)

Detailed Description

A class that encapsulates name lookup information.

Users can type a wide variety of partial names when setting breakpoints by name or when looking for functions by name. The SymbolFile object is only required to implement name lookup for function basenames and for fully mangled names. This means if the user types in a partial name, we must reduce this to a name lookup that will work with all SymbolFile objects. So we might reduce a name lookup to look for a basename, and then prune out any results that don't match.

The "m_name" member variable represents the name as it was typed by the user. "m_lookup_name" will be the name we actually search for through the symbol or objects files. Lanaguage is included in case we need to filter results by language at a later date. The "m_name_type_mask" member variable tells us what kinds of names we are looking for and can help us prune out unwanted results.

Function lookups are done in Module.cpp, ModuleList.cpp and in BreakpointResolverName.cpp and they all now use this class to do lookups correctly.

Definition at line 908 of file Module.h.

Constructor & Destructor Documentation

◆ LookupInfo() [1/2]

lldb_private::Module::LookupInfo::LookupInfo ( )

default

◆ LookupInfo() [2/2]

lldb_private::Module::LookupInfo::LookupInfo	(	ConstString	name,
		lldb::FunctionNameType	name_type_mask,
		lldb::LanguageType	lang_type )

private

Member Function Documentation

◆ GetLanguageType()

lldb::LanguageType lldb_private::Module::LookupInfo::GetLanguageType ( ) const

inline

Definition at line 950 of file Module.h.

References m_language.

Referenced by lldb_private::plugin::dwarf::DWARFIndex::ProcessFunctionDIE().

◆ GetLookupName()

ConstString lldb_private::Module::LookupInfo::GetLookupName ( ) const

inline

Definition at line 940 of file Module.h.

References m_lookup_name.

◆ GetName()

ConstString lldb_private::Module::LookupInfo::GetName ( ) const

inline

Definition at line 936 of file Module.h.

References m_name.

Referenced by lldb_private::npdb::SymbolFileNativePDB::FindFunctions(), and SymbolFilePDB::FindFunctions().

◆ GetNameTypeMask()

lldb::FunctionNameType lldb_private::Module::LookupInfo::GetNameTypeMask ( ) const

inline

Definition at line 944 of file Module.h.

References m_name_type_mask.

Referenced by lldb_private::npdb::SymbolFileNativePDB::FindFunctions(), lldb_private::plugin::dwarf::SymbolFileDWARF::FindFunctions(), lldb_private::SymbolFileOnDemand::FindFunctions(), SymbolFilePDB::FindFunctions(), lldb_private::plugin::dwarf::ManualDWARFIndex::GetFunctions(), and lldb_private::plugin::dwarf::DWARFIndex::ProcessFunctionDIE().

◆ MakeLookupInfos()

std::vector< Module::LookupInfo > Module::LookupInfo::MakeLookupInfos	(	ConstString	name,
		lldb::FunctionNameType	name_type_mask,
		lldb::LanguageType	lang_type )

static

Creates a vector of lookup infos for function name resolution.

Parameters

[in]	name	The function name to search for. This can be a simple name like "foo" or a qualified name like "Class::method".
[in]	name_type_mask	A bitmask specifying what types of names to search for (e.g., eFunctionNameTypeFull, eFunctionNameTypeBase, eFunctionNameTypeMethod, eFunctionNameTypeAuto). Multiple types can be combined with bitwise OR.
[in]	lang_type	The language to create lookups for. If eLanguageTypeUnknown is passed, creates one LookupInfo for each language plugin currently available in LLDB. If a specific language is provided, creates only

Returns: A vector of LookupInfo objects, one per relevant language.

Definition at line 700 of file Module.cpp.

References lldb_private::Continue, lldb::eLanguageTypeC_plus_plus, lldb::eLanguageTypeObjC, lldb::eLanguageTypeUnknown, lldb_private::Language::ForEach(), and lldb_private::Language::GetLanguageType().

Referenced by lldb_private::BreakpointResolverName::AddNameLookup(), lldb_private::plugin::dwarf::SymbolFileDWARF::FindFunctionDefinition(), and lldb_private::ModuleList::FindFunctionSymbols().

◆ NameMatchesLookupInfo()

bool Module::LookupInfo::NameMatchesLookupInfo	(	ConstString	function_name,
		lldb::LanguageType	language_type = lldb::eLanguageTypeUnknown ) const

Definition at line 729 of file Module.cpp.

References lldb_private::Mangled::eManglingSchemeNone, lldb_private::Language::FindPlugin(), lldb_private::Mangled::GetDemangledName(), lldb_private::Mangled::GetManglingScheme(), and m_name.

Referenced by lldb_private::plugin::dwarf::DWARFIndex::ProcessFunctionDIE(), and Prune().

◆ Prune()

void Module::LookupInfo::Prune	(	SymbolContextList &	sc_list,
		size_t	start_idx ) const

Definition at line 762 of file Module.cpp.

References lldb::eLanguageTypeC_plus_plus, lldb_private::Mangled::ePreferMangled, lldb_private::Language::FindPlugin(), lldb_private::SymbolContextList::GetContextAtIndex(), lldb_private::SymbolContext::GetFunctionName(), lldb_private::SymbolContext::GetLanguage(), lldb_private::Language::GetMethodName(), lldb_private::SymbolContextList::GetSize(), m_match_name_after_lookup, m_name, m_name_type_mask, NameMatchesLookupInfo(), and lldb_private::SymbolContextList::RemoveContextAtIndex().

◆ SetLookupName()

void lldb_private::Module::LookupInfo::SetLookupName ( ConstString name )

inline

Definition at line 942 of file Module.h.

References m_lookup_name.

Referenced by lldb_private::plugin::dwarf::SymbolFileDWARF::FindFunctions().

◆ SetName()

void lldb_private::Module::LookupInfo::SetName ( ConstString name )

inline

Definition at line 938 of file Module.h.

References m_name.

◆ SetNameTypeMask()

void lldb_private::Module::LookupInfo::SetNameTypeMask ( lldb::FunctionNameType mask )

inline

Definition at line 946 of file Module.h.

References m_name_type_mask.

Member Data Documentation

◆ m_language

lldb::LanguageType lldb_private::Module::LookupInfo::m_language = lldb::eLanguageTypeUnknown

protected

Limit matches to only be for this language.

Definition at line 966 of file Module.h.

Referenced by GetLanguageType().

◆ m_lookup_name

ConstString lldb_private::Module::LookupInfo::m_lookup_name

protected

The actual name will lookup when calling in the object or symbol file.

Definition at line 963 of file Module.h.

Referenced by GetLookupName(), and SetLookupName().

◆ m_match_name_after_lookup

bool lldb_private::Module::LookupInfo::m_match_name_after_lookup = false

protected

If true, then demangled names that match will need to contain "m_name" in order to be considered a match.

Definition at line 974 of file Module.h.

Referenced by Prune().

◆ m_name

ConstString lldb_private::Module::LookupInfo::m_name

protected

What the user originally typed.

Definition at line 960 of file Module.h.

Referenced by GetName(), NameMatchesLookupInfo(), Prune(), and SetName().

◆ m_name_type_mask

lldb::FunctionNameType lldb_private::Module::LookupInfo::m_name_type_mask = lldb::eFunctionNameTypeNone

protected

One or more bits from lldb::FunctionNameType that indicate what kind of names we are looking for.

Definition at line 970 of file Module.h.

Referenced by GetNameTypeMask(), Prune(), and SetNameTypeMask().

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

Public Member Functions

Static Public Member Functions

Protected Attributes

Private Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ LookupInfo() [1/2]

◆ LookupInfo() [2/2]

Member Function Documentation

◆ GetLanguageType()

◆ GetLookupName()

◆ GetName()

◆ GetNameTypeMask()

◆ MakeLookupInfos()

◆ NameMatchesLookupInfo()

◆ Prune()

◆ SetLookupName()

◆ SetName()

◆ SetNameTypeMask()

Member Data Documentation

◆ m_language

◆ m_lookup_name

◆ m_match_name_after_lookup

◆ m_name

◆ m_name_type_mask