![]() |
Rosetta Utilities
2014.35
|
Program scalar-valued option abstract base class. More...
#include <ScalarOption_T_.hh>
Public Types | |
typedef K | key_type |
typedef T | value_type |
typedef K | Key |
typedef T | Value |
![]() | |
typedef OptionKey | key_type |
typedef std::size_t | size_type |
typedef OptionKey | Key |
typedef std::size_t | Size |
Public Member Functions | |
virtual ScalarOption_T_ * | clone () const =0 |
Clone this. More... | |
virtual | ~ScalarOption_T_ () |
Destructor. More... | |
operator Value const & () const | |
Value conversion. More... | |
ScalarOption_T_ & | activate () |
Activate. More... | |
ScalarOption_T_ & | deactivate () |
Deactivate. More... | |
ScalarOption_T_ & | to_default () |
Set to default value, if any. More... | |
ScalarOption_T_ & | clear () |
Clear. More... | |
ScalarOption_T_ & | legal (Value const &value_a) |
Add a legal value. More... | |
ScalarOption_T_ & | shortd (std::string const &s) |
Set a short description. More... | |
ScalarOption_T_ & | lower (Value const &value_a) |
Set a lower bound. More... | |
ScalarOption_T_ & | strict_lower (Value const &value_a) |
Set a strict lower bound. More... | |
ScalarOption_T_ & | upper (Value const &value_a) |
Set an upper bound. More... | |
ScalarOption_T_ & | strict_upper (Value const &value_a) |
Set a strict upper bound. More... | |
virtual ScalarOption_T_ & | default_value (Value const &value_a) |
Default value assignment. More... | |
virtual ScalarOption_T_ & | def (Value const &value_a) |
Default value assignment. More... | |
ScalarOption_T_ & | cl_value (std::string const &value_str) |
Value assignment from a command line string. More... | |
virtual ScalarOption_T_ & | value (Value const &value_a) |
Value assignment. More... | |
virtual ScalarOption_T_ & | operator() (Value const &value_a) |
Value assignment. More... | |
ScalarOption_T_ & | default_to (ScalarOption_T_ const &option) |
Default to another option's value. More... | |
bool | legal_specs_report () const |
Legal specifications check: Report and return error state. More... | |
bool | legal_limits_report () const |
Legal value limits check: Report and return error state. More... | |
bool | legal_size_report () const |
Legal size limits check: Report and return error state. More... | |
bool | legal_default_report () const |
Legal default value check: Report and return error state. More... | |
void | legal_default_check () const |
Legal default value check. More... | |
void | legal_default_check (Value const &value_a) const |
Legal default value check. More... | |
bool | legal_report () const |
Legal value check: Report and return error state. More... | |
void | legal_check () const |
Legal value check. More... | |
void | legal_check (Value const &value_a) const |
Legal value check. More... | |
bool | specified_report () const |
Required specified option check: Report and return error state. More... | |
void | specified_check () const |
Required specified option check. More... | |
Key const & | key () const |
Key. More... | |
std::string const & | id () const |
ID. More... | |
std::string const & | identifier () const |
Identifier. More... | |
std::string const & | code () const |
Code. More... | |
std::string const & | name () const |
Name. More... | |
std::string const & | description () const |
Description. More... | |
std::string const & | short_description () const |
Short Description. More... | |
void | short_description (std::string const &sd) |
void | description (std::string const &sd) |
bool | legal_default () const |
Legal or inactive default value? More... | |
bool | legal () const |
Legal value? More... | |
bool | legal_value (Value const &value_a) const |
Is the given value legal? More... | |
bool | has_default () const |
Has a default? More... | |
bool | default_active () const |
Default active? More... | |
bool | default_inactive () const |
Default inactive? More... | |
bool | active () const |
Active? That is, the option has some value, either the default one or specified on the command line. More... | |
bool | user () const |
User-specified? That is, the option value was specified on the command line. You should probably use active() instead in almost all cases! More... | |
bool | can_hold_another () const |
Can another value be added and stay within any size constraints? More... | |
Size | default_size () const |
Default size (number of default values) More... | |
Size | n_default_value () const |
Number of default values (default size) More... | |
Size | size () const |
Size (number of values) More... | |
Size | n_value () const |
Number of values (size) More... | |
bool | has_any_of_characters (std::string const str_, std::string const s) const |
Has Any Character of a std::string? non ambiguous vesrion for Python binding. More... | |
std::string | legal_string () const |
Legal value string representation. More... | |
std::string | size_constraint_string () const |
Size constraint string representation. More... | |
std::string | default_string () const |
Default value string representation. More... | |
std::string | value_string () const |
Value string representation. More... | |
std::string | equals_string () const |
=Value string representation More... | |
LegalBound const & | lower () const |
Lower bound. More... | |
LegalBound const & | upper () |
Upper bound. More... | |
Value const & | default_value () const |
Default value. More... | |
Value const & | value () const |
Value. More... | |
Value const & | operator() () const |
Value. More... | |
Value | value_or (Value const &value_a) const |
Value or passed default if inactive. More... | |
Value | user_or (Value const &value_a) const |
Value or passed default if not user-specified. More... | |
![]() | |
virtual | ~ScalarOption () |
Destructor. More... | |
![]() | |
virtual | ~Option () |
Destructor. More... | |
Option & | is_group (bool value) |
bool | is_group () const |
Is this the synonymous option for an option group (e.g. -in:file:file) More... | |
virtual bool | is_value (std::string const &value_str) const =0 |
Is a string readable as this option's value type? More... | |
virtual bool | is_cl_value (std::string const &value_str) const =0 |
Is a string readable as this option's value type and a legal command line value? More... | |
virtual std::string | type_string () const =0 |
Option type code string representation. More... | |
void | been_accessed () const |
Set access property to true. More... | |
void | set_accessed (bool setting) const |
bool | is_been_accessed () const |
Return true if option value was anyhow accessed. More... | |
Option & | restrict_access (bool setting) |
Restrict direct access to option for general use. More... | |
void | check_restricted_access (bool do_check) const |
Protected Member Functions | |
ScalarOption_T_ () | |
Default constructor. More... | |
ScalarOption_T_ (ScalarOption_T_ const &option) | |
Copy constructor. More... | |
ScalarOption_T_ (Key const &key_a, std::string const &description_a) | |
Key + description constructor. More... | |
ScalarOption_T_ & | operator= (ScalarOption_T_ const &option) |
Copy assignment. More... | |
virtual Value | value_of (std::string const &value_str) const =0 |
Value of a string. More... | |
virtual std::string | value_string_of (Value const &v) const |
String representation of a given value. More... | |
void | default_inactive_error () const |
Error handler for using inactive option value. More... | |
void | inactive_error () const |
Error handler for using inactive option value. More... | |
virtual void | stream_setup (std::ostream &) const |
Setup stream state for the Option value type. More... | |
bool | unconstrained () const |
Value is unconstrained? More... | |
bool | default_is_legal () const |
Default value is a specified legal value? More... | |
bool | value_is_legal () const |
Value is a specified legal value? More... | |
bool | value_is_legal (Value const &value_a) const |
Value is legal? More... | |
bool | default_obeys_bounds () const |
Default value obeys specified bounds? More... | |
bool | value_obeys_bounds () const |
Value obeys specified bounds? More... | |
bool | value_obeys_bounds (Value const &value_a) const |
Given value obeys specified bounds? More... | |
![]() | |
ScalarOption () | |
Default constructor. More... | |
ScalarOption (ScalarOption const &option) | |
Copy constructor. More... | |
ScalarOption & | operator= (ScalarOption const &) |
Copy assignment. More... | |
![]() | |
Option () | |
Default constructor. More... | |
Option (Option const &option) | |
Copy constructor. More... | |
Option & | operator= (Option const &option) |
Copy assignment. More... | |
Private Types | |
typedef ScalarOption | Super |
typedef std::set< T > | LegalValues |
typedef Bound< T > | LegalBound |
Private Attributes | |
Key | key_ |
Key. More... | |
std::string | description_ |
Description. More... | |
std::string | short_description_ |
Short Description. More... | |
LegalValues | legal_ |
Legal values. More... | |
LegalBound | lower_ |
Bound values. More... | |
LegalBound | upper_ |
State | default_state_ |
Default state. More... | |
Value | default_value_ |
Value. More... | |
State | state_ |
State. More... | |
Value | value_ |
Value. More... | |
Additional Inherited Members | |
![]() | |
enum | State { INACTIVE, DEFAULT, USER } |
Option state enumeration. More... | |
Program scalar-valued option abstract base class.
typedef K utility::options::ScalarOption_T_< K, T >::Key |
typedef K utility::options::ScalarOption_T_< K, T >::key_type |
|
private |
|
private |
|
private |
typedef T utility::options::ScalarOption_T_< K, T >::Value |
typedef T utility::options::ScalarOption_T_< K, T >::value_type |
|
inlineprotected |
Default constructor.
|
inlineprotected |
Copy constructor.
|
inlineprotected |
Key + description constructor.
|
inlinevirtual |
Destructor.
|
inlinevirtual |
Activate.
Implements utility::options::ScalarOption.
|
inlinevirtual |
Active? That is, the option has some value, either the default one or specified on the command line.
Implements utility::options::Option.
Referenced by utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::legal().
|
inlinevirtual |
Can another value be added and stay within any size constraints?
Implements utility::options::Option.
|
inlinevirtual |
Value assignment from a command line string.
Implements utility::options::ScalarOption.
Referenced by utility::options::OptionCollection::set_option_value_file().
|
inlinevirtual |
Clear.
Implements utility::options::ScalarOption.
|
pure virtual |
|
inlinevirtual |
Code.
Implements utility::options::Option.
|
inlinevirtual |
Deactivate.
Implements utility::options::ScalarOption.
|
inlinevirtual |
Default value assignment.
Referenced by utility::options::OptionCollection::add_built_in_options(), add_rosetta_options_0(), add_rosetta_options_1(), add_rosetta_options_2(), and add_rosetta_options_3().
|
inlinevirtual |
Default active?
Implements utility::options::Option.
|
inlinevirtual |
Default inactive?
Implements utility::options::Option.
Referenced by utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::legal_default().
|
inlineprotected |
Error handler for using inactive option value.
|
inlineprotected |
Default value is a specified legal value?
Referenced by utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::legal_default().
|
inlineprotected |
Default value obeys specified bounds?
Referenced by utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::legal_default().
|
inlinevirtual |
Default size (number of default values)
Implements utility::options::Option.
|
inlinevirtual |
Default value string representation.
Implements utility::options::Option.
Referenced by utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::legal_default_check(), and utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::legal_default_report().
|
inline |
Default to another option's value.
|
inlinevirtual |
Default value assignment.
|
inline |
Default value.
Referenced by utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::default_to().
|
inlinevirtual |
Description.
Implements utility::options::Option.
|
inline |
|
inlinevirtual |
=Value string representation
Implements utility::options::Option.
|
inline |
Has Any Character of a std::string? non ambiguous vesrion for Python binding.
Referenced by utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::legal_string().
|
inlinevirtual |
Has a default?
Implements utility::options::Option.
|
inlinevirtual |
ID.
Implements utility::options::Option.
Referenced by utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::legal_default_check(), utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::legal_default_report(), utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::legal_limits_report(), and utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::specified_check().
|
inlinevirtual |
Identifier.
Implements utility::options::Option.
|
inlineprotected |
Error handler for using inactive option value.
Referenced by utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::operator Value const &().
|
inlinevirtual |
|
inline |
Add a legal value.
Referenced by utility::options::OptionCollection::add_built_in_options(), add_rosetta_options_0(), add_rosetta_options_1(), add_rosetta_options_2(), and add_rosetta_options_3().
|
inlinevirtual |
Legal value?
Implements utility::options::Option.
Referenced by utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::legal_check(), and utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::legal_report().
|
inlinevirtual |
Legal value check.
Implements utility::options::Option.
Referenced by utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::operator()(), and utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::value().
|
inline |
Legal value check.
|
inlinevirtual |
Legal or inactive default value?
Implements utility::options::Option.
Referenced by utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::legal_default_check(), and utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::legal_default_report().
|
inlinevirtual |
Legal default value check.
Implements utility::options::Option.
Referenced by utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::def(), and utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::default_value().
|
inline |
Legal default value check.
|
inlinevirtual |
Legal default value check: Report and return error state.
Implements utility::options::Option.
Referenced by utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::legal_specs_report().
|
inlinevirtual |
Legal value limits check: Report and return error state.
Implements utility::options::Option.
Referenced by utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::legal_specs_report().
|
inlinevirtual |
Legal value check: Report and return error state.
Implements utility::options::Option.
|
inlinevirtual |
Legal size limits check: Report and return error state.
Implements utility::options::Option.
|
inlinevirtual |
Legal specifications check: Report and return error state.
Implements utility::options::Option.
|
inlinevirtual |
Legal value string representation.
Implements utility::options::Option.
Referenced by utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::legal_limits_report().
|
inline |
|
inline |
Set a lower bound.
Referenced by add_rosetta_options_0(), add_rosetta_options_1(), and add_rosetta_options_2().
|
inline |
Lower bound.
|
inlinevirtual |
Number of default values (default size)
Implements utility::options::Option.
|
inlinevirtual |
Number of values (size)
Implements utility::options::Option.
|
inlinevirtual |
Name.
Implements utility::options::Option.
|
inline |
Value conversion.
|
inlinevirtual |
Value assignment.
|
inline |
Value.
|
inlineprotected |
Copy assignment.
|
inlinevirtual |
Short Description.
Implements utility::options::Option.
|
inline |
|
inline |
Set a short description.
Referenced by add_rosetta_options_0(), add_rosetta_options_1(), add_rosetta_options_2(), and add_rosetta_options_3().
|
inlinevirtual |
Size (number of values)
Implements utility::options::Option.
|
inlinevirtual |
Size constraint string representation.
Implements utility::options::Option.
|
inlinevirtual |
Required specified option check.
Implements utility::options::Option.
|
inlinevirtual |
Required specified option check: Report and return error state.
Implements utility::options::Option.
|
inlineprotectedvirtual |
Setup stream state for the Option value type.
Reimplemented in utility::options::RealOption.
Referenced by utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::legal_string().
|
inline |
Set a strict lower bound.
|
inline |
Set a strict upper bound.
|
inlinevirtual |
Set to default value, if any.
Implements utility::options::ScalarOption.
|
inlineprotected |
|
inline |
Set an upper bound.
Referenced by add_rosetta_options_0(), and add_rosetta_options_1().
|
inline |
Upper bound.
|
inlinevirtual |
User-specified? That is, the option value was specified on the command line. You should probably use active() instead in almost all cases!
Implements utility::options::Option.
Referenced by utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::specified_check(), and utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::specified_report().
|
inline |
Value or passed default if not user-specified.
|
inlinevirtual |
Value assignment.
|
inline |
Value.
Referenced by utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::cl_value().
|
inlineprotected |
Value is a specified legal value?
Referenced by utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::legal(), and utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::legal_value().
|
inlineprotected |
Value is legal?
|
inlineprotected |
Value obeys specified bounds?
Referenced by utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::legal(), and utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::legal_value().
|
inlineprotected |
Given value obeys specified bounds?
|
protectedpure virtual |
Value of a string.
Implemented in utility::options::FileOption, utility::options::PathOption, utility::options::BooleanOption, utility::options::StringOption, utility::options::RealOption, and utility::options::IntegerOption.
Referenced by utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::cl_value().
|
inline |
Value or passed default if inactive.
|
inlinevirtual |
Value string representation.
Implements utility::options::Option.
Referenced by utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::legal_check(), and utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::legal_report().
|
inlineprotectedvirtual |
String representation of a given value.
Referenced by utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::legal_default_check(), and utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::legal_string().
|
private |
Default state.
Referenced by utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::clear(), utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::def(), utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::default_active(), utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::default_inactive(), utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::default_size(), utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::default_value(), utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::has_default(), utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::n_default_value(), utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::operator=(), and utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::to_default().
|
private |
Value.
Referenced by utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::clear(), utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::def(), utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::default_value(), utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::operator=(), and utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::to_default().
|
private |
|
private |
Key.
Referenced by utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::code(), utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::id(), utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::identifier(), utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::key(), utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::name(), and utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::operator=().
|
private |
|
private |
Bound values.
Referenced by utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::legal_limits_report(), utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::legal_string(), utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::lower(), utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::operator=(), and utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::strict_lower().
|
private |
|
private |
State.
Referenced by utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::activate(), utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::active(), utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::cl_value(), utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::clear(), utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::deactivate(), utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::def(), utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::default_to(), utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::default_value(), utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::n_value(), utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::operator Value const &(), utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::operator()(), utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::operator=(), utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::size(), utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::to_default(), utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::user(), and utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::value().
|
private |
Referenced by utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::legal_limits_report(), utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::legal_string(), utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::operator=(), utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::strict_upper(), and utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::upper().
|
private |
Value.
Referenced by utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::cl_value(), utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::clear(), utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::def(), utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::default_value(), utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::operator Value const &(), utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::operator()(), utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::operator=(), utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::to_default(), and utility::options::ScalarOption_T_< PathOptionKey, file::PathName >::value().