plCommandLineOptionInt Class Reference

This command line option exposes integer values, optionally with a min/max range. More...

#include <CommandLineOptions.h>

Inheritance diagram for plCommandLineOptionInt:

Public Member Functions
	plCommandLineOptionInt (plStringView sSortingGroup, plStringView sArgument, plStringView sLongDesc, int iDefaultValue, int iMinValue=plMath::MinValue< int >(), int iMaxValue=plMath::MaxValue< int >(), bool bCaseSensitive=false)
virtual void	GetParamDefaultValueDesc (plStringBuilder &ref_sOut) const override
	Returns a very short string for the options default value. For example "0" or "auto".
virtual void	GetParamShortDesc (plStringBuilder &ref_sOut) const override
	Returns a very short description of the option (type). For example "<int>" or "<enum>".
int	GetOptionValue (LogMode logMode, const plCommandLineUtils *pUtils=plCommandLineUtils::GetGlobalInstance()) const
	Returns the value of this option. Either what was specified on the command line, or the default value.
void	SetDefaultValue (plInt32 value)
	Modifies the default value.
virtual plStringView	GetType () override
	Returns "Int".
plInt32	GetMinValue () const
	Returns the minimum value.
plInt32	GetMaxValue () const
	Returns the maximum value.
plInt32	GetDefaultValue () const
	Returns the default value.
Public Member Functions inherited from plCommandLineOptionDoc
	plCommandLineOptionDoc (plStringView sSortingGroup, plStringView sArgument, plStringView sParamShortDesc, plStringView sLongDesc, plStringView sDefaultValue, bool bCaseSensitive=false)
virtual void	GetOptions (plStringBuilder &ref_sOut) const override
	Writes all the supported options (e.g. '-arg') to 'out'. If more than one option is allowed, they should be separated with semicolons or pipes.
virtual void	GetLongDesc (plStringBuilder &ref_sOut) const override
	Returns a proper description of the option.
bool	IsOptionSpecified (plStringBuilder *out_pWhich=nullptr, const plCommandLineUtils *pUtils=plCommandLineUtils::GetGlobalInstance()) const
	Checks whether any of the option variants is set on the command line, and returns which one. For example '-h' or '-help'.
Public Member Functions inherited from plCommandLineOption
	plCommandLineOption (plStringView sSortingGroup)
virtual void	GetSortingGroup (plStringBuilder &ref_sOut) const
	Writes the sorting group name to 'out'.
void	GetSplitOptions (plStringBuilder &out_sAll, plDynamicArray< plStringView > &ref_splitOptions) const
	Returns the supported option names (e.g. '-arg') as split strings.

Protected Attributes
plInt32	m_iDefaultValue = 0
plInt32	m_iMinValue = 0
plInt32	m_iMaxValue = 0
Protected Attributes inherited from plCommandLineOptionDoc
plStringView	m_sArgument
plStringView	m_sParamShortDesc
plStringView	m_sParamDefaultValue
plStringView	m_sLongDesc
bool	m_bCaseSensitive = false
bool	m_bLoggedOnce = false
Protected Attributes inherited from plCommandLineOption
plStringView	m_sSortingGroup
Protected Attributes inherited from plEnumerable< plCommandLineOption >
plEnumerable *	m_pNextInstance

Additional Inherited Members
Public Types inherited from plCommandLineOption
enum class	LogAvailableModes { Always , IfHelpRequested }
enum class	LogMode {   Never , FirstTime , FirstTimeIfSpecified , Always ,   AlwaysIfSpecified }
	Describes whether the value of an option (and whether something went wrong), should be printed to plLog. More...
Static Public Member Functions inherited from plCommandLineOption
static bool	IsHelpRequested (const plCommandLineUtils *pUtils=plCommandLineUtils::GetGlobalInstance())
	Checks whether a command line was passed that requests help output.
static plResult	RequireOptions (plStringView sRequiredOptions, plString *pMissingOption=nullptr, const plCommandLineUtils *pUtils=plCommandLineUtils::GetGlobalInstance())
	Checks whether all required options are passed to the command line.
static bool	LogAvailableOptions (LogAvailableModes mode, plStringView sGroupFilter={}, const plCommandLineUtils *pUtils=plCommandLineUtils::GetGlobalInstance())
	Prints all available options to the plLog.
static bool	LogAvailableOptionsToBuffer (plStringBuilder &out_sBuffer, LogAvailableModes mode, plStringView sGroupFilter={}, const plCommandLineUtils *pUtils=plCommandLineUtils::GetGlobalInstance())
	Same as LogAvailableOptions() but captures the output from plLog and returns it in an plStringBuilder.
Static Public Member Functions inherited from plNoBase
static const plRTTI *	GetStaticRTTI ()
Protected Member Functions inherited from plCommandLineOptionDoc
bool	ShouldLog (LogMode mode, bool bWasSpecified) const
void	LogOption (plStringView sOption, plStringView sValue, bool bWasSpecified) const

Detailed Description

This command line option exposes integer values, optionally with a min/max range.

If the user specified a value outside the allowed range, a warning is printed, and the default value is used instead. It is valid for the default value to be outside the min/max range, which can be used to detect whether the user provided any value at all.

Member Function Documentation

GetParamDefaultValueDesc()

void plCommandLineOptionInt::GetParamDefaultValueDesc ( plStringBuilder & ref_sOut ) const

overridevirtual

Returns a very short string for the options default value. For example "0" or "auto".

Reimplemented from plCommandLineOptionDoc.

GetParamShortDesc()

void plCommandLineOptionInt::GetParamShortDesc ( plStringBuilder & ref_sOut ) const

overridevirtual

Returns a very short description of the option (type). For example "<int>" or "<enum>".

Reimplemented from plCommandLineOptionDoc.

GetType()

virtual plStringView plCommandLineOptionInt::GetType ( )

inlineoverridevirtual

Returns "Int".

Reimplemented from plCommandLineOptionDoc.

---

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

• Code/Engine/Foundation/Utilities/CommandLineOptions.h
• Code/Engine/Foundation/Utilities/Implementation/CommandLineOptions.cpp