A file collection class. More...

#include "lldb/Utility/FileSpecList.h"

Public Types
typedef std::vector< FileSpec >	collection
typedef collection::const_iterator	const_iterator

Public Member Functions
	FileSpecList ()
	Default constructor.
	FileSpecList (const FileSpecList &rhs)=default
	Copy constructor.
	FileSpecList (FileSpecList &&rhs)=default
	Move constructor.
	FileSpecList (std::vector< FileSpec > &&rhs)
	Initialize this object from a vector of FileSpecs.
	~FileSpecList ()
	Destructor.
FileSpecList &	operator= (const FileSpecList &rhs)=default
	Assignment operator.
FileSpecList &	operator= (FileSpecList &&rhs)=default
	Move-assignment operator.
void	Append (const FileSpec &file)
	Append a FileSpec object to the list.
void	Append (const FileSpecList &other)
	Appends all elements of `other` to the end of this list (regardless of whether a `FileSpec` already exists in the list).
bool	AppendIfUnique (const FileSpec &file)
	Append a FileSpec object if unique.
template<class... Args>
void	EmplaceBack (Args &&...args)
	Inserts a new FileSpec into the FileSpecList constructed in-place with the given arguments.
void	Clear ()
	Clears the file list.
void	Dump (Stream s, const char separator_cstr="\n") const
	Dumps the file list to the supplied stream pointer "s".
size_t	FindFileIndex (size_t idx, const FileSpec &file, bool full) const
	Find a file index.
const FileSpec &	GetFileSpecAtIndex (size_t idx) const
	Get file at index.
bool	IsEmpty () const
size_t	GetSize () const
	Get the number of files in the file list.
bool	Insert (size_t idx, const FileSpec &file)
bool	Replace (size_t idx, const FileSpec &file)
bool	Remove (size_t idx)
const_iterator	begin () const
const_iterator	end () const
llvm::iterator_range< const_iterator >	files () const

Protected Attributes
collection	m_files
	A collection of FileSpec objects.

Detailed Description

A file collection class.

A class that contains a mutable list of FileSpec objects.

Definition at line 91 of file FileSpecList.h.

Member Typedef Documentation

◆ collection

typedef std::vector<FileSpec> lldb_private::FileSpecList::collection

Definition at line 93 of file FileSpecList.h.

◆ const_iterator

typedef collection::const_iterator lldb_private::FileSpecList::const_iterator

Definition at line 94 of file FileSpecList.h.

Constructor & Destructor Documentation

◆ FileSpecList() [1/4]

FileSpecList::FileSpecList ( )

Default constructor.

Initialize this object with an empty file list.

Definition at line 20 of file FileSpecList.cpp.

References m_files.

Referenced by Append(), FileSpecList(), FileSpecList(), operator=(), and operator=().

◆ FileSpecList() [2/4]

lldb_private::FileSpecList::FileSpecList ( const FileSpecList & rhs )

default

Copy constructor.

References FileSpecList().

◆ FileSpecList() [3/4]

lldb_private::FileSpecList::FileSpecList ( FileSpecList && rhs )

default

Move constructor.

References FileSpecList().

◆ FileSpecList() [4/4]

lldb_private::FileSpecList::FileSpecList ( std::vector< FileSpec > && rhs )

inline

Initialize this object from a vector of FileSpecs.

Definition at line 108 of file FileSpecList.h.

References m_files.

◆ ~FileSpecList()

FileSpecList::~FileSpecList ( )

default

Destructor.

Member Function Documentation

◆ Append() [1/2]

void FileSpecList::Append ( const FileSpec & file )

Append a FileSpec object to the list.

Appends file to the end of the file list.

Parameters

[in] file A new file to append to this file list.

Definition at line 25 of file FileSpecList.cpp.

References m_files.

Referenced by lldb_private::StructuredDataDarwinLog::AddInitCompletionHook(), lldb::SBTarget::BreakpointCreateByName(), lldb_private::Target::CreateBreakpoint(), lldb_private::Target::CreateBreakpointAtUserEntry(), lldb_private::AppleObjCRuntime::CreateExceptionSearchFilter(), lldb_private::plugin::dwarf::SymbolFileDWARF::GetDwoSymbolFileForCompileUnit(), lldb_private::plugin::dwarf::SymbolFileDWARF::GetDwpSymbolFile(), lldb_private::PlatformDarwin::GetSafeAutoLoadPaths(), lldb_private::Target::GetSafeAutoLoadPaths(), lldb_private::process_gdb_remote::ProcessGDBRemote::HandleAcceleratorBreakpoints(), ObjectFileMachO::ParseSymtab(), DynamicLoaderMacOS::SetNotificationBreakpoint(), DynamicLoaderDarwinKernel::SetNotificationBreakpointIfNeeded(), and DynamicLoaderPOSIXDYLD::SetRendezvousBreakpoint().

◆ Append() [2/2]

void lldb_private::FileSpecList::Append ( const FileSpecList & other )

inline

Appends all elements of other to the end of this list (regardless of whether a FileSpec already exists in the list).

Definition at line 137 of file FileSpecList.h.

References end(), FileSpecList(), and m_files.

◆ AppendIfUnique()

bool FileSpecList::AppendIfUnique ( const FileSpec & file )

Append a FileSpec object if unique.

Appends file to the end of the file list if it doesn't already exist in the file list.

Parameters

[in] file A new file to append to this file list.

Returns: true if the file was appended, false otherwise.

Definition at line 33 of file FileSpecList.cpp.

References end(), and m_files.

Referenced by ObjectFileELF::GetDependentModules(), ObjectFileMachO::GetDependentModules(), ObjectFilePECOFF::GetDependentModules(), GetModuleConfig(), lldb_private::SymbolLocatorDefault::LocateExecutableSymbolFile(), and lldb_private::Target::SetExecutableModule().

◆ begin()

const_iterator lldb_private::FileSpecList::begin ( ) const

inline

Definition at line 240 of file FileSpecList.h.

References m_files.

Referenced by files().

◆ Clear()

void FileSpecList::Clear ( )

Clears the file list.

Definition at line 55 of file FileSpecList.cpp.

References m_files.

Referenced by lldb_private::ObjectFileJIT::GetDependentModules().

◆ Dump()

void FileSpecList::Dump	(	Stream *	s,
		const char *	separator_cstr = "\n" ) const

Dumps the file list to the supplied stream pointer "s".

Parameters

[in] s The stream that will be used to dump the object description.

Definition at line 58 of file FileSpecList.cpp.

References lldb_private::Stream::AsRawOstream(), end(), m_files, and lldb_private::Stream::PutCString().

◆ EmplaceBack()

template<class... Args>

void lldb_private::FileSpecList::EmplaceBack ( Args &&... args )

inline

Inserts a new FileSpec into the FileSpecList constructed in-place with the given arguments.

Parameters

[in] args Arguments to create the FileSpec

Definition at line 158 of file FileSpecList.h.

References m_files.

Referenced by lldb_private::ItaniumABIRuntime::AppendExceptionBreakpointFilterModules(), lldb_private::SearchFilterByModuleListAndCU::CreateFromStructuredData(), lldb_private::Debugger::GetDefaultSafeAutoLoadPaths(), and lldb_private::PlatformDarwin::SetThreadCreationBreakpoint().

◆ end()

const_iterator lldb_private::FileSpecList::end ( ) const

inline

Definition at line 241 of file FileSpecList.h.

References m_files.

Referenced by Append(), AppendIfUnique(), Dump(), and files().

◆ files()

llvm::iterator_range< const_iterator > lldb_private::FileSpecList::files ( ) const

inline

Definition at line 243 of file FileSpecList.h.

References begin(), and end().

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

◆ FindFileIndex()

size_t FileSpecList::FindFileIndex	(	size_t	idx,
		const FileSpec &	file,
		bool	full ) const

Find a file index.

Find the index of the file in the file spec list that matches file starting idx entries into the file spec list.

Parameters

[in]	idx	An index into the file list.
[in]	file	The file specification to search for.
[in]	full	Should FileSpec::Equal be called with "full" true or false.

Returns: The index of the file that matches file if it is found, else UINT32_MAX is returned.

Definition at line 94 of file FileSpecList.cpp.

References m_files.

◆ GetFileSpecAtIndex()

const FileSpec & FileSpecList::GetFileSpecAtIndex ( size_t idx ) const

Get file at index.

Gets a file from the file list. If idx is not a valid index, an empty FileSpec object will be returned. The file objects that are returned can be tested using FileSpec::operator void*().

Parameters

[in] idx An index into the file list.

Returns: A copy of the FileSpec object at index idx. If idx is out of range, then an empty FileSpec object will be returned.

Definition at line 197 of file FileSpecList.cpp.

References m_files.

Referenced by lldb_private::ClangModulesDeclVendor::Create(), CommandObjectTargetVariable::DoExecute(), lldb_private::PlatformDarwin::FindBundleBinaryInExecSearchPaths(), lldb_private::ThreadPlanStepInRange::FrameMatchesAvoidCriteria(), lldb_private::plugin::dwarf::SymbolFileDWARF::GetDwoSymbolFileForCompileUnit(), lldb_private::ModuleList::GetSharedModule(), lldb_private::PlatformDarwin::GetSharedModule(), lldb_private::SymbolLocatorDefault::LocateExecutableSymbolFile(), ObjectFileMachO::ParseSymtab(), lldb_private::Symbol::ResolveReExportedSymbolInModuleSpec(), lldb_private::SearchFilter::SerializeFileSpecList(), and lldb_private::Target::SetExecutableModule().

◆ GetSize()

size_t FileSpecList::GetSize ( ) const

Get the number of files in the file list.

Returns: The number of files in the file spec list.

Definition at line 218 of file FileSpecList.cpp.

References m_files.

Referenced by lldb_private::ClangModulesDeclVendor::Create(), lldb_private::Target::CreateScriptedBreakpoint(), CommandObjectTargetVariable::DoExecute(), lldb_private::PlatformDarwin::FindBundleBinaryInExecSearchPaths(), lldb_private::ThreadPlanStepInRange::FrameMatchesAvoidCriteria(), ObjectFilePECOFF::GetDependentModules(), lldb_private::plugin::dwarf::SymbolFileDWARF::GetDwoSymbolFileForCompileUnit(), GetModuleConfig(), lldb_private::Target::GetSearchFilterForModuleAndCUList(), lldb_private::Target::GetSearchFilterForModuleList(), lldb_private::ModuleList::GetSharedModule(), lldb_private::PlatformDarwin::GetSharedModule(), lldb_private::process_gdb_remote::ProcessGDBRemote::HandleAcceleratorBreakpoints(), lldb_private::SymbolLocatorDefault::LocateExecutableSymbolFile(), ObjectFileMachO::ParseSymtab(), lldb_private::RealpathPrefixes::RealpathPrefixes(), lldb_private::Symbol::ResolveReExportedSymbolInModuleSpec(), lldb_private::SearchFilter::SerializeFileSpecList(), and lldb_private::Target::SetExecutableModule().

◆ Insert()

bool lldb_private::FileSpecList::Insert	(	size_t	idx,
		const FileSpec &	file )

inline

Definition at line 213 of file FileSpecList.h.

References m_files.

Referenced by SymbolVendorPECOFF::CreateInstance().

◆ IsEmpty()

bool lldb_private::FileSpecList::IsEmpty ( ) const

inline

Definition at line 205 of file FileSpecList.h.

References m_files.

Referenced by lldb_private::PlatformDarwin::FindBundleBinaryInExecSearchPaths(), lldb_private::ModuleList::GetSharedModule(), and lldb_private::PlatformDarwin::GetSharedModule().

◆ operator=() [1/2]

FileSpecList & lldb_private::FileSpecList::operator= ( const FileSpecList & rhs )

default

Assignment operator.

Replace the file list in this object with the file list from rhs.

Parameters

[in] rhs A file list object to copy.

Returns: A const reference to this object.

References FileSpecList().

◆ operator=() [2/2]

FileSpecList & lldb_private::FileSpecList::operator= ( FileSpecList && rhs )

default

Move-assignment operator.

References FileSpecList().

◆ Remove()

bool lldb_private::FileSpecList::Remove ( size_t idx )

inline

Definition at line 232 of file FileSpecList.h.

References m_files.

◆ Replace()

bool lldb_private::FileSpecList::Replace	(	size_t	idx,
		const FileSpec &	file )

inline

Definition at line 224 of file FileSpecList.h.

References m_files.

Member Data Documentation

◆ m_files

collection lldb_private::FileSpecList::m_files

protected

A collection of FileSpec objects.

Definition at line 248 of file FileSpecList.h.

Referenced by Append(), Append(), AppendIfUnique(), begin(), Clear(), Dump(), EmplaceBack(), end(), FileSpecList(), FileSpecList(), FindFileIndex(), GetFileSpecAtIndex(), GetSize(), Insert(), IsEmpty(), Remove(), and Replace().

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

Public Types

Public Member Functions

Protected Attributes

Detailed Description

Member Typedef Documentation

◆ collection

◆ const_iterator

Constructor & Destructor Documentation

◆ FileSpecList() [1/4]

◆ FileSpecList() [2/4]

◆ FileSpecList() [3/4]

◆ FileSpecList() [4/4]

◆ ~FileSpecList()

Member Function Documentation

◆ Append() [1/2]

◆ Append() [2/2]

◆ AppendIfUnique()

◆ begin()

◆ Clear()

◆ Dump()

◆ EmplaceBack()

◆ end()

◆ files()

◆ FindFileIndex()

◆ GetFileSpecAtIndex()

◆ GetSize()

◆ Insert()

◆ IsEmpty()

◆ operator=() [1/2]

◆ operator=() [2/2]

◆ Remove()

◆ Replace()

Member Data Documentation

◆ m_files