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

#include "lldb/Core/Module.h"

Public Member Functions
	LookupInfo ()=default
	LookupInfo (ConstString name, lldb::FunctionNameType name_type_mask, lldb::LanguageType language)
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

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.

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 916 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	language )

Member Function Documentation

◆ GetLanguageType()

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

inline

Definition at line 937 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 927 of file Module.h.

References m_lookup_name.

◆ GetName()

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

inline

Definition at line 923 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 931 of file Module.h.

References m_name_type_mask.

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

◆ NameMatchesLookupInfo()

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

Definition at line 717 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 750 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::SymbolContextList::GetSize(), m_match_name_after_lookup, m_name, m_name_type_mask, NameMatchesLookupInfo(), and lldb_private::SymbolContextList::RemoveContextAtIndex().

Referenced by lldb_private::ModuleList::FindFunctionSymbols().

◆ SetLookupName()

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

inline

Definition at line 929 of file Module.h.

References m_lookup_name.

Referenced by lldb_private::BreakpointResolverName::AddNameLookup(), and lldb_private::plugin::dwarf::SymbolFileDWARF::FindFunctions().

◆ SetName()

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

inline

Definition at line 925 of file Module.h.

References m_name.

◆ SetNameTypeMask()

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

inline

Definition at line 933 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 953 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 950 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 961 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 947 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 957 of file Module.h.

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

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

Public Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ LookupInfo() [1/2]

◆ LookupInfo() [2/2]

Member Function Documentation

◆ GetLanguageType()

◆ GetLookupName()

◆ GetName()

◆ GetNameTypeMask()

◆ NameMatchesLookupInfo()

◆ Prune()

◆ SetLookupName()

◆ SetName()

◆ SetNameTypeMask()

Member Data Documentation

◆ m_language

◆ m_lookup_name

◆ m_match_name_after_lookup

◆ m_name

◆ m_name_type_mask