xiiCommandLineOptionFloat Class Reference

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

#include <CommandLineOptions.h>

Inheritance diagram for xiiCommandLineOptionFloat:

Public Member Functions
	xiiCommandLineOptionFloat (xiiStringView sSortingGroup, xiiStringView sArgument, xiiStringView sLongDesc, float fDefaultValue, float fMinValue=xiiMath::MinValue< float >(), float fMaxValue=xiiMath::MaxValue< float >(), bool bCaseSensitive=false)
virtual void	GetParamDefaultValueDesc (xiiStringBuilder &ref_sOut) const override
	Returns a very short string for the options default value. For example "0" or "auto".
virtual void	GetParamShortDesc (xiiStringBuilder &ref_sOut) const override
	Returns a very short description of the option (type). For example "<int>" or "<enum>".
float	GetOptionValue (LogMode logMode, const xiiCommandLineUtils *pUtils=xiiCommandLineUtils::GetGlobalInstance()) const
	Returns the value of this option. Either what was specified on the command line, or the default value.
void	SetDefaultValue (float value)
	Modifies the default value.
virtual xiiStringView	GetType () override
	Returns "Float".
float	GetMinValue () const
	Returns the minimum value.
float	GetMaxValue () const
	Returns the maximum value.
float	GetDefaultValue () const
	Returns the default value.
Public Member Functions inherited from xiiCommandLineOptionDoc
	xiiCommandLineOptionDoc (xiiStringView sSortingGroup, xiiStringView sArgument, xiiStringView sParamShortDesc, xiiStringView sLongDesc, xiiStringView sDefaultValue, bool bCaseSensitive=false)
virtual void	GetOptions (xiiStringBuilder &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 (xiiStringBuilder &ref_sOut) const override
	Returns a proper description of the option.
bool	IsOptionSpecified (xiiStringBuilder *out_pWhich=nullptr, const xiiCommandLineUtils *pUtils=xiiCommandLineUtils::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 xiiCommandLineOption
	xiiCommandLineOption (xiiStringView sSortingGroup)
virtual void	GetSortingGroup (xiiStringBuilder &ref_sOut) const
	Writes the sorting group name to 'out'.
void	GetSplitOptions (xiiStringBuilder &out_sAll, xiiDynamicArray< xiiStringView > &ref_splitOptions) const
	Returns the supported option names (e.g. '-arg') as split strings.

Protected Attributes
float	m_fDefaultValue = 0
float	m_fMinValue = 0
float	m_fMaxValue = 0
Protected Attributes inherited from xiiCommandLineOptionDoc
xiiStringView	m_sArgument
xiiStringView	m_sParamShortDesc
xiiStringView	m_sParamDefaultValue
xiiStringView	m_sLongDesc
bool	m_bCaseSensitive = false
bool	m_bLoggedOnce = false
Protected Attributes inherited from xiiCommandLineOption
xiiStringView	m_sSortingGroup
Protected Attributes inherited from xiiEnumerable< xiiCommandLineOption >
xiiEnumerable *	m_pNextInstance

Additional Inherited Members
Public Types inherited from xiiCommandLineOption
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 xiiLog. More...
Static Public Member Functions inherited from xiiCommandLineOption
static bool	IsHelpRequested (const xiiCommandLineUtils *pUtils=xiiCommandLineUtils::GetGlobalInstance())
	Checks whether a command line was passed that requests help output.
static xiiResult	RequireOptions (xiiStringView sRequiredOptions, xiiString *pMissingOption=nullptr, const xiiCommandLineUtils *pUtils=xiiCommandLineUtils::GetGlobalInstance())
	Checks whether all required options are passed to the command line.
static bool	LogAvailableOptions (LogAvailableModes mode, xiiStringView sGroupFilter={}, const xiiCommandLineUtils *pUtils=xiiCommandLineUtils::GetGlobalInstance())
	Prints all available options to the xiiLog.
static bool	LogAvailableOptionsToBuffer (xiiStringBuilder &out_sBuffer, LogAvailableModes mode, xiiStringView sGroupFilter={}, const xiiCommandLineUtils *pUtils=xiiCommandLineUtils::GetGlobalInstance())
	Same as LogAvailableOptions() but captures the output from xiiLog and returns it in a xiiStringBuilder.
Static Public Member Functions inherited from xiiNoBase
static const xiiRTTI *	GetStaticRTTI ()
Protected Member Functions inherited from xiiCommandLineOptionDoc
bool	ShouldLog (LogMode mode, bool bWasSpecified) const
void	LogOption (xiiStringView sOption, xiiStringView sValue, bool bWasSpecified) const

Detailed Description

This command line option exposes float 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 xiiCommandLineOptionFloat::GetParamDefaultValueDesc ( xiiStringBuilder & ref_sOut ) const

overridevirtual

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

Reimplemented from xiiCommandLineOptionDoc.

GetParamShortDesc()

void xiiCommandLineOptionFloat::GetParamShortDesc ( xiiStringBuilder & ref_sOut ) const

overridevirtual

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

Reimplemented from xiiCommandLineOptionDoc.

GetType()

virtual xiiStringView xiiCommandLineOptionFloat::GetType ( )

inlineoverridevirtual

Returns "Float".

Reimplemented from xiiCommandLineOptionDoc.

---

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

• /home/runner/work/XII/XII/Source/Engine/Foundation/Utilities/CommandLineOptions.h
• /home/runner/work/XII/XII/Source/Engine/Foundation/Utilities/Implementation/CommandLineOptions.cpp