SeqAn3  3.0.3
The Modern C++ library for sequence analysis.
seqan3::value_list_validator< option_value_t > Class Template Reference

A validator that checks whether a value is inside a list of valid values. More...

#include <seqan3/argument_parser/validators.hpp>

+ Inheritance diagram for seqan3::value_list_validator< option_value_t >:

Public Types

using option_value_type = option_value_t
 Type of values that are tested by validator.
 

Public Member Functions

std::string get_help_page_message () const
 Returns a message that can be appended to the (positional) options help page info.
 
void operator() (option_value_type const &cmp) const
 Tests whether cmp lies inside values. More...
 
template<std::ranges::forward_range range_type>
void operator() (range_type const &range) const
 Tests whether every element in range lies inside values. More...
 
Constructors, destructor and assignment
 value_list_validator ()=default
 Defaulted.
 
 value_list_validator (value_list_validator const &)=default
 Defaulted.
 
 value_list_validator (value_list_validator &&)=default
 Defaulted.
 
value_list_validatoroperator= (value_list_validator const &)=default
 Defaulted.
 
value_list_validatoroperator= (value_list_validator &&)=default
 Defaulted.
 
 ~value_list_validator ()=default
 Defaulted.
 
template<std::ranges::forward_range range_type>
 value_list_validator (range_type rng)
 Constructing from a range. More...
 
template<typename ... option_types>
 value_list_validator (option_types &&...opts)
 Constructing from a parameter pack. More...
 

Related Functions

(Note that these are not member functions.)

template<typename option_type , typename ... option_types>
 value_list_validator (option_type, option_types...) -> value_list_validator< std::string >
 Type deduction guides. More...
 
template<typename range_type >
 value_list_validator (range_type &&rng) -> value_list_validator< std::string >
 Deduction guide for ranges over a value type convertible to std::string.
 
template<typename option_type , typename ... option_types>
 value_list_validator (option_type, option_types ...) -> value_list_validator< option_type >
 Deduction guide for a parameter pack.
 
template<typename range_type >
 value_list_validator (range_type &&rng) -> value_list_validator< std::ranges::range_value_t< range_type >>
 Deduction guide for ranges.
 

Detailed Description

template<typename option_value_t>
class seqan3::value_list_validator< option_value_t >

A validator that checks whether a value is inside a list of valid values.

Template Parameters
option_value_tType of values that are tested by validator.

On construction, the validator must receive a range or parameter pack of valid values. The class than acts as a functor, that throws a seqan3::validation_error exception whenever a given value is not in the given list.

Note
In order to simplify the chaining of validators, the option value type is deduced to std::string if the range's value type is convertible to it. Otherwise, the option value type is deduced to the value type of the range.
int main(int argc, const char ** argv)
{
seqan3::argument_parser myparser{"Test", argc, argv}; // initialize
int myint;
seqan3::value_list_validator my_validator{2, 4, 6, 8, 10};
myparser.add_option(myint,'i',"integer","Give me a number.",
// an exception will be thrown if the user specifies an integer
// that is not one of [2,4,6,8,10] (e.g. "./test_app -i 3")
try
{
myparser.parse();
}
catch (seqan3::argument_parser_error const & ext) // the user did something wrong
{
std::cerr << "[PARSER ERROR] " << ext.what() << "\n"; // customize your error message
return -1;
}
seqan3::debug_stream << "integer given by user passed validation: " << myint << "\n";
return 0;
}
Meta-Header for the argument parser module.
Argument parser exception that is thrown whenever there is an error while parsing the command line ar...
Definition: exceptions.hpp:49
The SeqAn command line parser.
Definition: argument_parser.hpp:154
A validator that checks whether a value is inside a list of valid values.
Definition: validators.hpp:192
Provides seqan3::debug_stream and related types.
@ standard
The default were no checking or special displaying is happening.
Definition: auxiliary.hpp:239
debug_stream_type debug_stream
A global instance of seqan3::debug_stream_type.
Definition: debug_stream.hpp:42
T what(T... args)

Constructor & Destructor Documentation

◆ value_list_validator() [1/2]

template<typename option_value_t >
template<std::ranges::forward_range range_type>
seqan3::value_list_validator< option_value_t >::value_list_validator ( range_type  rng)
inline

Constructing from a range.

Template Parameters
range_typeThe type of range; must model std::ranges::forward_range and value_list_validator::option_value_type must be constructible from the rvalue reference type of the given range.
Parameters
[in]rngThe range of valid values to test.

◆ value_list_validator() [2/2]

template<typename option_value_t >
template<typename ... option_types>
seqan3::value_list_validator< option_value_t >::value_list_validator ( option_types &&...  opts)
inline

Constructing from a parameter pack.

Template Parameters
option_typesThe type of option values in the parameter pack; The value_list_validator::option_value_type must be constructible from each type in the parameter pack.
Parameters
[in]optsThe parameter pack values.

Member Function Documentation

◆ operator()() [1/2]

template<typename option_value_t >
void seqan3::value_list_validator< option_value_t >::operator() ( option_value_type const &  cmp) const
inline

Tests whether cmp lies inside values.

Parameters
cmpThe input value to check.
Exceptions
seqan3::validation_error

◆ operator()() [2/2]

template<typename option_value_t >
template<std::ranges::forward_range range_type>
void seqan3::value_list_validator< option_value_t >::operator() ( range_type const &  range) const
inline

Tests whether every element in range lies inside values.

Template Parameters
range_typeThe type of range to check; must model std::ranges::forward_range.
Parameters
rangeThe input range to iterate over and check every element.
Exceptions
seqan3::validation_error

Friends And Related Function Documentation

◆ value_list_validator()

template<typename option_type , typename ... option_types>
value_list_validator ( option_type  ,
option_types...   
) -> value_list_validator< std::string >
related

Type deduction guides.

Given a parameter pack of types that are convertible to std::string, delegate to value type std::string.


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