The basic unlabeled argument that parses a value.
This is a template class, which means the type T defines the type that a given object will attempt to parse when an UnlabeledValueArg is reached in the list of args that the CmdLine iterates over.
Definition at line 67 of file UnlabeledValueArg.h.
#include <mrpt/otherlibs/tclap/UnlabeledValueArg.h>
Public Member Functions | |
UnlabeledValueArg (const std::string &name, const std::string &desc, bool req, T value, const std::string &typeDesc, bool ignoreable=false, Visitor *v=NULL) | |
UnlabeledValueArg constructor. More... | |
UnlabeledValueArg (const std::string &name, const std::string &desc, bool req, T value, const std::string &typeDesc, CmdLineInterface &parser, bool ignoreable=false, Visitor *v=NULL) | |
UnlabeledValueArg constructor. More... | |
UnlabeledValueArg (const std::string &name, const std::string &desc, bool req, T value, Constraint< T > *constraint, bool ignoreable=false, Visitor *v=NULL) | |
UnlabeledValueArg constructor. More... | |
UnlabeledValueArg (const std::string &name, const std::string &desc, bool req, T value, Constraint< T > *constraint, CmdLineInterface &parser, bool ignoreable=false, Visitor *v=NULL) | |
UnlabeledValueArg constructor. More... | |
virtual bool | processArg (int *i, std::vector< std::string > &args) |
Handles the processing of the argument. More... | |
virtual std::string | shortID (const std::string &val="val") const |
Overrides shortID for specific behavior. More... | |
virtual std::string | longID (const std::string &val="val") const |
Overrides longID for specific behavior. More... | |
virtual bool | operator== (const Arg &a) const |
Overrides operator== for specific behavior. More... | |
virtual void | addToList (std::list< Arg * > &argList) const |
Instead of pushing to the front of list, push to the back. More... | |
T & | getValue () |
Returns the value of the argument. More... | |
const std::string & | getFlag () const |
Returns the argument flag. More... | |
const std::string & | getName () const |
Returns the argument name. More... | |
std::string | getDescription () const |
Returns the argument description. More... | |
virtual bool | isRequired () const |
Indicates whether the argument is required. More... | |
void | forceRequired () |
Sets _required to true. More... | |
void | xorSet () |
Sets the _alreadySet value to true. More... | |
bool | isValueRequired () const |
Indicates whether a value must be specified for argument. More... | |
bool | isSet () const |
Indicates whether the argument has already been set. More... | |
bool | isIgnoreable () const |
Indicates whether the argument can be ignored, if desired. More... | |
virtual bool | argMatches (const std::string &s) const |
A method that tests whether a string matches this argument. More... | |
virtual std::string | toString () const |
Returns a simple string representation of the argument. More... | |
virtual void | trimFlag (std::string &flag, std::string &value) const |
Trims a value off of the flag. More... | |
bool | _hasBlanks (const std::string &s) const |
Checks whether a given string has blank chars, indicating that it is a combined SwitchArg. More... | |
void | setRequireLabel (const std::string &s) |
Sets the requireLabel. More... | |
virtual bool | allowMore () |
virtual bool | acceptsMultipleValues () |
Static Public Member Functions | |
static void | beginIgnoring () |
Begin ignoring arguments since the "--" argument was specified. More... | |
static bool | ignoreRest () |
Whether to ignore the rest. More... | |
static char | delimiter () |
The delimiter that separates an argument flag/name from the value. More... | |
static char | blankChar () |
The char used as a place holder when SwitchArgs are combined. More... | |
static char | flagStartChar () |
The char that indicates the beginning of a flag. More... | |
static const std::string | flagStartString () |
The sting that indicates the beginning of a flag. More... | |
static const std::string | nameStartString () |
The sting that indicates the beginning of a name. More... | |
static const std::string | ignoreNameString () |
The name used to identify the ignore rest argument. More... | |
static void | setDelimiter (char c) |
Sets the delimiter for all arguments. More... | |
Protected Member Functions | |
void | _extractValue (const std::string &val) |
Extracts the value from the string. More... | |
void | _checkWithVisitor () const |
Performs the special handling described by the Vistitor. More... | |
Protected Attributes | |
T | _value |
The value parsed from the command line. More... | |
std::string | _typeDesc |
A human readable description of the type to be parsed. More... | |
Constraint< T > * | _constraint |
A Constraint this Arg must conform to. More... | |
std::string | _flag |
The single char flag used to identify the argument. More... | |
std::string | _name |
A single work namd indentifying the argument. More... | |
std::string | _description |
Description of the argument. More... | |
bool | _required |
Indicating whether the argument is required. More... | |
std::string | _requireLabel |
Label to be used in usage description. More... | |
bool | _valueRequired |
Indicates whether a value is required for the argument. More... | |
bool | _alreadySet |
Indicates whether the argument has been set. More... | |
Visitor * | _visitor |
A pointer to a vistitor object. More... | |
bool | _ignoreable |
Whether this argument can be ignored, if desired. More... | |
bool | _xorSet |
Indicates that the arg was set as part of an XOR and not on the command line. More... | |
bool | _acceptsMultipleValues |
Static Private Member Functions | |
static bool & | ignoreRestRef () |
Indicates whether the rest of the arguments should be ignored. More... | |
static char & | delimiterRef () |
The delimiter that separates an argument flag/name from the value. More... | |
TCLAP::UnlabeledValueArg< T >::UnlabeledValueArg | ( | const std::string & | name, |
const std::string & | desc, | ||
bool | req, | ||
T | value, | ||
const std::string & | typeDesc, | ||
bool | ignoreable = false , |
||
Visitor * | v = NULL |
||
) |
UnlabeledValueArg constructor.
Constructor implemenation.
name | - A one word name for the argument. Can be used as a long flag on the command line. |
desc | - A description of what the argument is for or does. |
req | - Whether the argument is required on the command line. |
value | - The default value assigned to this argument if it is not present on the command line. |
typeDesc | - A short, human readable description of the type that this object expects. This is used in the generation of the USAGE statement. The goal is to be helpful to the end user of the program. |
ignoreable | - Allows you to specify that this argument can be ignored if the '–' flag is set. This defaults to false (cannot be ignored) and should generally stay that way unless you have some special need for certain arguments to be ignored. |
v | - Optional Vistor. You should leave this blank unless you have a very good reason. |
Definition at line 237 of file UnlabeledValueArg.h.
References TCLAP::Arg::_ignoreable, TCLAP::CmdLineInterface::add(), TCLAP::OptionalUnlabeledTracker< DUMMY >::check(), and TCLAP::Arg::toString().
TCLAP::UnlabeledValueArg< T >::UnlabeledValueArg | ( | const std::string & | name, |
const std::string & | desc, | ||
bool | req, | ||
T | value, | ||
const std::string & | typeDesc, | ||
CmdLineInterface & | parser, | ||
bool | ignoreable = false , |
||
Visitor * | v = NULL |
||
) |
UnlabeledValueArg constructor.
name | - A one word name for the argument. Can be used as a long flag on the command line. |
desc | - A description of what the argument is for or does. |
req | - Whether the argument is required on the command line. |
value | - The default value assigned to this argument if it is not present on the command line. |
typeDesc | - A short, human readable description of the type that this object expects. This is used in the generation of the USAGE statement. The goal is to be helpful to the end user of the program. |
parser | - A CmdLine parser object to add this Arg to |
ignoreable | - Allows you to specify that this argument can be ignored if the '–' flag is set. This defaults to false (cannot be ignored) and should generally stay that way unless you have some special need for certain arguments to be ignored. |
v | - Optional Vistor. You should leave this blank unless you have a very good reason. |
Definition at line 253 of file UnlabeledValueArg.h.
References TCLAP::Arg::_ignoreable, TCLAP::OptionalUnlabeledTracker< DUMMY >::check(), and TCLAP::Arg::toString().
TCLAP::UnlabeledValueArg< T >::UnlabeledValueArg | ( | const std::string & | name, |
const std::string & | desc, | ||
bool | req, | ||
T | value, | ||
Constraint< T > * | constraint, | ||
bool | ignoreable = false , |
||
Visitor * | v = NULL |
||
) |
UnlabeledValueArg constructor.
Constructor implemenation.
name | - A one word name for the argument. Can be used as a long flag on the command line. |
desc | - A description of what the argument is for or does. |
req | - Whether the argument is required on the command line. |
value | - The default value assigned to this argument if it is not present on the command line. |
constraint | - A pointer to a Constraint object used to constrain this Arg. |
ignoreable | - Allows you to specify that this argument can be ignored if the '–' flag is set. This defaults to false (cannot be ignored) and should generally stay that way unless you have some special need for certain arguments to be ignored. |
v | - Optional Vistor. You should leave this blank unless you have a very good reason. |
Definition at line 272 of file UnlabeledValueArg.h.
References TCLAP::Arg::_ignoreable, TCLAP::CmdLineInterface::add(), TCLAP::OptionalUnlabeledTracker< DUMMY >::check(), and TCLAP::Arg::toString().
TCLAP::UnlabeledValueArg< T >::UnlabeledValueArg | ( | const std::string & | name, |
const std::string & | desc, | ||
bool | req, | ||
T | value, | ||
Constraint< T > * | constraint, | ||
CmdLineInterface & | parser, | ||
bool | ignoreable = false , |
||
Visitor * | v = NULL |
||
) |
UnlabeledValueArg constructor.
name | - A one word name for the argument. Can be used as a long flag on the command line. |
desc | - A description of what the argument is for or does. |
req | - Whether the argument is required on the command line. |
value | - The default value assigned to this argument if it is not present on the command line. |
constraint | - A pointer to a Constraint object used to constrain this Arg. |
parser | - A CmdLine parser object to add this Arg to |
ignoreable | - Allows you to specify that this argument can be ignored if the '–' flag is set. This defaults to false (cannot be ignored) and should generally stay that way unless you have some special need for certain arguments to be ignored. |
v | - Optional Vistor. You should leave this blank unless you have a very good reason. |
Definition at line 286 of file UnlabeledValueArg.h.
|
inlineprotectedinherited |
|
protectedinherited |
Extracts the value from the string.
Attempts to parse string as type T, if this fails an exception is thrown.
val | - value to be parsed. |
Definition at line 488 of file ValueArg.h.
References TCLAP::VALUE_ARG_HELPER::EXTRACT_FAILURE, TCLAP::VALUE_ARG_HELPER::EXTRACT_TOO_MANY, and TCLAP::VALUE_ARG_HELPER::ValueExtractor< T >::extractValue().
|
inlineinherited |
|
inlinevirtualinherited |
|
virtual |
Instead of pushing to the front of list, push to the back.
argList | - The list to add this to. |
Reimplemented from TCLAP::Arg.
Definition at line 359 of file UnlabeledValueArg.h.
|
inlinevirtualinherited |
Reimplemented in TCLAP::MultiArg< T >.
|
inlinevirtualinherited |
A method that tests whether a string matches this argument.
This is generally called by the processArg() method. This method could be re-implemented by a child to change how arguments are specified on the command line.
s | - The string to be compared to the flag/name to determine whether the arg matches. |
|
inlinestaticinherited |
|
inlinestaticinherited |
The char used as a place holder when SwitchArgs are combined.
Currently set to '*', which shouldn't cause many problems since *'s are expanded by most shells on the command line.
Definition at line 232 of file Arg.h.
Referenced by TCLAP::Arg::trimFlag().
|
inlinestaticinherited |
The delimiter that separates an argument flag/name from the value.
Definition at line 225 of file Arg.h.
Referenced by TCLAP::MultiArg< T >::processArg(), TCLAP::ValueArg< T >::processArg(), and TCLAP::Arg::toString().
|
inlinestaticprivateinherited |
The delimiter that separates an argument flag/name from the value.
Definition at line 100 of file Arg.h.
Referenced by TCLAP::Arg::ignoreRest().
|
inlinestaticinherited |
|
inlinestaticinherited |
The sting that indicates the beginning of a flag.
Currently "-". Should be identical to flagStartChar.
Definition at line 243 of file Arg.h.
Referenced by TCLAP::Arg::isValueRequired().
|
inlineinherited |
Sets _required to true.
This is used by the XorHandler. You really have no reason to ever use it.
|
inlineinherited |
Returns the argument description.
Definition at line 480 of file Arg.h.
References TCLAP::Arg::_valueRequired.
Referenced by TCLAP::UnlabeledMultiArg< T >::shortID().
|
inlineinherited |
|
inlineinherited |
Returns the argument name.
Definition at line 495 of file Arg.h.
Referenced by TCLAP::UnlabeledMultiArg< T >::shortID().
|
inherited |
Returns the value of the argument.
Implementation of getValue().
Definition at line 420 of file ValueArg.h.
|
inlinestaticinherited |
|
inlinestaticinherited |
Whether to ignore the rest.
Definition at line 219 of file Arg.h.
References TCLAP::Arg::delimiterRef().
Referenced by TCLAP::MultiArg< T >::processArg(), and TCLAP::ValueArg< T >::processArg().
|
inlinestaticprivateinherited |
|
inlineinherited |
|
inlinevirtualinherited |
Indicates whether the argument is required.
Reimplemented in TCLAP::MultiArg< T >.
|
inlineinherited |
|
inlineinherited |
Indicates whether a value must be specified for argument.
Definition at line 499 of file Arg.h.
References TCLAP::Arg::_flag, and TCLAP::Arg::flagStartString().
|
virtual |
Overrides longID for specific behavior.
Overriding longID for specific output.
Reimplemented from TCLAP::ValueArg< T >.
Definition at line 336 of file UnlabeledValueArg.h.
|
inlinestaticinherited |
|
virtual |
Overrides operator== for specific behavior.
Overriding operator== for specific behavior.
Reimplemented from TCLAP::Arg.
Definition at line 350 of file UnlabeledValueArg.h.
|
virtual |
Handles the processing of the argument.
Implementation of processArg().
This re-implements the Arg version of this method to set the _value of the argument appropriately. Handling specific to unlabled arguments.
i | - Pointer the the current argument in the list. |
args | - Mutable list of strings. |
Reimplemented from TCLAP::ValueArg< T >.
Definition at line 305 of file UnlabeledValueArg.h.
|
inlinestaticinherited |
Sets the delimiter for all arguments.
c | - The character that delimits flags/names from values. |
Definition at line 260 of file Arg.h.
Referenced by TCLAP::CmdLine::~CmdLine().
|
inlineinherited |
Sets the requireLabel.
Used by XorHandler. You shouldn't ever use this.
s | - Set the requireLabel to this value. |
|
virtual |
Overrides shortID for specific behavior.
Overriding shortID for specific output.
Reimplemented from TCLAP::ValueArg< T >.
Definition at line 325 of file UnlabeledValueArg.h.
|
inlinevirtualinherited |
Returns a simple string representation of the argument.
Primarily for debugging.
Definition at line 525 of file Arg.h.
References TCLAP::Arg::delimiter().
Referenced by TCLAP::UnlabeledMultiArg< T >::UnlabeledMultiArg(), and TCLAP::UnlabeledValueArg< T >::UnlabeledValueArg().
|
inlinevirtualinherited |
Trims a value off of the flag.
Implementation of trimFlag.
flag | - The string from which the flag and value will be trimmed. Contains the flag once the value has been trimmed. |
value | - Where the value trimmed from the string will be stored. |
Definition at line 546 of file Arg.h.
References TCLAP::Arg::blankChar().
|
inlineinherited |
Sets the _alreadySet value to true.
This is used by the XorHandler. You really have no reason to ever use it.
Definition at line 581 of file Arg.h.
References TCLAP::Arg::_acceptsMultipleValues.
|
protectedinherited |
Definition at line 172 of file Arg.h.
Referenced by TCLAP::MultiArg< T >::MultiArg(), and TCLAP::Arg::xorSet().
|
protectedinherited |
|
protectedinherited |
A Constraint this Arg must conform to.
Definition at line 182 of file ValueArg.h.
|
protectedinherited |
|
protectedinherited |
The single char flag used to identify the argument.
This value (preceded by a dash {-}), can be used to identify an argument on the command line. The _flag can be blank, in fact this is how unlabeled args work. Unlabeled args must override appropriate functions to get correct handling. Note that the _flag does NOT include the dash as part of the flag.
Definition at line 112 of file Arg.h.
Referenced by TCLAP::Arg::isValueRequired().
|
protectedinherited |
Whether this argument can be ignored, if desired.
Definition at line 164 of file Arg.h.
Referenced by TCLAP::UnlabeledMultiArg< T >::UnlabeledMultiArg(), and TCLAP::UnlabeledValueArg< T >::UnlabeledValueArg().
|
protectedinherited |
|
protectedinherited |
|
protectedinherited |
|
protectedinherited |
A human readable description of the type to be parsed.
This is a hack, plain and simple. Ideally we would use RTTI to return the name of type T, but until there is some sort of consistent support for human readable names, we are left to our own devices.
Definition at line 177 of file ValueArg.h.
|
protectedinherited |
The value parsed from the command line.
Can be of any type, as long as the >> operator for the type is defined.
Definition at line 168 of file ValueArg.h.
|
protectedinherited |
Indicates whether a value is required for the argument.
Note that the value may be required but the argument/value combination may not be, as specified by _required.
Definition at line 144 of file Arg.h.
Referenced by TCLAP::Arg::getDescription().
|
protectedinherited |
Page generated by Doxygen 1.8.16 for MRPT 1.4.0 SVN: at Mon Oct 14 23:08:25 UTC 2019 |