cli11
Loading...
Searching...
No Matches
cli::range_t Class Referenceexport
module cli11

Requires the value to fall within a closed interval. More...

Inheritance diagram for cli::range_t:
cli::validator_t

Public Member Functions

template<typename T>
 range_t (T min_val, T max_val, const std::string &validator_name=std::string {})
 Constructs a validator for the interval [min_val, max_val].
template<typename T>
 range_t (T max_val, const std::string &validator_name=std::string {})
 Constructs a validator for the interval [0, max_val].
Public Member Functions inherited from cli::validator_t
 validator_t (std::string validator_desc)
 Constructs a validator that only carries a description.
 validator_t (std::function< std::string(std::string &)> op, std::string validator_desc, std::string validator_name="")
 Constructs a named validator.
auto operation (std::function< std::string(std::string &)> op) -> validator_t &
 Replaces the check.
auto operator() (std::string &str) const -> std::string
 Runs the check, possibly rewriting str.
auto operator() (const std::string &str) const -> std::string
 Runs the check against a copy, leaving str untouched.
auto description (std::string validator_desc) -> validator_t &
 Sets the description in place.
auto description (std::string validator_desc) const -> validator_t
 Returns a copy carrying a different description.
auto get_description () const -> std::string
 Returns the description shown in help output.
auto name (std::string validator_name) -> validator_t &
 Sets the name in place.
auto name (std::string validator_name) const -> validator_t
 Returns a copy carrying a different name.
auto get_name () const -> const std::string &
 Returns the validator's name.
auto active (bool active_val=true) -> validator_t &
 Enables or disables the check in place.
auto active (bool active_val=true) const -> validator_t
 Returns a copy that is enabled or disabled.
auto get_active () const -> bool
 Reports whether the check runs.
auto non_modifying (bool no_modify=true) -> validator_t &
 Forbids or permits the check to rewrite its argument.
auto get_modifying () const -> bool
 Reports whether the check may rewrite its argument.
auto application_index (int app_index) -> validator_t &
 Sets which value the check applies to, in place.
auto application_index (int app_index) const -> validator_t
 Returns a copy applying to a different value.
auto get_application_index () const -> int
 Returns which value the check applies to.
auto operator& (const validator_t &other) const -> validator_t
 Combines two validators so that both must pass.
auto operator| (const validator_t &other) const -> validator_t
 Combines two validators so that either may pass.
auto operator! () const -> validator_t
 Inverts a validator, so that passing becomes failing.

Additional Inherited Members

Protected Member Functions inherited from cli::validator_t
 validator_t (std::string validator_desc, std::function< std::string(std::string &)> func)
 Constructs a validator with a fixed description.
Protected Attributes inherited from cli::validator_t
std::function< std::string()> desc_function_ {[] { return std::string {}; }}
 Produces the description shown in help output.
std::function< std::string(std::string &)> func_
 The check itself.
std::string name_ {}
 The validator's name, used to find and replace it on an option.
int application_index_ = -1
 Which value this applies to, or -1 for all of them.
bool active_ {true}
 Whether the check runs at all.
bool non_modifying_ {false}
 Whether the check is forbidden from rewriting its argument.

Detailed Description

Requires the value to fall within a closed interval.

Constructor & Destructor Documentation

◆ range_t() [1/2]

template<typename T>
cli::range_t::range_t ( T min_val,
T max_val,
const std::string & validator_name = std::string {} )
inline

Constructs a validator for the interval [min_val, max_val].

Template Parameters
TThe type the value is converted to before comparison.
Parameters
min_valThe lowest permitted value.
max_valThe highest permitted value.
validator_nameThe validator's name; the description is generated when this is empty.

◆ range_t() [2/2]

template<typename T>
cli::range_t::range_t ( T max_val,
const std::string & validator_name = std::string {} )
inlineexplicit

Constructs a validator for the interval [0, max_val].

Template Parameters
TThe type the value is converted to before comparison.
Parameters
max_valThe highest permitted value.
validator_nameThe validator's name.

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