#include <CommandObjectMultiword.h>

Inherits lldb_private::CommandObject.

Collaboration diagram for lldb_private::CommandObjectMultiword:

[legend]

Public Member Functions
	CommandObjectMultiword (CommandInterpreter &interpreter, const char name, const char help=nullptr, const char *syntax=nullptr, uint32_t flags=0)

	~CommandObjectMultiword () override

bool	IsMultiwordObject () override

CommandObjectMultiword *	GetAsMultiwordCommand () override

bool	LoadSubCommand (llvm::StringRef cmd_name, const lldb::CommandObjectSP &command_obj) override

llvm::Error	LoadUserSubcommand (llvm::StringRef cmd_name, const lldb::CommandObjectSP &command_obj, bool can_replace) override

llvm::Error	RemoveUserSubcommand (llvm::StringRef cmd_name, bool multiword_okay)

void	GenerateHelpText (Stream &output_stream) override

lldb::CommandObjectSP	GetSubcommandSP (llvm::StringRef sub_cmd, StringList *matches=nullptr) override

lldb::CommandObjectSP	GetSubcommandSPExact (llvm::StringRef sub_cmd) override

CommandObject *	GetSubcommandObject (llvm::StringRef sub_cmd, StringList *matches=nullptr) override

void	AproposAllSubCommands (llvm::StringRef prefix, llvm::StringRef search_word, StringList &commands_found, StringList &commands_help) override

bool	WantsRawCommandString () override

void	HandleCompletion (CompletionRequest &request) override
	This default version handles calling option argument completions and then calls HandleArgumentCompletion if the cursor is on an argument, not an option. More...

const char *	GetRepeatCommand (Args &current_command_args, uint32_t index) override
	Get the command that appropriate for a "repeat" of the current command. More...

bool	Execute (const char *args_string, CommandReturnObject &result) override

bool	IsRemovable () const override

void	SetRemovable (bool removable)

Public Member Functions inherited from lldb_private::CommandObject
	CommandObject (CommandInterpreter &interpreter, llvm::StringRef name, llvm::StringRef help="", llvm::StringRef syntax="", uint32_t flags=0)

virtual	~CommandObject ()=default

CommandInterpreter &	GetCommandInterpreter ()

Debugger &	GetDebugger ()

virtual llvm::StringRef	GetHelp ()

virtual llvm::StringRef	GetHelpLong ()

virtual llvm::StringRef	GetSyntax ()

llvm::StringRef	GetCommandName () const

virtual void	SetHelp (llvm::StringRef str)

virtual void	SetHelpLong (llvm::StringRef str)

void	SetSyntax (llvm::StringRef str)

bool	IsUserCommand ()

void	SetIsUserCommand (bool is_user)

virtual bool	IsAlias ()

virtual bool	IsDashDashCommand ()

void	FormatLongHelpText (Stream &output_strm, llvm::StringRef long_help)

void	GenerateHelpText (CommandReturnObject &result)

virtual bool	WantsCompletion ()

virtual Options *	GetOptions ()

int	GetNumArgumentEntries ()

CommandArgumentEntry *	GetArgumentEntryAtIndex (int idx)

void	GetFormattedCommandArguments (Stream &str, uint32_t opt_set_mask=LLDB_OPT_SET_ALL)

bool	IsPairType (ArgumentRepetitionType arg_repeat_type)

bool	ParseOptions (Args &args, CommandReturnObject &result)

void	SetCommandName (llvm::StringRef name)

virtual void	HandleArgumentCompletion (CompletionRequest &request, OptionElementVector &opt_element_vector)
	The input array contains a parsed version of the line. More...

bool	HelpTextContainsWord (llvm::StringRef search_word, bool search_short_help=true, bool search_long_help=true, bool search_syntax=true, bool search_options=true)

Flags &	GetFlags ()
	The flags accessor. More...

const Flags &	GetFlags () const
	The flags const accessor. More...

bool	HasOverrideCallback () const

void	SetOverrideCallback (lldb::CommandOverrideCallback callback, void *baton)

void	SetOverrideCallback (lldb::CommandOverrideCallbackWithResult callback, void *baton)

bool	InvokeOverrideCallback (const char **argv, CommandReturnObject &result)

Protected Member Functions
CommandObject::CommandMap &	GetSubcommandDictionary ()

Protected Member Functions inherited from lldb_private::CommandObject
bool	ParseOptionsAndNotify (Args &args, CommandReturnObject &result, OptionGroupOptions &group_options, ExecutionContext &exe_ctx)

virtual const char *	GetInvalidTargetDescription ()

virtual const char *	GetInvalidProcessDescription ()

virtual const char *	GetInvalidThreadDescription ()

virtual const char *	GetInvalidFrameDescription ()

virtual const char *	GetInvalidRegContextDescription ()

Target &	GetSelectedOrDummyTarget (bool prefer_dummy=false)

Target &	GetSelectedTarget ()

Target &	GetDummyTarget ()

Thread *	GetDefaultThread ()

bool	CheckRequirements (CommandReturnObject &result)
	Check the command to make sure anything required by this command is available. More...

void	Cleanup ()

Protected Attributes
CommandObject::CommandMap	m_subcommand_dict

bool	m_can_be_removed

Protected Attributes inherited from lldb_private::CommandObject
CommandInterpreter &	m_interpreter

ExecutionContext	m_exe_ctx

std::unique_lock< std::recursive_mutex >	m_api_locker

std::string	m_cmd_name

std::string	m_cmd_help_short

std::string	m_cmd_help_long

std::string	m_cmd_syntax

Flags	m_flags

std::vector< CommandArgumentEntry >	m_arguments

lldb::CommandOverrideCallback	m_deprecated_command_override_callback

lldb::CommandOverrideCallbackWithResult	m_command_override_callback

void *	m_command_override_baton

bool	m_is_user_command = false

Friends
class	CommandInterpreter

class	CommandObjectSyntax

Additional Inherited Members
Public Types inherited from lldb_private::CommandObject
typedef llvm::StringRef()	ArgumentHelpCallbackFunction()

typedef std::vector< CommandArgumentData >	CommandArgumentEntry

typedef std::map< std::string, lldb::CommandObjectSP >	CommandMap

Static Public Member Functions inherited from lldb_private::CommandObject
static const char *	GetArgumentTypeAsCString (const lldb::CommandArgumentType arg_type)

static const char *	GetArgumentDescriptionAsCString (const lldb::CommandArgumentType arg_type)

static const ArgumentTableEntry *	GetArgumentTable ()

static lldb::CommandArgumentType	LookupArgumentName (llvm::StringRef arg_name)

static const ArgumentTableEntry *	FindArgumentDataByType (lldb::CommandArgumentType arg_type)

static void	GetArgumentHelp (Stream &str, lldb::CommandArgumentType arg_type, CommandInterpreter &interpreter)

static const char *	GetArgumentName (lldb::CommandArgumentType arg_type)

Static Public Attributes inherited from lldb_private::CommandObject
static ArgumentTableEntry	g_arguments_data [lldb::eArgTypeLastArg]

Static Protected Member Functions inherited from lldb_private::CommandObject
static void	AddIDsArgumentData (CommandArgumentEntry &arg, lldb::CommandArgumentType ID, lldb::CommandArgumentType IDRange)

Detailed Description

Definition at line 19 of file CommandObjectMultiword.h.

Constructor & Destructor Documentation

◆ CommandObjectMultiword()

CommandObjectMultiword::CommandObjectMultiword	(	CommandInterpreter &	interpreter,
		const char *	name,
		const char *	help = `nullptr`,
		const char *	syntax = `nullptr`,
		uint32_t	flags = `0`
	)

Definition at line 19 of file CommandObjectMultiword.cpp.

◆ ~CommandObjectMultiword()

CommandObjectMultiword::~CommandObjectMultiword ( )

overridedefault

Member Function Documentation

◆ AproposAllSubCommands()

void CommandObjectMultiword::AproposAllSubCommands	(	llvm::StringRef	prefix,
		llvm::StringRef	search_word,
		StringList &	commands_found,
		StringList &	commands_help
	)

overridevirtual

Reimplemented from lldb_private::CommandObject.

Definition at line 305 of file CommandObjectMultiword.cpp.

References lldb_private::StringList::AppendString(), lldb_private::CommandObject::AproposAllSubCommands(), lldb_private::CommandObject::GetHelp(), lldb_private::StreamString::GetString(), lldb_private::CommandObject::HelpTextContainsWord(), lldb_private::CommandObject::IsMultiwordObject(), and m_subcommand_dict.

◆ Execute()

bool CommandObjectMultiword::Execute	(	const char *	args_string,
		CommandReturnObject &	result
	)

overridevirtual

Implements lldb_private::CommandObject.

Definition at line 161 of file CommandObjectMultiword.cpp.

References lldb_private::CommandReturnObject::AppendError(), lldb_private::CommandReturnObject::AppendErrorWithFormat(), lldb_private::CommandReturnObject::AppendRawError(), lldb_private::CommandObject::Execute(), lldb_private::CommandObject::GenerateHelpText(), lldb_private::Args::GetArgumentCount(), lldb_private::CommandObject::GetCommandName(), lldb_private::StringList::GetSize(), GetSubcommandObject(), m_subcommand_dict, lldb_private::Args::Shift(), string(), and lldb_private::CommandReturnObject::Succeeded().

◆ GenerateHelpText()

void CommandObjectMultiword::GenerateHelpText ( Stream & output_stream )

overridevirtual

Reimplemented from lldb_private::CommandObject.

Definition at line 224 of file CommandObjectMultiword.cpp.

References lldb_private::FindLongestCommandWord(), lldb_private::CommandObject::GenerateHelpText(), lldb_private::CommandObject::m_interpreter, m_subcommand_dict, lldb_private::CommandInterpreter::OutputFormattedHelpText(), lldb_private::Stream::PutCString(), and string().

◆ GetAsMultiwordCommand()

CommandObjectMultiword* lldb_private::CommandObjectMultiword::GetAsMultiwordCommand ( )

inlineoverridevirtual

Reimplemented from lldb_private::CommandObject.

Definition at line 33 of file CommandObjectMultiword.h.

◆ GetRepeatCommand()

const char * CommandObjectMultiword::GetRepeatCommand	(	Args &	current_command_args,
		uint32_t	index
	)

overridevirtual

Get the command that appropriate for a "repeat" of the current command.

Parameters

[in] current_command_args The command arguments.

Returns: nullptr if there is no special repeat command - it will use the current command line. Otherwise a pointer to the command to be repeated. If the returned string is the empty string, the command won't be repeated.

Reimplemented from lldb_private::CommandObject.

Definition at line 293 of file CommandObjectMultiword.cpp.

References lldb_private::Args::GetArgumentCount(), lldb_private::CommandObject::GetRepeatCommand(), and GetSubcommandObject().

◆ GetSubcommandDictionary()

CommandObject::CommandMap& lldb_private::CommandObjectMultiword::GetSubcommandDictionary ( )

inlineprotected

Definition at line 73 of file CommandObjectMultiword.h.

References m_subcommand_dict.

◆ GetSubcommandObject()

CommandObject * CommandObjectMultiword::GetSubcommandObject	(	llvm::StringRef	sub_cmd,
		StringList *	matches = `nullptr`
	)

overridevirtual

Reimplemented from lldb_private::CommandObject.

Definition at line 75 of file CommandObjectMultiword.cpp.

References GetSubcommandSP().

Referenced by lldb_private::CommandCompletions::CompleteModifiableCmdPathArgs(), Execute(), GetRepeatCommand(), and HandleCompletion().

◆ GetSubcommandSP()

CommandObjectSP CommandObjectMultiword::GetSubcommandSP	(	llvm::StringRef	sub_cmd,
		StringList *	matches = `nullptr`
	)

overridevirtual

Reimplemented from lldb_private::CommandObject.

Definition at line 41 of file CommandObjectMultiword.cpp.

References lldb_private::AddNamesMatchingPartialString(), lldb_private::StringList::AppendString(), lldb_private::StringList::GetStringAtIndex(), GetSubcommandSPExact(), m_subcommand_dict, and string().

Referenced by GetSubcommandObject().

◆ GetSubcommandSPExact()

CommandObjectSP CommandObjectMultiword::GetSubcommandSPExact ( llvm::StringRef sub_cmd )

overridevirtual

Reimplemented from lldb_private::CommandObject.

Definition at line 30 of file CommandObjectMultiword.cpp.

References m_subcommand_dict, and string().

Referenced by GetSubcommandSP().

◆ HandleCompletion()

void CommandObjectMultiword::HandleCompletion ( CompletionRequest & request )

overridevirtual

This default version handles calling option argument completions and then calls HandleArgumentCompletion if the cursor is on an argument, not an option.

Don't override this method, override HandleArgumentCompletion instead unless you have special reasons.

Parameters

[in,out] request The completion request that needs to be answered.

Reimplemented from lldb_private::CommandObject.

Definition at line 255 of file CommandObjectMultiword.cpp.

References lldb_private::CompletionRequest::AddCompletions(), lldb_private::AddNamesMatchingPartialString(), lldb_private::CompletionRequest::AppendEmptyArgument(), lldb_private::StringList::DeleteStringAtIndex(), lldb_private::Args::GetArgumentCount(), lldb_private::CompletionRequest::GetCursorIndex(), lldb_private::CompletionRequest::GetParsedLine(), lldb_private::StringList::GetSize(), lldb_private::StringList::GetStringAtIndex(), GetSubcommandObject(), lldb_private::CommandObject::HandleCompletion(), m_subcommand_dict, lldb_private::Args::Shift(), and lldb_private::CompletionRequest::ShiftArguments().