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

Finds a file relative to a default directory when it is not found as given. More...

Inheritance diagram for cli::file_on_default_path_t:
cli::validator_t

Public Member Functions

 file_on_default_path_t (std::string default_path, bool enable_error_return=true)
 Constructs the validator.
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

Finds a file relative to a default directory when it is not found as given.

On a match the value is rewritten to the resolved path.

Constructor & Destructor Documentation

◆ file_on_default_path_t()

cli::file_on_default_path_t::file_on_default_path_t ( std::string default_path,
bool enable_error_return = true )
inlineexplicit

Constructs the validator.

Parameters
default_pathThe directory to search when the value does not resolve.
enable_error_returnReport a failure when neither path resolves.

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