TAP
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Pages
Public Member Functions | Protected Attributes | List of all members
TAP::ConstArgument< T > Class Template Reference

Specialization of TypedArgument that acts as a switch on the command line, but stores an arbitrary constant in the given variable storage. More...

#include <TypedArgument.hpp>

Inheritance diagram for TAP::ConstArgument< T >:
TAP::TypedArgument< T, false > TAP::Argument TAP::BaseArgument

Public Member Functions

 ConstArgument (std::string description, T &storage, const T &value)
 Create a constant argument with aliases defined by the description, using an external variable to store a predefined value. More...
 
 ConstArgument (std::string description, char flag, T &storage, const T &value)
 Create a constant argument that is identified by a flag, using an external variable to store a predefined value. More...
 
 ConstArgument (std::string description, const std::string &name, T &storage, const T &value)
 Create a constant argument that is identified by a name, using an external variable to store a predefined value. More...
 
 ConstArgument (std::string description, char flag, const std::string &name, T &storage, const T &value)
 Create a constant argument that is identified by both a flag and a name, using an external variable to store a predefined value. More...
 
 ConstArgument (const ConstArgument &)=default
 ConstArgument copy constructor.
 
 ConstArgument (ConstArgument &&)=default
 ConstArgument move constructor.
 
virtual ~ConstArgument ()
 ConstArgument destructor.
 
ConstArgumentoperator= (const ConstArgument &other)=default
 ConstArgument assignment operator.
 
ConstArgumentoperator= (ConstArgument &&other)=default
 ConstArgument move assignment operator.
 
bool takes_value () const override
 See Argument::takes_value()
 
void set () const override
 See Argument::set()
 
std::unique_ptr< BaseArgumentclone () const &override
 See BaseArgument::clone().
 
std::unique_ptr< BaseArgumentclone ()&&override
 See BaseArgument::clone().
 
- Public Member Functions inherited from TAP::TypedArgument< T, false >
const STvalue () const
 Returns the value of this argument. More...
 
virtual TypedArgumentcheck (TypedArgumentCheckFunc< T, multi > typedCheckFunc)
 See Argument::check()
 
- Public Member Functions inherited from TAP::Argument
 Argument (std::string description)
 Create an argument with flag and/or name set by description. More...
 
 Argument (std::string description, char flag)
 Create an argument that is identified by a flag. More...
 
 Argument (std::string description, std::string name)
 Create an argument that is identified by a name. More...
 
 Argument (std::string description, char flag, std::string name)
 Create an argument that is identified by both a name and flag. More...
 
 Argument (const Argument &)=default
 Argument copy constructor.
 
 Argument (Argument &&)=default
 Argument move constructor.
 
virtual ~Argument ()
 Argument destructor.
 
Argumentoperator= (const Argument &other)=default
 Argument assignment operator.
 
Argumentoperator= (Argument &&other)=default
 Argument move assignment operator.
 
Argumentalias (char flag)
 An a flag alias for the argument. More...
 
Argumentalias (std::string name)
 An a name alias for the argument. More...
 
Argumentalias (char flag, std::string name)
 An both a flag and name alias for the argument. More...
 
const std::string & description () const
 Returns the description of this argument. More...
 
virtual Argumentcheck (ArgumentCheckFunc checkFunc)
 Set the check function to use. More...
 
bool matches () const
 Returns a pointer to this argument if it matches as a positional argument, otherwise a null-pointer. More...
 
bool matches (char flag) const
 Returns a pointer to this argument if it matches the given flag with any alias, otherwise a null-pointer. More...
 
bool matches (const std::string &name) const
 Returns a pointer to this argument if it matches the given name with any alias, otherwise a null-pointer. More...
 
void find_all_arguments (std::vector< const Argument * > &collector) const override
 See BaseArgument::find_all_arguments()
 
Argumentmany (bool many=true)
 Allow the argument to occur multiple times or not. More...
 
Argumentmin (unsigned int min)
 Set the minimum number of required occurrences if set. More...
 
unsigned int min () const
 Returns the minimum number of occurrences of this argument for it to be satisfied if set. More...
 
Argumentmax (unsigned int max)
 Set the maximum number of required occurrences. More...
 
unsigned int max () const
 Returns the maximum number of occurrences of this argument. More...
 
unsigned int count () const override
 See BaseArgument::count()
 
bool can_set () const
 Returns whether this argument is still allowed to occur on the command line. More...
 
void check_valid () const override
 See BaseArgument::check_valid()
 
std::string usage () const override
 See BaseArgument::usage()
 
virtual std::string ident () const
 Print a string representation of this argument to the given stream. More...
 
- Public Member Functions inherited from TAP::BaseArgument
 BaseArgument ()
 Base constructor.
 
 BaseArgument (const BaseArgument &)=default
 BaseArgument copy constructor.
 
 BaseArgument (BaseArgument &&)=default
 BaseArgument move constructor.
 
virtual ~BaseArgument ()
 BaseArgument destructor.
 
BaseArgumentoperator= (const BaseArgument &)=default
 BaseArgument assignment operator.
 
BaseArgumentoperator= (BaseArgument &&)=default
 BaseArgument move assignment operator.
 
 operator bool () const
 Boolean conversion operator (so you can do things like if (arg) { ... More...
 
BaseArgumentset_required (bool required=true)
 Mark the argument as required or not. More...
 
bool required () const
 Returns whether the argument is required. More...
 

Protected Attributes

m_value
 Constant to store.
 
- Protected Attributes inherited from TAP::TypedArgument< T, false >
STm_storage
 Pointer to value storage.
 
TypedArgumentCheckFunc< T, multi > m_typedCheckFunc
 Callback for typed check.
 
- Protected Attributes inherited from TAP::Argument
std::string m_flags
 Flags this arguments matches.
 
std::vector< std::string > m_names
 Names this argument matches.
 
bool m_isPositional
 True if used as positional argument.
 
std::string m_description
 Description or help text of argument.
 
unsigned int m_min = 1
 Minimum number of occurrences if argument is set.
 
unsigned int m_max = 1
 Maximum number of occurrences. More...
 
std::shared_ptr< unsigned int > m_count
 Actual counted number of occurrences.
 
ArgumentCheckFunc m_checkFunc = nullptr
 Callback for check.
 
- Protected Attributes inherited from TAP::BaseArgument
bool m_required = false
 True if the argument has to be set.
 

Additional Inherited Members

- Protected Types inherited from TAP::TypedArgument< T, false >
using ST = typename std::conditional< !multi, T, std::vector< T > >::type
 Alias for the storage type (which is a vector for MultiValueArgument types)
 
- Protected Member Functions inherited from TAP::TypedArgument< T, false >
 TypedArgument (std::string description, ST *storage)
 Create a TypedArgument with given description and storage pointer. More...
 
 TypedArgument (std::string description, char flag, ST *storage)
 Create a TypedArgument with given description and storage pointer, aliased to the given flag. More...
 
 TypedArgument (std::string description, const std::string &name, ST *storage)
 Create a TypedArgument with given description and storage pointer, aliased to the given name. More...
 
 TypedArgument (std::string description, char flag, const std::string &name, ST *storage)
 Create a TypedArgument with given description and storage pointer, aliased to the given flag and name. More...
 
std::enable_if<!m >::type check () const override
 See Argument::check()
 
std::enable_if< m >::type check () const override
 See Argument::check()
 

Detailed Description

template<typename T>
class TAP::ConstArgument< T >

Specialization of TypedArgument that acts as a switch on the command line, but stores an arbitrary constant in the given variable storage.

Practical for for instance enumerations.

Constructor & Destructor Documentation

template<typename T >
TAP::ConstArgument< T >::ConstArgument ( std::string  description,
T &  storage,
const T &  value 
)
inline

Create a constant argument with aliases defined by the description, using an external variable to store a predefined value.

Parameters
descriptionDescription of the argument (used in help text). Must contain flag or name markers
storageVariable to store the value in
valueValue to set the variable to when this argument is set
template<typename T >
TAP::ConstArgument< T >::ConstArgument ( std::string  description,
char  flag,
T &  storage,
const T &  value 
)
inline

Create a constant argument that is identified by a flag, using an external variable to store a predefined value.

Parameters
descriptionDescription of the argument (used in help text)
flagFlag identifier of this argument
storageVariable to store the value in
valueValue to set the variable to when this argument is set
template<typename T >
TAP::ConstArgument< T >::ConstArgument ( std::string  description,
const std::string &  name,
T &  storage,
const T &  value 
)
inline

Create a constant argument that is identified by a name, using an external variable to store a predefined value.

Parameters
descriptionDescription of the argument (used in help text)
nameName identifier of this argument
storageVariable to store the value in
valueValue to set the variable to when this argument is set
template<typename T >
TAP::ConstArgument< T >::ConstArgument ( std::string  description,
char  flag,
const std::string &  name,
T &  storage,
const T &  value 
)
inline

Create a constant argument that is identified by both a flag and a name, using an external variable to store a predefined value.

Parameters
descriptionDescription of the argument (used in help text)
flagFlag identifier of this argument
nameName identifier of this argument
storageVariable to store the value in
valueValue to set the variable to when this argument is set

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