Extract command arguments and options from the supplied argc and argv parameters. More...

Collaboration diagram for argList:

Public Member Functions
	argList (int &argc, char **&argv, bool checkArgs=argList::argsMandatory(), bool checkOpts=true, bool initialise=true)

	argList (const argList &args, const HashTable< string > &options, bool checkArgs=true, bool checkOpts=true, bool initialise=true)
	Construct copy with new options. More...

virtual	~argList ()
	Destructor. More...

void	parse (bool checkArgs, bool checkOpts, bool initialise)

const word &	executable () const
	Name of executable without the path. More...

const string &	commandLine () const
	The command line options and arguments concatenated as a string. More...

const fileName &	rootPath () const
	Return root path. More...

const fileName &	caseName () const
	Return case name (parallel run) or global case (serial run) More...

const fileName &	globalCaseName () const
	Return global case name. More...

fileName	path () const
	Return the full path to the (processor local) case. More...

fileName	globalPath () const
	Return the full path to the global case. More...

fileName	relativePath (const fileName &input, const bool caseTag=false) const

bool	distributed () const

const ParRunControl &	parRunControl () const
	Return the ParRunControl. More...

const dlLibraryTable &	libs () const
	Access to the loaded libraries. More...

dlLibraryTable &	libs ()
	Access to the loaded libraries. More...

label	size () const noexcept
	The number of arguments. More...

const stringList &	args () const
	Return arguments. More...

stringList &	args ()
	Non-const access to the command arguments (non-options) More...

const HashTable< string > &	options () const
	Return options. More...

HashTable< string > &	options ()
	Return non-const access to the command options. More...

bool	found (const word &optName) const
	Return true if the named option is found. More...

label	count (const UList< word > &optionNames) const
	Return how many of the specified options were used. More...

label	count (std::initializer_list< word > optionNames) const
	Return how many of the specified options were used. More...

ITstream	lookup (const word &optName) const
	Return an input stream from the named option. More...

template<class T >
T	get (const label index) const
	Get a value from the argument at index. More...

template<class T >
List< T >	getList (const label index) const
	Get a List of values from the argument at index. More...

template<class T = string>
T	get (const word &optName) const
	Get a value from the named option. More...

template<class T >
T	get (const word &optName, const T &deflt) const
	Get a value from the named option if present, or return default. More...

template<class T >
bool	readIfPresent (const word &optName, T &val) const
	Read a value from the named option if present. More...

template<class T >
bool	readIfPresent (const word &optName, T &val, const T &deflt) const
	Read a value from the named option if present. More...

template<class T >
T	getOrDefault (const word &optName, const T &deflt) const
	Get a value from the named option if present, or return default. More...

template<class T >
List< T >	getList (const word &optName, bool mandatory=true) const

template<class T >
bool	readListIfPresent (const word &optName, List< T > &list) const

template<class T = string>
T	opt (const word &optName) const
	Alternative name for option get(const word& optName) More...

template<class T >
T	opt (const word &optName, const T &deflt) const
	Alternative name for option get(const word& optName, ...) More...

bool	setOption (const word &optName, const string &param="")
	Set option directly (use with caution) More...

bool	unsetOption (const word &optName)
	Unset option directly (use with caution) More...

void	printCompat () const
	Print option compatibility. More...

void	printNotes () const
	Print notes (if any) More...

void	printUsage (bool full=true) const
	Print usage. More...

void	printMan () const
	Print usage as nroff-man format (Experimental) More...

void	displayDoc (bool source=false) const
	Display documentation in browser. More...

bool	check (bool checkArgs=argList::argsMandatory(), bool checkOpts=true) const

bool	checkRootCase () const
	Check root path and case path. More...

const string &	operator[] (const label index) const
	The string corresponding to the argument index. More...

const string &	operator[] (const word &optName) const
	The string associated with the named option. More...

template<class T >
T	lookupOrDefault (const word &optName, const T &deflt) const
	Get a value from the named option if present, or return default. More...

template<class T >
T	FOAM_DEPRECATED_FOR (2018-08, "get() method") read(const label index) const
	Deprecated(2018-08) read a value from the argument at index. More...

template<class T >
T	FOAM_DEPRECATED_FOR (2018-01, "get() method") argRead(const label index) const
	Deprecated(2018-01) read a value from the argument at index. More...

bool	FOAM_DEPRECATED_FOR (2018-01, "found() method") optionFound(const word &optName) const
	Deprecated(2018-01) return true if the named option is found. More...

ITstream	FOAM_DEPRECATED_FOR (2018-01, "lookup() method") optionLookup(const word &optName) const
	Deprecated(2018-01) return an input stream from the named option. More...

template<class T >
T	FOAM_DEPRECATED_FOR (2018-01, "get() method") optionRead(const word &optName) const
	Deprecated(2018-01) read a value from the named option. More...

template<class T >
bool	FOAM_DEPRECATED_FOR (2018-01, "readIfPresent() method") optionReadIfPresent(const word &optName
	Deprecated(2018-01) read a value from the named option if present. More...

template<class T >
bool	FOAM_DEPRECATED_FOR (2018-01, "readIfPresent() method") optionReadIfPresent(const word &optName
	Deprecated(2018-01) read a value from the named option if present. More...

template<class T >
T	FOAM_DEPRECATED_FOR (2018-01, "getOrDefault() method") optionLookupOrDefault(const word &optName
	Deprecated(2018-01) read a value from the named option if present. More...

template<class T >
List< T >	FOAM_DEPRECATED_FOR (2018-01, "getList() method") optionReadList(const word &optName) const
	Deprecated(2018-01) read a List of values from the named option. More...

template<>
int32_t	get (const label index) const

template<>
int64_t	get (const label index) const

template<>
float	get (const label index) const

template<>
double	get (const label index) const

template<>
int32_t	get (const word &optName) const

template<>
int64_t	get (const word &optName) const

template<>
float	get (const word &optName) const

template<>
double	get (const word &optName) const

template<class T >
Foam::List< T >	getList (const label index) const

template<class T >
Foam::List< T >	getList (const word &optName, bool mandatory) const

Static Public Member Functions
static fileName	envGlobalPath ()
	Global case (directory) from environment variable. More...

static void	addArgument (const string &argName, const string &usage="")
	Append a (mandatory) argument to validArgs. More...

static void	addBoolOption (const word &optName, const string &usage="", bool advanced=false)
	Add a bool option to validOptions with usage information. More...

static void	addOption (const word &optName, const string &param="", const string &usage="", bool advanced=false)
	Add an option to validOptions with usage information. More...

static void	setAdvanced (const word &optName, bool advanced=true)
	Set an existing option as being 'advanced' or normal. More...

static void	addOptionCompat (const word &optName, std::pair< const char *, int > compat)
	Specify an alias for the option name. More...

static void	ignoreOptionCompat (std::pair< const char *, int > compat, bool expectArg)
	Specify an option to be ignored. More...

static void	addUsage (const word &optName, const string &usage)
	Add option usage information to optionUsage. More...

static void	addNote (const string &note)
	Add extra notes for the usage information. More...

static void	removeOption (const word &optName)
	Remove option from validOptions and from optionUsage. More...

static void	noMandatoryArgs ()
	Flag command arguments as being optional (non-mandatory) More...

static bool	argsMandatory ()
	Command arguments type (optional/mandatory). More...

static void	noBanner ()
	Disable emitting the banner information. More...

static bool	bannerEnabled ()
	Banner status (enabled/disabled). More...

static void	noFunctionObjects (bool addWithOption=false)
	Remove '-noFunctionObjects' option and ignore any occurances. More...

static void	noJobInfo ()
	Suppress JobInfo, overriding controlDict setting. More...

static void	noLibs ()
	Add the '-no-libs' command line option. More...

static void	noParallel ()
	Remove the parallel options. More...

static void	noCheckProcessorDirectories ()
	Remove checking of processor directories. More...

static bool	postProcess (int argc, char *argv[])
	Return true if the post-processing option is specified. More...

Public Attributes
bool T &const	val

bool T &	val

bool T const T &const	deflt

T const T &const	deflt

Static Public Attributes
static SLList< string >	validArgs
	A list of valid (mandatory) arguments. More...

static HashSet< string >	advancedOptions
	The "advanced" options are shown with -help-full (not with –help) More...

static HashTable< string >	validOptions
	A list of valid options. More...

static HashTable< string >	validParOptions
	A list of valid parallel options. More...

static HashTable< std::pair< word, int > >	validOptionsCompat
	A list of aliases for options. More...

static HashTable< std::pair< bool, int > >	ignoreOptionsCompat
	A list of options to ignore. More...

static HashTable< string, label, Hash< label > >	argUsage
	Short description for program arguments. More...

static HashTable< string >	optionUsage
	Short description for validOptions. More...

static SLList< string >	notes
	General usage notes. More...

static std::string::size_type	usageMin = 20
	Min indentation when displaying usage (default: 20) More...

static std::string::size_type	usageMax = 80
	Max screen width when displaying usage (default: 80) More...

static word	postProcessOptionName
	Standard name for the post-processing option. More...

Detailed Description

Extract command arguments and options from the supplied argc and argv parameters.

Sequences with "(" ... ")" are transformed into a stringList. For example,

    program -listFiles \( *.txt \)

would create a stringList:

    ( "file1.txt" "file2.txt" ... "fileN.txt" )

The backslash-escaping is required to avoid interpretation by the shell.

Default command-line options:

-case <dir>
Select a case directory instead of the current working directory
-decomposeParDict <file>
Read decomposePar dictionary from specified location
-parallel
Specify case as a parallel job
-doc
Display the documentation in browser
-srcDoc
Display the source documentation in browser
-help
Print the usage
Additionally, the -noFunctionObjects and -postProcess options may be present for some solvers or utilities.

Environment variables set by argList or by Time:

FOAM_API
The value of foamVersion::api
FOAM_CASE
The path of the global case. It is the same for serial and parallel jobs.
FOAM_CASENAME
The name of the global case.
FOAM_EXECUTABLE
If not already present in the calling environment, it is set to the name portion of the calling executable.
FOAM_APPLICATION
If not already present in the calling environment, it is set to the value of the application entry (from controlDict) if that entry is present.
The value of the FOAM_APPLICATION may be inconsistent if the value of the application entry is adjusted during runtime.

Note

The document browser used is defined by the FOAM_DOC_BROWSER environment variable or the Documentation/docBrowser entry in the <etc>/controlDict file. The %f token is used as a placeholder for the file name.
The valid (mandatory) arguments can be adjusted via the addArgument static method instead of directly manipulating the argList::validArgs static member.
The valid options can be adjusted via the addOption/removeOption static methods instead of directly manipulating the argList::validOptions static member.

Source files

Definition at line 123 of file argList.H.

Constructor & Destructor Documentation

◆ argList() [1/2]

argList	(	int &	argc,
		char **&	argv,
		bool	checkArgs = `argList::argsMandatory()`,
		bool	checkOpts = `true`,
		bool	initialise = `true`
	)

Construct from argc and argv checking the arguments and options as requested.

By default, the argument check respects the value of argsMandatory() to decide if the arguments should be checked (when they are mandatory) or not (when they are optional)

Definition at line 735 of file argList.C.

References Foam::debug::debugObjects(), fileOperation::defaultFileHandler, DetailInfo, Foam::endl(), UPstream::exit(), Foam::getEnv(), Foam::Info, Foam::debug::infoObjects(), fileName::name(), fileOperationInitialise::New(), Foam::nl, Foam::debug::optimisationObjects(), Foam::foamVersion::printBuildInfo(), simpleObjectRegistry::setNamedInt(), and Foam::Warning.

Here is the call graph for this function:

◆ argList() [2/2]

argList	(	const argList &	args,
		const HashTable< string > &	options,
		bool	checkArgs = `true`,
		bool	checkOpts = `true`,
		bool	initialise = `true`
	)

Construct copy with new options.

Definition at line 907 of file argList.C.

◆ ~argList()

~argList ( )

virtual

Destructor.

Definition at line 1547 of file argList.C.

References Foam::fileHandler(), and Foam::jobInfo.

Here is the call graph for this function:

Member Function Documentation

◆ envGlobalPath()

Foam::fileName envGlobalPath ( )

static

Global case (directory) from environment variable.

Returns the contents of the FOAM_CASE variable, which has previously been set by argList or by Time.

This will normally be identical to the value of globalPath(), but obtained via the environment.

Definition at line 513 of file argList.C.

References Foam::getEnv().

Referenced by noiseModel::baseFileDir(), pointNoise::calculate(), surfaceNoise::calculate(), boundaryDataWriter::write(), and boundaryDataWriter::writeTemplate().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ parse()

void parse	(	bool	checkArgs,
		bool	checkOpts,
		bool	initialise
	)

Scan for -help, -doc options etc prior to checking the validity of other args/opts and finally initialising.

Definition at line 930 of file argList.C.

References dictionary::add(), dynamicCode::allowSystemOperations, Foam::foamVersion::api, Foam::foamVersion::build, Foam::foamVersion::buildArch, fileName::clean(), List< T >::clear(), clock::clockTime(), UPstream::commsTypeNames, Foam::cwd(), clock::date(), UPstream::defaultCommsType, fileOperation::defaultFileHandler, Foam::endl(), Foam::exit(), UPstream::exit(), Foam::FatalError, FatalErrorIn, FatalErrorInFunction, IOobject::fileCheckTypesNames, Foam::fileHandler(), IOobject::fileModificationChecking, regIOobject::fileModificationSkew, Foam::findStrings(), UPstream::firstSlave(), UPstream::floatTransfer, forAll, Foam::getEnv(), dictionary::getOrDefault(), IOstream::good(), Foam::hostName(), Foam::Info, Foam::debug::infoSwitch(), fileName::isAbsolute(), Foam::isDir(), Foam::jobInfo, UPstream::lastSlave(), UPstream::master(), UPstream::masterNo(), regIOobject::maxFileModificationPolls, UPstream::myProcNo(), IFstream::name(), Foam::name(), fileOperation::New(), Foam::nl, UPstream::nPollProcInterfaces, UPstream::nProcs(), UPstream::nProcsSimpleSum, fileName::null, Foam::foamVersion::patch, Foam::foamVersion::patched(), Foam::pgid(), Foam::pid(), Foam::ppid(), Foam::foamVersion::printBuildInfo(), Foam::printHostsSubscription(), dictionary::readEntry(), List< T >::resize(), UPstream::scheduled, sigInt::set(), sigQuit::set(), sigSegv::set(), sigFpe::set(), string::starts_with(), IOobject::timeStamp, IOobject::timeStampMaster, Foam::userName(), Foam::foamVersion::version, error::write(), IOobject::writeBanner(), and IOobject::writeDivider().

Here is the call graph for this function:

◆ executable()

const Foam::word & executable ( ) const

inline

Name of executable without the path.

Definition at line 51 of file argListI.H.

Referenced by if().

Here is the caller graph for this function:

◆ commandLine()

const Foam::string & commandLine ( ) const

inline

The command line options and arguments concatenated as a string.

Definition at line 57 of file argListI.H.

◆ rootPath()

const Foam::fileName & rootPath ( ) const

inline

Return root path.

Definition at line 63 of file argListI.H.

◆ caseName()

const Foam::fileName & caseName ( ) const

inline

Return case name (parallel run) or global case (serial run)

Definition at line 69 of file argListI.H.

◆ globalCaseName()

const Foam::fileName & globalCaseName ( ) const

inline

Return global case name.

Definition at line 75 of file argListI.H.

◆ path()

Foam::fileName path ( ) const

inline

Return the full path to the (processor local) case.

Note: This is guaranteed to be an absolute path

Definition at line 81 of file argListI.H.

◆ globalPath()

Foam::fileName globalPath ( ) const

inline

Return the full path to the global case.

Note: This is guaranteed to be an absolute path

Definition at line 87 of file argListI.H.

◆ relativePath()

Foam::fileName relativePath	(	const fileName &	input,
		const bool	caseTag = `false`
	)		const

inline

Return the input relative to the globalPath by stripping off a leading value of the globalPath

Parameters

input	the directory or filename to make case-relative
caseTag	replace globalPath with <case> for later use with expand(), or prefix <case> if the file name was not an absolute location

Definition at line 94 of file argListI.H.

References fileName::relative().

Referenced by if().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ distributed()

bool distributed ( ) const

inline

Return distributed flag (i.e. are rootPaths different on different machines)

Definition at line 103 of file argListI.H.

◆ parRunControl()

const Foam::ParRunControl & parRunControl ( ) const

inline

Return the ParRunControl.

Definition at line 109 of file argListI.H.

◆ libs() [1/2]

const Foam::dlLibraryTable & libs ( ) const

inline

Access to the loaded libraries.

Definition at line 115 of file argListI.H.

◆ libs() [2/2]

Foam::dlLibraryTable & libs ( )

inline

Access to the loaded libraries.

Definition at line 121 of file argListI.H.

◆ size()

Foam::label size ( ) const

inlinenoexcept

The number of arguments.

Definition at line 127 of file argListI.H.

Referenced by functionObjectList::readFunctionObject(), and zoltanRenumber::renumber().

Here is the caller graph for this function:

◆ args() [1/2]

const Foam::stringList & args ( ) const

inline

Return arguments.

Definition at line 133 of file argListI.H.

◆ args() [2/2]

Foam::stringList & args ( )

inline

Non-const access to the command arguments (non-options)

Definition at line 139 of file argListI.H.

◆ options() [1/2]

const Foam::HashTable< Foam::string > & options ( ) const

inline

Return options.

Definition at line 145 of file argListI.H.

◆ options() [2/2]

Foam::HashTable< Foam::string > & options ( )

inline

Return non-const access to the command options.

Definition at line 151 of file argListI.H.

◆ found()

bool found ( const word & optName ) const

inline

Return true if the named option is found.

Definition at line 157 of file argListI.H.

Referenced by if(), dynamicFvMesh::New(), functionObjectList::New(), timeSelector::select(), timeSelector::selectIfPresent(), and Time::Time().

Here is the caller graph for this function:

◆ count() [1/2]

Foam::label count ( const UList< word > & optionNames ) const

Return how many of the specified options were used.

Definition at line 1559 of file argList.C.

References n.

◆ count() [2/2]

Foam::label count ( std::initializer_list< word > optionNames ) const

Return how many of the specified options were used.

Definition at line 1574 of file argList.C.

References n.

◆ lookup()

Foam::ITstream lookup ( const word & optName ) const

inline

Return an input stream from the named option.

Definition at line 163 of file argListI.H.

◆ get() [1/11]

T get ( const label index ) const

inline

Get a value from the argument at index.

Index 1 is the first (non-option) argument.

Definition at line 257 of file argListI.H.

References Foam::name(), Foam::T(), and argList::val.

Referenced by if(), and functionObjectList::New().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getList() [1/4]

List<T> getList ( const label index ) const

inline

Get a List of values from the argument at index.

Index 1 is the first (non-option) argument.

Referenced by functionObjectList::New().

Here is the caller graph for this function:

◆ get() [2/11]

T get ( const word & optName ) const

inline

Get a value from the named option.

The default template parameter is string (ie, no conversion).

Definition at line 271 of file argListI.H.

References Foam::T(), and Foam::val.

Here is the call graph for this function:

◆ get() [3/11]

T get	(	const word &	optName,
		const T &	deflt
	)		const

inline

Get a value from the named option if present, or return default.

Identical to getOrDefault().

Definition at line 285 of file argListI.H.

References found.

◆ readIfPresent() [1/2]

bool readIfPresent	(	const word &	optName,
		T &	val
	)		const

inline

Read a value from the named option if present.

Returns: true if the named option was found.

Definition at line 298 of file argListI.H.

References found, and Foam::val.

Referenced by if().

Here is the caller graph for this function:

◆ readIfPresent() [2/2]

bool readIfPresent	(	const word &	optName,
		T &	val,
		const T &	deflt
	)		const

inline

Read a value from the named option if present.

Returns: true if the named option was found, otherwise use the supplied default and return false.

Definition at line 315 of file argListI.H.

References Foam::val.

◆ getOrDefault()

T getOrDefault	(	const word &	optName,
		const T &	deflt
	)		const

inline

Get a value from the named option if present, or return default.

Definition at line 333 of file argListI.H.

References found.

◆ getList() [2/4]

List<T> getList	(	const word &	optName,
		bool	mandatory = `true`
	)		const

inline

Get a List of values from the named option, treating a single entry like a list of size 1.

Parameters

optName	the option name to read from
mandatory	if the option is non-mandatory, the behaviour is similar to readListIfPresent().

◆ readListIfPresent()

bool readListIfPresent	(	const word &	optName,
		List< T > &	list
	)		const

inline

If named option is present, get a List of values treating a single entry like a list of size 1.

Returns: true if the named option was found.

Definition at line 385 of file argListI.H.

References found.

◆ opt() [1/2]

T opt ( const word & optName ) const

inline

Alternative name for option get(const word& optName)

Definition at line 435 of file argList.H.

◆ opt() [2/2]

T opt	(	const word &	optName,
		const T &	deflt
	)		const

inline

Alternative name for option get(const word& optName, ...)

Definition at line 442 of file argList.H.

References argList::deflt.

◆ addArgument()

addArgument	(	const string &	argName,
		const string &	usage = `""`
	)

static

Append a (mandatory) argument to validArgs.

Definition at line 292 of file argList.C.

◆ addBoolOption()

addBoolOption	(	const word &	optName,
		const string &	usage = `""`,
		bool	advanced = `false`
	)

static

Add a bool option to validOptions with usage information.

Definition at line 315 of file argList.C.

Referenced by timeSelector::addOptions().

Here is the caller graph for this function:

◆ addOption()

addOption	(	const word &	optName,
		const string &	param = `""`,
		const string &	usage = `""`,
		bool	advanced = `false`
	)

static

Add an option to validOptions with usage information.

An option with an empty param is a bool option

Definition at line 326 of file argList.C.

Referenced by timeSelector::addOptions().

Here is the caller graph for this function:

◆ setAdvanced()

void setAdvanced	(	const word &	optName,
		bool	advanced = `true`
	)

static

Set an existing option as being 'advanced' or normal.

Definition at line 345 of file argList.C.

◆ addOptionCompat()

void addOptionCompat	(	const word &	optName,
		std::pair< const char *, int >	compat
	)

static

Specify an alias for the option name.

Parameters

optName	the currently used option name
compat	alias name and the last OpenFOAM version (YYMM) when the alias was not needed. Setting a zero or negative version suppresses warnings about the alias.

Definition at line 359 of file argList.C.

◆ ignoreOptionCompat()

void ignoreOptionCompat	(	std::pair< const char *, int >	compat,
		bool	expectArg
	)

static

Specify an option to be ignored.

Parameters

compat	optName and the last OpenFOAM version (YYMM) when the option was directly supported. Setting a zero or negative version suppresses warnings about the alias.
expectArg	the option is non-bool

Definition at line 373 of file argList.C.

◆ addUsage()

void addUsage	(	const word &	optName,
		const string &	usage
	)

static

Add option usage information to optionUsage.

Definition at line 387 of file argList.C.

◆ addNote()

addNote ( const string & note )

static

Add extra notes for the usage information.

This string is used "as-is" without additional formatting

Definition at line 403 of file argList.C.

◆ removeOption()

void removeOption ( const word & optName )

static

Remove option from validOptions and from optionUsage.

Definition at line 412 of file argList.C.

◆ noMandatoryArgs()

void noMandatoryArgs ( )

static

Flag command arguments as being optional (non-mandatory)

Definition at line 420 of file argList.C.

◆ argsMandatory()

bool argsMandatory ( )

static

Command arguments type (optional/mandatory).

Definition at line 426 of file argList.C.

◆ noBanner()

void noBanner ( )

static

Disable emitting the banner information.

Adjusts the Foam::infoDetailLevel flag.

Definition at line 432 of file argList.C.

References Foam::infoDetailLevel.

◆ bannerEnabled()

bool bannerEnabled ( )

static

Banner status (enabled/disabled).

Queries the Foam::infoDetailLevel flag.

Definition at line 438 of file argList.C.

References Foam::infoDetailLevel.

◆ noFunctionObjects()

void noFunctionObjects ( bool addWithOption = false )

static

Remove '-noFunctionObjects' option and ignore any occurances.

Optionally add a '-withFunctionObjects' option instead

Definition at line 444 of file argList.C.

◆ noJobInfo()

void noJobInfo ( )

static

Suppress JobInfo, overriding controlDict setting.

Definition at line 464 of file argList.C.

References JobInfo::writeJobInfo.

◆ noLibs()

void noLibs ( )

static

Add the '-no-libs' command line option.

Definition at line 470 of file argList.C.

◆ noParallel()

void noParallel ( )

static

Remove the parallel options.

Definition at line 481 of file argList.C.

◆ noCheckProcessorDirectories()

void noCheckProcessorDirectories ( )

static

Remove checking of processor directories.

Definition at line 491 of file argList.C.

◆ postProcess()

bool postProcess	(	int	argc,
		char *	argv[]
	)

static

Return true if the post-processing option is specified.

Definition at line 497 of file argList.C.

◆ setOption()

bool setOption	(	const word &	optName,
		const string &	param = `""`
	)

Set option directly (use with caution)

An option with an empty param is a bool option. Not all valid options can also be set: eg, -case, -roots, ... Return true if the existing option value needed changing, or if the option did not previously exist.

Definition at line 1590 of file argList.C.

References Foam::exit(), Foam::FatalError, FatalErrorInFunction, and Foam::nl.

Here is the call graph for this function:

◆ unsetOption()

bool unsetOption ( const word & optName )

Unset option directly (use with caution)

Not all valid options can also be unset: eg, -case, -roots ... Return true if the option existed before being unset.

Definition at line 1616 of file argList.C.

References Foam::exit(), Foam::FatalError, FatalErrorInFunction, and Foam::nl.

Here is the call graph for this function:

◆ printCompat()

void printCompat ( ) const

Print option compatibility.

Definition at line 514 of file argListHelp.C.

References HashTable< T, Key, Hash >::cfind(), argList::ignoreOptionsCompat, Foam::Info, k, Foam::nl, Foam::setf(), Foam::setfill(), Foam::setw(), token::SPACE, and argList::validOptionsCompat.

Here is the call graph for this function:

◆ printNotes()

void printNotes ( ) const

Print notes (if any)

Definition at line 436 of file argListHelp.C.

References Foam::Info, Foam::nl, and Foam::stringOps::writeWrapped().

Here is the call graph for this function:

◆ printUsage()

void printUsage ( bool full = true ) const

Print usage.

Definition at line 335 of file argListHelp.C.

References argList::argUsage, Foam::endl(), argList::ignoreOptionsCompat, Foam::Info, Foam::nl, Foam::foamVersion::printBuildInfo(), Foam::printOption(), Foam::printOptionUsage(), and argList::validOptionsCompat.

Here is the call graph for this function:

◆ printMan()

void printMan ( ) const

Print usage as nroff-man format (Experimental)

Definition at line 169 of file argListHelp.C.

References argList::advancedOptions, Foam::foamVersion::api, argList::argUsage, token::DQUOTE, HashTable< T, Key, Hash >::empty(), argList::ignoreOptionsCompat, Foam::Info, Foam::nl, argList::notes, Foam::printManFooter(), Foam::printManOption(), token::SPACE, Foam::stringOps::upper(), argList::usageMax, argList::validArgs, argList::validOptions, argList::validOptionsCompat, and Foam::stringOps::writeWrapped().

Here is the call graph for this function:

◆ displayDoc()

void displayDoc ( bool source = false ) const

Display documentation in browser.

Optionally display the application source code

Definition at line 1638 of file argList.C.

References Foam::foamVersion::api, Foam::debug::controlDict(), Foam::endl(), Foam::stringOps::expand(), dictionary::get(), Foam::getEnv(), Foam::Info, Foam::isFile(), Foam::nl, dictionary::readEntry(), string::replace(), Foam::stringOps::splitSpace(), string::starts_with(), dictionary::subDict(), and Foam::system().

Here is the call graph for this function:

◆ check()

bool check	(	bool	checkArgs = `argList::argsMandatory()`,
		bool	checkOpts = `true`
	)		const

Check the parsed command-line for mandatory arguments and that all the options are correct.

By default, the argument check respects the value of argsMandatory() to decide if the arguments should be checked (when they are mandatory) or not (when they are optional)

Definition at line 1712 of file argList.C.

References Foam::endl(), Foam::FatalError, forAllConstIters(), UPstream::master(), and Foam::nl.

Here is the call graph for this function:

◆ checkRootCase()

bool checkRootCase ( ) const

Check root path and case path.

Definition at line 1758 of file argList.C.

References Foam::endl(), Foam::FatalError, Foam::fileHandler(), Foam::isDir(), UPstream::master(), and path().

Here is the call graph for this function:

◆ operator[]() [1/2]

const Foam::string & operator[] ( const label index ) const

inline

The string corresponding to the argument index.

Index 0 is the executable. Index 1 is the first (non-option) argument.

Definition at line 407 of file argListI.H.

◆ operator[]() [2/2]

const Foam::string & operator[] ( const word & optName ) const

inline

The string associated with the named option.

Definition at line 413 of file argListI.H.

◆ lookupOrDefault()

T lookupOrDefault	(	const word &	optName,
		const T &	deflt
	)		const

inline

Get a value from the named option if present, or return default.

Definition at line 616 of file argList.H.

References argList::deflt.

◆ FOAM_DEPRECATED_FOR() [1/9]

T FOAM_DEPRECATED_FOR	(	2018-	08,
		"get() method"
	)		const

inline

Deprecated(2018-08) read a value from the argument at index.

Index 1 is the first (non-option) argument.

Deprecated:: (2018-08) - use get() method

Definition at line 630 of file argList.H.

◆ FOAM_DEPRECATED_FOR() [2/9]

T FOAM_DEPRECATED_FOR	(	2018-	01,
		"get() method"
	)		const

inline

Deprecated(2018-01) read a value from the argument at index.

Index 1 is the first (non-option) argument.

Deprecated:: (2018-01) - use get() method

Definition at line 640 of file argList.H.

◆ FOAM_DEPRECATED_FOR() [3/9]

bool FOAM_DEPRECATED_FOR	(	2018-	01,
		"found() method"
	)		const &

inline

Deprecated(2018-01) return true if the named option is found.

Deprecated:: (2018-01) - use found() method

Definition at line 648 of file argList.H.

◆ FOAM_DEPRECATED_FOR() [4/9]

ITstream FOAM_DEPRECATED_FOR	(	2018-	01,
		"lookup() method"
	)		const &

inline

Deprecated(2018-01) return an input stream from the named option.

Deprecated:: (2018-01) - use lookup() method

Definition at line 656 of file argList.H.

◆ FOAM_DEPRECATED_FOR() [5/9]

T FOAM_DEPRECATED_FOR	(	2018-	01,
		"get() method"
	)		const &

inline

Deprecated(2018-01) read a value from the named option.

Deprecated:: (2018-01) - use get() method

Definition at line 665 of file argList.H.

◆ FOAM_DEPRECATED_FOR() [6/9]

bool FOAM_DEPRECATED_FOR	(	2018-	01,
		"readIfPresent() method"
	)		const &

Deprecated(2018-01) read a value from the named option if present.

Return true if the named option was found.

Deprecated:: (2018-01) - use readIfPresent() method

◆ FOAM_DEPRECATED_FOR() [7/9]

bool FOAM_DEPRECATED_FOR	(	2018-	01,
		"readIfPresent() method"
	)		const &

Deprecated(2018-01) read a value from the named option if present.

Return true if the named option was found, otherwise use the supplied default and return false.

Deprecated:: (2018-01) - use readIfPresent() method

◆ FOAM_DEPRECATED_FOR() [8/9]

T FOAM_DEPRECATED_FOR	(	2018-	01,
		"getOrDefault() method"
	)		const &

Deprecated(2018-01) read a value from the named option if present.

Return supplied default otherwise.

Deprecated:: (2018-01) - use getOrDefault() method

◆ FOAM_DEPRECATED_FOR() [9/9]

List<T> FOAM_DEPRECATED_FOR	(	2018-	01,
		"getList() method"
	)		const &

inline

Deprecated(2018-01) read a List of values from the named option.

Deprecated:: (2018-01) - use getList() method

Definition at line 718 of file argList.H.

◆ get() [4/11]

int32_t get ( const label index ) const

inline

Definition at line 173 of file argListI.H.

References Foam::readInt32().

Here is the call graph for this function:

◆ get() [5/11]

int64_t get ( const label index ) const

inline

Definition at line 178 of file argListI.H.

References Foam::readInt64().

Here is the call graph for this function:

◆ get() [6/11]

float get ( const label index ) const

inline

Definition at line 183 of file argListI.H.

◆ get() [7/11]

double get ( const label index ) const

inline

Definition at line 188 of file argListI.H.

◆ get() [8/11]

int32_t get ( const word & optName ) const

inline

Definition at line 194 of file argListI.H.

References Foam::readInt32().

Here is the call graph for this function:

◆ get() [9/11]

int64_t get ( const word & optName ) const

inline

Definition at line 199 of file argListI.H.

References Foam::readInt64().

Here is the call graph for this function:

◆ get() [10/11]

float get ( const word & optName ) const

inline

Definition at line 204 of file argListI.H.

◆ get() [11/11]

double get ( const word & optName ) const

inline

Definition at line 209 of file argListI.H.

◆ getList() [3/4]

Foam::List<T> getList ( const label index ) const

inline

Definition at line 348 of file argListI.H.

References Foam::name().

Here is the call graph for this function:

◆ getList() [4/4]

Foam::List<T> getList	(	const word &	optName,
		bool	mandatory
	)		const

inline

Definition at line 363 of file argListI.H.

References found.

Member Data Documentation

◆ validArgs

Foam::SLList< Foam::string > validArgs

static

A list of valid (mandatory) arguments.

Definition at line 201 of file argList.H.

Referenced by argList::printMan().

◆ advancedOptions

Foam::HashSet< Foam::string > advancedOptions

static

The "advanced" options are shown with -help-full (not with –help)

Definition at line 204 of file argList.H.

Referenced by argList::printMan().

◆ validOptions

Foam::HashTable< Foam::string > validOptions

static

A list of valid options.

Definition at line 207 of file argList.H.

Referenced by argList::printMan(), Foam::printManOption(), Foam::printOption(), timeSelector::select(), and Time::Time().

◆ validParOptions

Foam::HashTable< Foam::string > validParOptions

static

A list of valid parallel options.

Definition at line 210 of file argList.H.

Referenced by Foam::printManOption().

◆ validOptionsCompat

Foam::HashTable< std::pair< Foam::word, int > > validOptionsCompat

static

A list of aliases for options.

Stored as (alias = canonical, version)

Definition at line 214 of file argList.H.

Referenced by argList::printCompat(), argList::printMan(), and argList::printUsage().

◆ ignoreOptionsCompat

Foam::HashTable< std::pair< bool, int > > ignoreOptionsCompat

static

A list of options to ignore.

Stored as (option = bool, version)

Definition at line 218 of file argList.H.

Referenced by argList::printCompat(), argList::printMan(), and argList::printUsage().

◆ argUsage

Foam::HashTable< Foam::string, Foam::label, Foam::Hash< Foam::label > > argUsage

static

Short description for program arguments.

Definition at line 221 of file argList.H.

Referenced by argList::printMan(), and argList::printUsage().

◆ optionUsage

Foam::HashTable< Foam::string > optionUsage

static

Short description for validOptions.

Definition at line 224 of file argList.H.

Referenced by Foam::printManOption(), and Foam::printOption().

◆ notes

Foam::SLList< Foam::string > notes

static

General usage notes.

Definition at line 227 of file argList.H.

Referenced by argList::printMan().

◆ usageMin

std::string::size_type usageMin = 20

static

Min indentation when displaying usage (default: 20)

Definition at line 230 of file argList.H.

Referenced by Foam::printOptionUsage().

◆ usageMax

std::string::size_type usageMax = 80

static

Max screen width when displaying usage (default: 80)

Definition at line 233 of file argList.H.

Referenced by argList::printMan(), Foam::printManOption(), and Foam::printOptionUsage().

◆ postProcessOptionName

Foam::word postProcessOptionName

static

Standard name for the post-processing option.

Definition at line 236 of file argList.H.

◆ val [1/2]

bool T& const val

Initial value:

{

return readIfPresent<T>(optName, val)

Definition at line 681 of file argList.H.

Referenced by argList::get().

◆ val [2/2]

bool T& val

Definition at line 694 of file argList.H.

◆ deflt [1/2]

bool T const T& const deflt

Initial value:

{

return readIfPresent<T>(optName, val, deflt)

Definition at line 697 of file argList.H.

Referenced by argList::lookupOrDefault(), and argList::opt().

◆ deflt [2/2]

T const T& const deflt

Initial value:

{

return getOrDefault<T>(optName, deflt)

Definition at line 711 of file argList.H.

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

src/OpenFOAM/global/argList/argList.H
src/OpenFOAM/db/functionObjects/functionObjectList/postProcess.H
src/OpenFOAM/global/argList/argList.C
src/OpenFOAM/global/argList/argListHelp.C
src/OpenFOAM/global/argList/argListI.H
src/OpenFOAM/include/addCheckCaseOptions.H
src/OpenFOAM/include/addDictOption.H
src/OpenFOAM/include/addFunctionObjectOptions.H
src/OpenFOAM/include/addOverwriteOption.H
src/OpenFOAM/include/addProfilingOption.H
src/OpenFOAM/include/addRegionOption.H
src/OpenFOAM/include/addTimeOptions.H
src/OpenFOAM/include/setRootCaseListOptions.H
applications/utilities/miscellaneous/foamHelp/addToolOption.H
applications/utilities/preProcessing/createExternalCoupledPatchGeometry/addRegionsOption.H

Public Member Functions

Static Public Member Functions

Public Attributes

Static Public Attributes

Detailed Description

Constructor & Destructor Documentation

◆ argList() [1/2]

◆ argList() [2/2]

◆ ~argList()

Member Function Documentation

◆ envGlobalPath()

◆ parse()

◆ executable()

◆ commandLine()

◆ rootPath()

◆ caseName()

◆ globalCaseName()

◆ path()

◆ globalPath()

◆ relativePath()

◆ distributed()

◆ parRunControl()

◆ libs() [1/2]

◆ libs() [2/2]

◆ size()

◆ args() [1/2]

◆ args() [2/2]

◆ options() [1/2]

◆ options() [2/2]

◆ found()

◆ count() [1/2]

◆ count() [2/2]

◆ lookup()

◆ get() [1/11]

◆ getList() [1/4]

◆ get() [2/11]

◆ get() [3/11]

◆ readIfPresent() [1/2]

◆ readIfPresent() [2/2]

◆ getOrDefault()

◆ getList() [2/4]

◆ readListIfPresent()

◆ opt() [1/2]

◆ opt() [2/2]

◆ addArgument()

◆ addBoolOption()

◆ addOption()

◆ setAdvanced()

◆ addOptionCompat()

◆ ignoreOptionCompat()

◆ addUsage()

◆ addNote()

◆ removeOption()

◆ noMandatoryArgs()

◆ argsMandatory()

◆ noBanner()

◆ bannerEnabled()

◆ noFunctionObjects()

◆ noJobInfo()

◆ noLibs()

◆ noParallel()

◆ noCheckProcessorDirectories()

◆ postProcess()

◆ setOption()

◆ unsetOption()

◆ printCompat()

◆ printNotes()

◆ printUsage()

◆ printMan()

◆ displayDoc()

◆ check()

◆ checkRootCase()

◆ operator[]() [1/2]

◆ operator[]() [2/2]

◆ lookupOrDefault()

◆ FOAM_DEPRECATED_FOR() [1/9]

◆ FOAM_DEPRECATED_FOR() [2/9]

◆ FOAM_DEPRECATED_FOR() [3/9]

◆ FOAM_DEPRECATED_FOR() [4/9]

◆ FOAM_DEPRECATED_FOR() [5/9]