Provide access to the Option info table. More...

#include "llvm/Option/OptTable.h"

Inheritance diagram for llvm::opt::OptTable:

[legend]

Classes
struct	Info
	Entry for a single option instance in the option data table. More...

Public Member Functions
virtual	~OptTable ()

const char *	getStrTable () const
	Return the string table used for option names.

ArrayRef< unsigned >	getPrefixesTable () const
	Return the prefixes table used for option names.

unsigned	getNumOptions () const
	Return the total number of option classes.

const Option	getOption (OptSpecifier Opt) const
	Get the given Opt's Option instance, lazily creating it if necessary.

StringRef	getOptionName (OptSpecifier id) const
	Lookup the name of the given option.

StringRef	getOptionPrefix (OptSpecifier id) const
	Lookup the prefix of the given option.

void	appendOptionPrefixes (OptSpecifier id, SmallVectorImpl< StringRef > &Prefixes) const

StringRef	getOptionPrefixedName (OptSpecifier id) const
	Lookup the prefixed name of the given option.

unsigned	getOptionKind (OptSpecifier id) const
	Get the kind of the given option.

unsigned	getOptionGroupID (OptSpecifier id) const
	Get the group id for the given option.

const char *	getOptionHelpText (OptSpecifier id) const
	Get the help text to use to describe this option.

const char *	getOptionHelpText (OptSpecifier id, Visibility VisibilityMask) const

const char *	getOptionMetaVar (OptSpecifier id) const
	Get the meta-variable name to use when describing this options values in the help text.

void	setInitialOptionsFromEnvironment (const char *E)
	Specify the environment variable where initial options should be read.

void	setGroupedShortOptions (bool Value)
	Support grouped short options. e.g. -ab represents -a -b.

void	setDashDashParsing (bool Value)
	Set whether "--" stops option parsing and treats all subsequent arguments as positional.

std::vector< std::string >	suggestValueCompletions (StringRef Option, StringRef Arg) const
	Find possible value for given flags.

std::vector< std::string >	findByPrefix (StringRef Cur, Visibility VisibilityMask, unsigned int DisableFlags) const
	Find flags from OptTable which starts with Cur.

unsigned	findNearest (StringRef Option, std::string &NearestString, Visibility VisibilityMask=Visibility(), unsigned MinimumLength=4, unsigned MaximumDistance=UINT_MAX) const
	Find the OptTable option that most closely matches the given string.

unsigned	findNearest (StringRef Option, std::string &NearestString, unsigned FlagsToInclude, unsigned FlagsToExclude=0, unsigned MinimumLength=4, unsigned MaximumDistance=UINT_MAX) const

bool	findExact (StringRef Option, std::string &ExactString, Visibility VisibilityMask=Visibility()) const

bool	findExact (StringRef Option, std::string &ExactString, unsigned FlagsToInclude, unsigned FlagsToExclude=0) const

std::unique_ptr< Arg >	ParseOneArg (const ArgList &Args, unsigned &Index, Visibility VisibilityMask=Visibility()) const
	Parse a single argument; returning the new argument and updating Index.

std::unique_ptr< Arg >	ParseOneArg (const ArgList &Args, unsigned &Index, unsigned FlagsToInclude, unsigned FlagsToExclude) const

InputArgList	ParseArgs (ArrayRef< const char * > Args, unsigned &MissingArgIndex, unsigned &MissingArgCount, Visibility VisibilityMask=Visibility()) const
	Parse an list of arguments into an InputArgList.

InputArgList	ParseArgs (ArrayRef< const char * > Args, unsigned &MissingArgIndex, unsigned &MissingArgCount, unsigned FlagsToInclude, unsigned FlagsToExclude=0) const

InputArgList	parseArgs (int Argc, char const Argv, OptSpecifier Unknown, StringSaver &Saver, std::function< void(StringRef)> ErrorFn) const
	A convenience helper which handles optional initial options populated from an environment variable, expands response files recursively and parses options.

void	printHelp (raw_ostream &OS, const char Usage, const char Title, bool ShowHidden=false, bool ShowAllAliases=false, Visibility VisibilityMask=Visibility()) const
	Render the help text for an option table.

void	printHelp (raw_ostream &OS, const char Usage, const char Title, unsigned FlagsToInclude, unsigned FlagsToExclude, bool ShowAllAliases) const

Protected Member Functions
	OptTable (const char *StrTable, ArrayRef< unsigned > PrefixesTable, ArrayRef< Info > OptionInfos, bool IgnoreCase=false)
	Initialize OptTable using Tablegen'ed OptionInfos.

void	buildPrefixChars ()
	Build (or rebuild) the PrefixChars member.

Protected Attributes
unsigned	FirstSearchableIndex = 0
	The index of the first option which can be parsed (i.e., is not a special option like 'input' or 'unknown', and is not an option group).

SmallVector< StringRef >	PrefixesUnion
	The union of all option prefixes.

SmallString< 8 >	PrefixChars
	The union of the first element of all option prefixes.

Detailed Description

Provide access to the Option info table.

The OptTable class provides a layer of indirection which allows Option instance to be created lazily. In the common case, only a few options will be needed at runtime; the OptTable class maintains enough information to parse command lines without instantiating Options, while letting other parts of the driver still use Option instances where convenient.

Definition at line 52 of file OptTable.h.

Constructor & Destructor Documentation

◆ OptTable()

OptTable::OptTable	(	const char *	StrTable,
		ArrayRef< unsigned >	PrefixesTable,
		ArrayRef< Info >	OptionInfos,
		bool	IgnoreCase = `false`
	)

protected

Initialize OptTable using Tablegen'ed OptionInfos.

Child class must manually call buildPrefixChars once they are fully constructed.

Definition at line 79 of file OptTable.cpp.

References assert(), llvm::opt::Option::dump(), FirstSearchableIndex, getNumOptions(), getOption(), llvm::opt::Option::GroupClass, llvm::opt::OptTable::Info::ID, llvm::opt::Option::InputClass, llvm::opt::OptTable::Info::Kind, llvm_unreachable, and llvm::opt::Option::UnknownClass.

◆ ~OptTable()

OptTable::~OptTable ( )

virtualdefault

Member Function Documentation

◆ appendOptionPrefixes()

void llvm::opt::OptTable::appendOptionPrefixes	(	OptSpecifier	id,
		SmallVectorImpl< StringRef > &	Prefixes
	)		const

inline

Definition at line 200 of file OptTable.h.

References I.

◆ buildPrefixChars()

void OptTable::buildPrefixChars ( )

protected

Build (or rebuild) the PrefixChars member.

Definition at line 123 of file OptTable.cpp.

References assert(), llvm::CallingConv::C, llvm::SmallVectorBase< Size_T >::empty(), llvm::is_contained(), PrefixChars, PrefixesUnion, and llvm::SmallVectorTemplateBase< T, bool >::push_back().

Referenced by llvm::opt::GenericOptTable::GenericOptTable(), and llvm::opt::PrecomputedOptTable::PrecomputedOptTable().

◆ findByPrefix()

std::vector< std::string > OptTable::findByPrefix	(	StringRef	Cur,
		Visibility	VisibilityMask,
		unsigned int	DisableFlags
	)		const

Find flags from OptTable which starts with Cur.

Parameters

[in] Cur - String prefix that all returned flags need

Returns: The vector of flags which start with Cur.

Definition at line 208 of file OptTable.cpp.

References FirstSearchableIndex, I, Name, and llvm::StringRef::starts_with().

◆ findExact() [1/2]

bool llvm::opt::OptTable::findExact	(	StringRef	Option,
		std::string &	ExactString,
		unsigned	FlagsToInclude,
		unsigned	FlagsToExclude = `0`
	)		const

inline

Definition at line 316 of file OptTable.h.

References findNearest().

◆ findExact() [2/2]

bool llvm::opt::OptTable::findExact	(	StringRef	Option,
		std::string &	ExactString,
		Visibility	VisibilityMask = `Visibility()`
	)		const

inline

Definition at line 311 of file OptTable.h.

References findNearest().

◆ findNearest() [1/2]

unsigned OptTable::findNearest	(	StringRef	Option,
		std::string &	NearestString,
		unsigned	FlagsToInclude,
		unsigned	FlagsToExclude = `0`,
		unsigned	MinimumLength = `4`,
		unsigned	MaximumDistance = `UINT_MAX`
	)		const

Definition at line 244 of file OptTable.cpp.

References llvm::opt::OptTable::Info::Flags, and if().

◆ findNearest() [2/2]

unsigned OptTable::findNearest	(	StringRef	Option,
		std::string &	NearestString,
		Visibility	VisibilityMask = `Visibility()`,
		unsigned	MinimumLength = `4`,
		unsigned	MaximumDistance = `UINT_MAX`
	)		const

Find the OptTable option that most closely matches the given string.

Parameters

[in]	Option	- A string, such as "-stdlibs=l", that represents user input of an option that may not exist in the OptTable. Note that the string includes prefix dashes "-" as well as values "=l".
[out]	NearestString	- The nearest option string found in the OptTable.
[in]	VisibilityMask	- Only include options with any of these visibility flags set.
[in]	MinimumLength	- Don't find options shorter than this length. For example, a minimum length of 3 prevents "-x" from being considered near to "-S".
[in]	MaximumDistance	- Don't find options whose distance is greater than this value.

Returns: The edit distance of the nearest string found.

Definition at line 233 of file OptTable.cpp.

References llvm::opt::OptTable::Info::Visibility.

Referenced by findExact(), and parseArgs().

◆ getNumOptions()

unsigned llvm::opt::OptTable::getNumOptions ( ) const

inline

Return the total number of option classes.

Definition at line 180 of file OptTable.h.

References llvm::ArrayRef< T >::size().

Referenced by getOption(), and OptTable().

◆ getOption()

const Option OptTable::getOption ( OptSpecifier Opt ) const

Get the given Opt's Option instance, lazily creating it if necessary.

Returns: The option, or null for the INVALID option id.

Definition at line 136 of file OptTable.cpp.

References assert(), llvm::opt::OptSpecifier::getID(), and getNumOptions().

Referenced by llvm::opt::Option::getAlias(), llvm::opt::Option::getGroup(), getOptionHelpName(), and OptTable().

◆ getOptionGroupID()

unsigned llvm::opt::OptTable::getOptionGroupID ( OptSpecifier id ) const

inline

Get the group id for the given option.

Definition at line 217 of file OptTable.h.

References llvm::opt::OptTable::Info::GroupID.

Referenced by getOptionHelpGroup().

◆ getOptionHelpText() [1/2]

const char * llvm::opt::OptTable::getOptionHelpText ( OptSpecifier id ) const

inline

Get the help text to use to describe this option.

Definition at line 222 of file OptTable.h.

References getOptionHelpText().

Referenced by getOptionHelpGroup(), and getOptionHelpText().

◆ getOptionHelpText() [2/2]

const char * llvm::opt::OptTable::getOptionHelpText	(	OptSpecifier	id,
		Visibility	VisibilityMask
	)		const

inline

Definition at line 229 of file OptTable.h.

References llvm::opt::OptTable::Info::HelpText, and llvm::opt::OptTable::Info::HelpTextsForVariants.

◆ getOptionKind()

unsigned llvm::opt::OptTable::getOptionKind ( OptSpecifier id ) const

inline

Get the kind of the given option.

Definition at line 212 of file OptTable.h.

References llvm::opt::OptTable::Info::Kind.

◆ getOptionMetaVar()

const char * llvm::opt::OptTable::getOptionMetaVar ( OptSpecifier id ) const

inline

Get the meta-variable name to use when describing this options values in the help text.

Definition at line 241 of file OptTable.h.

References llvm::opt::OptTable::Info::MetaVar.

Referenced by getOptionHelpName().

◆ getOptionName()

StringRef llvm::opt::OptTable::getOptionName ( OptSpecifier id ) const

inline

Lookup the name of the given option.

Definition at line 189 of file OptTable.h.

References llvm::opt::OptTable::Info::getName().

Referenced by llvm::opt::Option::getName().

◆ getOptionPrefix()

StringRef llvm::opt::OptTable::getOptionPrefix ( OptSpecifier id ) const

inline

Lookup the prefix of the given option.

Definition at line 194 of file OptTable.h.

References I.

Referenced by llvm::opt::Option::getPrefix().

◆ getOptionPrefixedName()

StringRef llvm::opt::OptTable::getOptionPrefixedName ( OptSpecifier id ) const

inline

Lookup the prefixed name of the given option.

Definition at line 207 of file OptTable.h.

References llvm::opt::OptTable::Info::getPrefixedName().

Referenced by llvm::opt::Option::getPrefixedName().

◆ getPrefixesTable()

ArrayRef< unsigned > llvm::opt::OptTable::getPrefixesTable ( ) const

inline

Return the prefixes table used for option names.

Definition at line 177 of file OptTable.h.

Referenced by llvm::opt::Option::print().

◆ getStrTable()

const char * llvm::opt::OptTable::getStrTable ( ) const

inline

Return the string table used for option names.

Definition at line 174 of file OptTable.h.

Referenced by llvm::opt::Option::print().

◆ ParseArgs() [1/2]

InputArgList OptTable::ParseArgs	(	ArrayRef< const char * >	Args,
		unsigned &	MissingArgIndex,
		unsigned &	MissingArgCount,
		unsigned	FlagsToInclude,
		unsigned	FlagsToExclude = `0`
	)		const

Definition at line 509 of file OptTable.cpp.

References llvm::opt::Option::hasFlag(), and if().

◆ ParseArgs() [2/2]

InputArgList OptTable::ParseArgs	(	ArrayRef< const char * >	Args,
		unsigned &	MissingArgIndex,
		unsigned &	MissingArgCount,
		Visibility	VisibilityMask = `Visibility()`
	)		const

Parse an list of arguments into an InputArgList.

The resulting InputArgList will reference the strings in [ArgBegin, ArgEnd), and their lifetime should extend past that of the returned InputArgList.

The only error that can occur in this routine is if an argument is missing values; in this case MissingArgCount will be non-zero.

Parameters

MissingArgIndex	- On error, the index of the option which could not be parsed.
MissingArgCount	- On error, the number of missing options.
VisibilityMask	- Only include options with any of these visibility flags set.

Returns: An InputArgList; on error this will contain all the options which could be parsed.

Definition at line 498 of file OptTable.cpp.

References llvm::opt::Option::hasVisibilityFlag().

Referenced by llvm::jitlink::COFFDirectiveParser::parse(), and parseArgs().

◆ parseArgs()

InputArgList OptTable::parseArgs	(	int	Argc,
		char const	Argv,
		OptSpecifier	Unknown,
		StringSaver &	Saver,
		std::function< void(StringRef)>	ErrorFn
	)		const

A convenience helper which handles optional initial options populated from an environment variable, expands response files recursively and parses options.

Parameters

ErrorFn - Called on a formatted error message for missing arguments or unknown options.

Returns: An InputArgList; on error this will contain all the options which could be parsed.

Definition at line 580 of file OptTable.cpp.

References A, llvm::cl::expandResponseFiles(), findNearest(), ParseArgs(), and llvm::Unknown.

◆ ParseOneArg() [1/2]

std::unique_ptr< Arg > OptTable::ParseOneArg	(	const ArgList &	Args,
		unsigned &	Index,
		unsigned	FlagsToInclude,
		unsigned	FlagsToExclude
	)		const

Definition at line 421 of file OptTable.cpp.

References llvm::opt::Option::hasFlag(), and if().

◆ ParseOneArg() [2/2]

std::unique_ptr< Arg > OptTable::ParseOneArg	(	const ArgList &	Args,
		unsigned &	Index,
		Visibility	VisibilityMask = `Visibility()`
	)		const

Parse a single argument; returning the new argument and updating Index.

Parameters

[in,out]	Index	- The current parsing position in the argument string list; on return this will be the index of the next argument string to parse.
[in]	VisibilityMask	- Only include options with any of these visibility flags set.

Returns: The parsed argument, or 0 if the argument is missing values (in which case Index still points at the conceptual next argument string to parse).

Definition at line 414 of file OptTable.cpp.

References llvm::opt::Option::hasVisibilityFlag().

◆ printHelp() [1/2]

void OptTable::printHelp	(	raw_ostream &	OS,
		const char *	Usage,
		const char *	Title,
		bool	ShowHidden = `false`,
		bool	ShowAllAliases = `false`,
		Visibility	VisibilityMask = `Visibility()`
	)		const

Render the help text for an option table.

Parameters

OS	- The stream to write the help text to.
Usage	- USAGE: Usage
Title	- OVERVIEW: Title
VisibilityMask	- Only in Visibility VisibilityMask,clude options with any of these visibility flags set.
ShowHidden	- If true, display options marked as HelpHidden
ShowAllAliases	- If true, display all options including aliases that don't have help texts. By default, we display only options that are not hidden and have help texts.

Definition at line 714 of file OptTable.cpp.

References OS, and llvm::opt::OptTable::Info::Visibility.

◆ printHelp() [2/2]

void OptTable::printHelp	(	raw_ostream &	OS,
		const char *	Usage,
		const char *	Title,
		unsigned	FlagsToInclude,
		unsigned	FlagsToExclude,
		bool	ShowAllAliases
	)		const

Definition at line 725 of file OptTable.cpp.

References llvm::opt::OptTable::Info::Flags, llvm::opt::HelpHidden, if(), and OS.

◆ setDashDashParsing()

void llvm::opt::OptTable::setDashDashParsing ( bool Value )

inline

Set whether "--" stops option parsing and treats all subsequent arguments as positional.

E.g. – -a -b gives two positional inputs.

Definition at line 253 of file OptTable.h.

◆ setGroupedShortOptions()

void llvm::opt::OptTable::setGroupedShortOptions ( bool Value )

inline

Support grouped short options. e.g. -ab represents -a -b.

Definition at line 249 of file OptTable.h.

◆ setInitialOptionsFromEnvironment()

void llvm::opt::OptTable::setInitialOptionsFromEnvironment ( const char * E )

inline

Specify the environment variable where initial options should be read.

Definition at line 246 of file OptTable.h.

References E.

◆ suggestValueCompletions()

std::vector< std::string > OptTable::suggestValueCompletions	(	StringRef	Option,
		StringRef	Arg
	)		const

Find possible value for given flags.

This is used for shell autocompletion.

Parameters

[in]	Option	- Key flag like "-stdlib=" when "-stdlib=l" was passed to clang.
[in]	Arg	- Value which we want to autocomplete like "l" when "-stdlib=l" was passed to clang.

Returns: The vector of possible values.

Definition at line 188 of file OptTable.cpp.

References FirstSearchableIndex, I, optionMatches(), and llvm::StringRef::split().

Member Data Documentation

◆ FirstSearchableIndex

unsigned llvm::opt::OptTable::FirstSearchableIndex = 0

protected

The index of the first option which can be parsed (i.e., is not a special option like 'input' or 'unknown', and is not an option group).

Definition at line 142 of file OptTable.h.

Referenced by findByPrefix(), llvm::opt::GenericOptTable::GenericOptTable(), OptTable(), and suggestValueCompletions().

◆ PrefixChars

SmallString<8> llvm::opt::OptTable::PrefixChars

protected

The union of the first element of all option prefixes.

Definition at line 149 of file OptTable.h.

Referenced by buildPrefixChars().

◆ PrefixesUnion

SmallVector<StringRef> llvm::opt::OptTable::PrefixesUnion

protected

The union of all option prefixes.

If an argument does not begin with one of these, it is an input.

Definition at line 146 of file OptTable.h.

Referenced by buildPrefixChars(), llvm::opt::GenericOptTable::GenericOptTable(), and llvm::opt::PrecomputedOptTable::PrecomputedOptTable().

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

include/llvm/Option/OptTable.h
lib/Option/OptTable.cpp

Classes

Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ OptTable()

◆ ~OptTable()

Member Function Documentation

◆ appendOptionPrefixes()

◆ buildPrefixChars()

◆ findByPrefix()

◆ findExact() [1/2]

◆ findExact() [2/2]

◆ findNearest() [1/2]

◆ findNearest() [2/2]

◆ getNumOptions()

◆ getOption()

◆ getOptionGroupID()

◆ getOptionHelpText() [1/2]

◆ getOptionHelpText() [2/2]

◆ getOptionKind()

◆ getOptionMetaVar()

◆ getOptionName()

◆ getOptionPrefix()

◆ getOptionPrefixedName()

◆ getPrefixesTable()

◆ getStrTable()

◆ ParseArgs() [1/2]

◆ ParseArgs() [2/2]

◆ parseArgs()

◆ ParseOneArg() [1/2]

◆ ParseOneArg() [2/2]

◆ printHelp() [1/2]

◆ printHelp() [2/2]

◆ setDashDashParsing()

◆ setGroupedShortOptions()

◆ setInitialOptionsFromEnvironment()

◆ suggestValueCompletions()

Member Data Documentation

◆ FirstSearchableIndex

◆ PrefixChars

◆ PrefixesUnion