![]() |
Rosetta
2015.31
|
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 |
Public Types inherited from utility::options::Option | |
| 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... | |
Public Member Functions inherited from utility::options::ScalarOption | |
| virtual | ~ScalarOption () |
| Destructor. More... | |
Public Member Functions inherited from utility::options::Option | |
| 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... | |
Protected Member Functions inherited from utility::options::ScalarOption | |
| ScalarOption () | |
| Default constructor. More... | |
| ScalarOption (ScalarOption const &option) | |
| Copy constructor. More... | |
| ScalarOption & | operator= (ScalarOption const &) |
| Copy assignment. More... | |
Protected Member Functions inherited from utility::options::Option | |
| 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 | |
Protected Types inherited from utility::options::Option | |
| 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_10(), add_rosetta_options_11(), add_rosetta_options_12(), add_rosetta_options_13(), add_rosetta_options_14(), add_rosetta_options_15(), add_rosetta_options_2(), add_rosetta_options_3(), add_rosetta_options_4(), add_rosetta_options_5(), add_rosetta_options_6(), add_rosetta_options_7(), add_rosetta_options_8(), add_rosetta_options_9(), and main().
|
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_10(), add_rosetta_options_11(), add_rosetta_options_12(), add_rosetta_options_13(), add_rosetta_options_14(), add_rosetta_options_15(), add_rosetta_options_2(), add_rosetta_options_3(), add_rosetta_options_4(), add_rosetta_options_5(), add_rosetta_options_6(), add_rosetta_options_7(), add_rosetta_options_8(), and add_rosetta_options_9().
|
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_1(), add_rosetta_options_11(), add_rosetta_options_2(), add_rosetta_options_3(), add_rosetta_options_4(), add_rosetta_options_5(), add_rosetta_options_7(), and add_rosetta_options_8().
|
inline |
Lower bound.
|
inlinevirtual |
Number of default values (default size)
Implements utility::options::Option.
|
inlinevirtual |
Number of values (size)
Implements utility::options::Option.
|
inlinevirtual |
|
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_15(), add_rosetta_options_2(), add_rosetta_options_7(), and add_rosetta_options_8().
|
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_2().
|
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().
1.8.7