Concrete implementation of TypedArgument. More...

#include <TypedArgument.hpp>

Inheritance diagram for TAP::VariableArgument< T, multi >:

Public Member Functions
	VariableArgument (std::string description, ST *storage)
	Create a VariableArgument with given description and storage pointer. More...

	VariableArgument (std::string description, char flag, ST *storage)
	Create a VariableArgument with given description and storage pointer, aliased to the given flag. More...

	VariableArgument (std::string description, const std::string &name, ST *storage)
	Create a VariableArgument with given description and storage pointer, aliased to the given name. More...

	VariableArgument (std::string description, char flag, const std::string &name, ST *storage)
	Create a VariableArgument with given description and storage pointer, aliased to the given flag and name. More...

	VariableArgument (std::string description, ST &storage)
	Create a VariableArgument with given description and storage reference. More...

	VariableArgument (std::string description, char flag, ST &storage)
	Create a VariableArgument with given description and storage reference, aliased to the given flag. More...

	VariableArgument (std::string description, const std::string &name, ST &storage)
	Create a VariableArgument with given description and storage reference, aliased to the given name. More...

	VariableArgument (std::string description, char flag, const std::string &name, ST &storage)
	Create a VariableArgument with given description and storage reference, aliased to the given flag and name. More...

virtual	~VariableArgument ()=default
	VariableArgument destructor.

	VariableArgument (const VariableArgument &)=default
	VariableArgument copy constructor.

	VariableArgument (VariableArgument &&)=default
	VariableArgument move constructor.

VariableArgument &	operator= (const VariableArgument &)=default
	VariableArgument copy assignment operator.

VariableArgument &	operator= (VariableArgument &&)=default
	VariableArgument move assignment operator.

std::unique_ptr< BaseArgument >	clone () const &override
	See BaseArgument::clone().

std::unique_ptr< BaseArgument >	clone ()&&override
	See BaseArgument::clone().

VariableArgument &	valuename (const std::string &valueName)
	Assign a human readable description for the value, used when describing the argument. More...

const std::string &	valuename ()
	Return a human readable description for the value, used when describing the argument. More...

bool	takes_value () const override
	See Argument::takes_value()

void	set () const override
	Calling this function is an error, call set(std::string) instead.

void	set (const std::string &value) const override
	See ValueAcceptor::set()

std::string	usage () const override
	See Argument::usage()

std::string	ident () const override
	See Argument::ident()

Public Member Functions inherited from TAP::TypedArgument< T, multi >
const ST &	value () const
	Returns the value of this argument. More...

virtual TypedArgument &	check (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.

Argument &	operator= (const Argument &other)=default
	Argument assignment operator.

Argument &	operator= (Argument &&other)=default
	Argument move assignment operator.

Argument &	alias (char flag)
	An a flag alias for the argument. More...

Argument &	alias (std::string name)
	An a name alias for the argument. More...

Argument &	alias (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 Argument &	check (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()

Argument &	many (bool many=true)
	Allow the argument to occur multiple times or not. More...

Argument &	min (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...

Argument &	max (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()

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.

BaseArgument &	operator= (const BaseArgument &)=default
	BaseArgument assignment operator.

BaseArgument &	operator= (BaseArgument &&)=default
	BaseArgument move assignment operator.

	operator bool () const
	Boolean conversion operator (so you can do things like if (arg) { ... More...

BaseArgument &	set_required (bool required=true)
	Mark the argument as required or not. More...

bool	required () const
	Returns whether the argument is required. More...

Protected Types
using	ST = typename TypedArgument< T, multi >::ST
	Make TypedArgument::ST accessible. More...

Protected Types inherited from TAP::TypedArgument< T, multi >
using	ST = typename std::conditional< !multi, T, std::vector< T > >::type
	Alias for the storage type (which is a vector for MultiValueArgument types)

Protected Attributes
std::string	m_valueName = std::string("value")
	Name of the accepted value, used in the identifier.

Protected Attributes inherited from TAP::TypedArgument< T, multi >
ST *	m_storage
	Pointer to value storage.

TypedArgumentCheckFunc< T, multi >	m_typedCheckFunc = nullptr
	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 Member Functions inherited from TAP::TypedArgument< T, multi >
	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...

template<bool m = multi>
std::enable_if<!m >::type	check () const override
	See Argument::check()

template<bool m = multi>
std::enable_if< m >::type	check () const override
	See Argument::check()

Detailed Description

template<typename T, bool multi = false>
class TAP::VariableArgument< T, multi >

Concrete implementation of TypedArgument.

Simply takes a value and stores it in a variable.

Member Typedef Documentation

template<typename T, bool multi = false>

using TAP::VariableArgument< T, multi >::ST = typename TypedArgument<T, multi>::ST

protected

Make TypedArgument::ST accessible.

Constructor & Destructor Documentation

template<typename T, bool multi = false>

TAP::VariableArgument< T, multi >::VariableArgument	(	std::string	description,
		ST *	storage
	)

inline

Create a VariableArgument with given description and storage pointer.

Values will be stored in the variable pointed to.

Parameters

description	Description of the argument (used in help text)
storage	Pointer to storage variable

template<typename T, bool multi = false>

TAP::VariableArgument< T, multi >::VariableArgument	(	std::string	description,
		char	flag,
		ST *	storage
	)

inline

Create a VariableArgument with given description and storage pointer, aliased to the given flag.

Values will be stored in the variable pointed to.

Parameters

description	Description of the argument (used in help text)
flag	Flag identifier of this argument
storage	Pointer to storage variable

template<typename T, bool multi = false>

TAP::VariableArgument< T, multi >::VariableArgument	(	std::string	description,
		const std::string &	name,
		ST *	storage
	)

inline

Create a VariableArgument with given description and storage pointer, aliased to the given name.

Values will be stored in the variable pointed to.

Parameters

description	Description of the argument (used in help text)
name	Name identifier of this argument
storage	Pointer to storage variable

template<typename T, bool multi = false>

TAP::VariableArgument< T, multi >::VariableArgument	(	std::string	description,
		char	flag,
		const std::string &	name,
		ST *	storage
	)

inline

Create a VariableArgument with given description and storage pointer, aliased to the given flag and name.

Values will be stored in the variable pointed to.

Parameters

description	Description of the argument (used in help text)
flag	Flag identifier of this argument
name	Name identifier of this argument
storage	Pointer to storage variable

template<typename T, bool multi = false>

TAP::VariableArgument< T, multi >::VariableArgument	(	std::string	description,
		ST &	storage
	)

inline

Create a VariableArgument with given description and storage reference.

Values will be stored in the variable referenced.

Parameters

description	Description of the argument (used in help text)
storage	Pointer to storage variable

template<typename T, bool multi = false>

TAP::VariableArgument< T, multi >::VariableArgument	(	std::string	description,
		char	flag,
		ST &	storage
	)

inline

Create a VariableArgument with given description and storage reference, aliased to the given flag.

Values will be stored in the variable referenced.

Parameters

description	Description of the argument (used in help text)
flag	Flag identifier of this argument
storage	Pointer to storage variable

template<typename T, bool multi = false>

TAP::VariableArgument< T, multi >::VariableArgument	(	std::string	description,
		const std::string &	name,
		ST &	storage
	)

inline

Create a VariableArgument with given description and storage reference, aliased to the given name.

Values will be stored in the variable referenced.

Parameters

description	Description of the argument (used in help text)
name	Name identifier of this argument
storage	Pointer to storage variable

template<typename T, bool multi = false>

TAP::VariableArgument< T, multi >::VariableArgument	(	std::string	description,
		char	flag,
		const std::string &	name,
		ST &	storage
	)

inline

Create a VariableArgument with given description and storage reference, aliased to the given flag and name.

Values will be stored in the variable referenced.

Parameters

description	Description of the argument (used in help text)
flag	Flag identifier of this argument
name	Name identifier of this argument
storage	Pointer to storage variable

Member Function Documentation

template<typename T, bool multi = false>

VariableArgument& TAP::VariableArgument< T, multi >::valuename ( const std::string & valueName )

inline

Assign a human readable description for the value, used when describing the argument.

Default is 'value'.

Parameters

valueName String to describe the name of the value.

Returns: Reference to this argument

template<typename T, bool multi = false>

const std::string& TAP::VariableArgument< T, multi >::valuename ( )

inline

Return a human readable description for the value, used when describing the argument.

Default is 'value'.

Returns: String representing the value argument in help text

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

include/tap/TypedArgument.hpp

Public Member Functions

Protected Types

Protected Attributes

Additional Inherited Members

Detailed Description

template<typename T, bool multi = false> class TAP::VariableArgument< T, multi >

Member Typedef Documentation

Constructor & Destructor Documentation

Member Function Documentation

template<typename T, bool multi = false>
class TAP::VariableArgument< T, multi >