Ipopt  trunk
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Defines
Classes | Public Member Functions | Private Member Functions | Private Attributes
Ipopt::RegisteredOption Class Reference

Base class for registered options. More...

#include <IpRegOptions.hpp>

+ Inheritance diagram for Ipopt::RegisteredOption:

List of all members.

Classes

class  string_entry
 class to hold the valid string settings for a string option More...

Public Member Functions

 DECLARE_STD_EXCEPTION (ERROR_CONVERTING_STRING_TO_ENUM)
virtual void OutputDescription (const Journalist &jnlst) const
 output a description of the option
virtual void OutputShortDescription (const Journalist &jnlst) const
 output a more concise version
virtual void OutputLatexDescription (const Journalist &jnlst) const
 output a latex version
 RegisteredOption (Index counter)
 Constructors / Destructors.
 RegisteredOption (const std::string &name, const std::string &short_description, const std::string &long_description, const std::string &registering_category, Index counter)
 RegisteredOption (const RegisteredOption &copy)
virtual ~RegisteredOption ()
virtual const std::string & Name () const
 Standard Get / Set Methods.
virtual void SetName (const std::string &name)
 Set the option's name (tag in the input file)
virtual const std::string & ShortDescription () const
 Get the short description.
virtual const std::string & LongDescription () const
 Get the long description.
virtual void SetShortDescription (const std::string &short_description)
 Set the short description.
virtual void SetLongDescription (const std::string &long_description)
 Set the long description.
virtual const std::string & RegisteringCategory () const
 Get the registering class.
virtual void SetRegisteringCategory (const std::string &registering_category)
 Set the registering class.
virtual const
RegisteredOptionType
Type () const
 Get the Option's type.
virtual void SetType (const RegisteredOptionType &type)
 Get the Option's type.
virtual Index Counter () const
 Counter.
Get / Set methods valid for specific types - NOTE: the Type

must be set before calling these methods.

virtual const bool & HasLower () const
 check if the option has a lower bound - can be called for OT_Number & OT_Integer
virtual const bool & LowerStrict () const
 check if the lower bound is strict - can be called for OT_Number
virtual Number LowerNumber () const
 get the Number version of the lower bound - can be called for OT_Number
virtual void SetLowerNumber (const Number &lower, const bool &strict)
 set the Number version of the lower bound - can be called for OT_Number
virtual Index LowerInteger () const
 get the Integer version of the lower bound can be called for OT_Integer
virtual void SetLowerInteger (const Index &lower)
 set the Integer version of the lower bound - can be called for OT_Integer
virtual const bool & HasUpper () const
 check if the option has an upper bound - can be called for OT_Number & OT_Integer
virtual const bool & UpperStrict () const
 check if the upper bound is strict - can be called for OT_Number
virtual Number UpperNumber () const
 get the Number version of the upper bound - can be called for OT_Number
virtual void SetUpperNumber (const Number &upper, const bool &strict)
 set the Number version of the upper bound - can be called for OT_Number
virtual Index UpperInteger () const
 get the Integer version of the upper bound - can be called for OT_Integer
virtual void SetUpperInteger (const Index &upper)
 set the Integer version of the upper bound - can be called for OT_Integer
virtual void AddValidStringSetting (const std::string value, const std::string description)
 method to add valid string entries - can be called for OT_String
virtual Number DefaultNumber () const
 get the default as a Number - can be called for OT_Number
virtual void SetDefaultNumber (const Number &default_value)
 Set the default as a Number - can be called for OT_Number.
virtual Index DefaultInteger () const
 get the default as an Integer - can be called for OT_Integer
virtual void SetDefaultInteger (const Index &default_value)
 Set the default as an Integer - can be called for OT_Integer.
virtual std::string DefaultString () const
 get the default as a string - can be called for OT_String
virtual Index DefaultStringAsEnum () const
 get the default as a string, but as the index of the string in the list - helps map from a string to an enum- can be called for OT_String
virtual void SetDefaultString (const std::string &default_value)
 Set the default as a string - can be called for OT_String.
virtual std::vector< string_entryGetValidStrings () const
 get the valid string settings - can be called for OT_String
virtual bool IsValidNumberSetting (const Number &value) const
 Check if the Number value is a valid setting - can be called for OT_Number.
virtual bool IsValidIntegerSetting (const Index &value) const
 Check if the Integer value is a valid setting - can be called for OT_Integer.
virtual bool IsValidStringSetting (const std::string &value) const
 Check if the String value is a valid setting - can be called for OT_String.
virtual std::string MapStringSetting (const std::string &value) const
 Map a user setting (allowing any case) to the case used when the setting was registered.
virtual Index MapStringSettingToEnum (const std::string &value) const
 Map a user setting (allowing any case) to the index of the matched setting in the list of string settings.

Private Member Functions

void MakeValidLatexString (std::string source, std::string &dest) const
std::string MakeValidLatexNumber (Number value) const
bool string_equal_insensitive (const std::string &s1, const std::string &s2) const
 Compare two strings and return true if they are equal (case insensitive comparison)

Private Attributes

std::string name_
std::string short_description_
std::string long_description_
std::string registering_category_
RegisteredOptionType type_
bool has_lower_
bool lower_strict_
Number lower_
bool has_upper_
bool upper_strict_
Number upper_
Number default_number_
std::vector< string_entryvalid_strings_
std::string default_string_
const Index counter_
 Has the information as how many-th option this one was registered.

Detailed Description

Base class for registered options.

The derived types are more specific to a string option or a Number (real) option, etc.

Definition at line 33 of file IpRegOptions.hpp.


Constructor & Destructor Documentation

Constructors / Destructors.

Definition at line 49 of file IpRegOptions.hpp.

Ipopt::RegisteredOption::RegisteredOption ( const std::string &  name,
const std::string &  short_description,
const std::string &  long_description,
const std::string &  registering_category,
Index  counter 
) [inline]

Definition at line 57 of file IpRegOptions.hpp.

Definition at line 73 of file IpRegOptions.hpp.

virtual Ipopt::RegisteredOption::~RegisteredOption ( ) [inline, virtual]

Definition at line 88 of file IpRegOptions.hpp.


Member Function Documentation

Ipopt::RegisteredOption::DECLARE_STD_EXCEPTION ( ERROR_CONVERTING_STRING_TO_ENUM  )
virtual const std::string& Ipopt::RegisteredOption::Name ( ) const [inline, virtual]

Standard Get / Set Methods.

Get the option's name (tag in the input file)

Definition at line 97 of file IpRegOptions.hpp.

virtual void Ipopt::RegisteredOption::SetName ( const std::string &  name) [inline, virtual]

Set the option's name (tag in the input file)

Definition at line 102 of file IpRegOptions.hpp.

virtual const std::string& Ipopt::RegisteredOption::ShortDescription ( ) const [inline, virtual]

Get the short description.

Definition at line 107 of file IpRegOptions.hpp.

virtual const std::string& Ipopt::RegisteredOption::LongDescription ( ) const [inline, virtual]

Get the long description.

Definition at line 112 of file IpRegOptions.hpp.

virtual void Ipopt::RegisteredOption::SetShortDescription ( const std::string &  short_description) [inline, virtual]

Set the short description.

Definition at line 117 of file IpRegOptions.hpp.

virtual void Ipopt::RegisteredOption::SetLongDescription ( const std::string &  long_description) [inline, virtual]

Set the long description.

Definition at line 122 of file IpRegOptions.hpp.

virtual const std::string& Ipopt::RegisteredOption::RegisteringCategory ( ) const [inline, virtual]

Get the registering class.

Definition at line 127 of file IpRegOptions.hpp.

virtual void Ipopt::RegisteredOption::SetRegisteringCategory ( const std::string &  registering_category) [inline, virtual]

Set the registering class.

Definition at line 132 of file IpRegOptions.hpp.

virtual const RegisteredOptionType& Ipopt::RegisteredOption::Type ( ) const [inline, virtual]

Get the Option's type.

Definition at line 137 of file IpRegOptions.hpp.

virtual void Ipopt::RegisteredOption::SetType ( const RegisteredOptionType type) [inline, virtual]

Get the Option's type.

Definition at line 142 of file IpRegOptions.hpp.

virtual Index Ipopt::RegisteredOption::Counter ( ) const [inline, virtual]

Counter.

Definition at line 147 of file IpRegOptions.hpp.

virtual const bool& Ipopt::RegisteredOption::HasLower ( ) const [inline, virtual]

check if the option has a lower bound - can be called for OT_Number & OT_Integer

Definition at line 159 of file IpRegOptions.hpp.

virtual const bool& Ipopt::RegisteredOption::LowerStrict ( ) const [inline, virtual]

check if the lower bound is strict - can be called for OT_Number

Definition at line 166 of file IpRegOptions.hpp.

virtual Number Ipopt::RegisteredOption::LowerNumber ( ) const [inline, virtual]

get the Number version of the lower bound - can be called for OT_Number

Definition at line 173 of file IpRegOptions.hpp.

virtual void Ipopt::RegisteredOption::SetLowerNumber ( const Number lower,
const bool &  strict 
) [inline, virtual]

set the Number version of the lower bound - can be called for OT_Number

Definition at line 180 of file IpRegOptions.hpp.

virtual Index Ipopt::RegisteredOption::LowerInteger ( ) const [inline, virtual]

get the Integer version of the lower bound can be called for OT_Integer

Definition at line 188 of file IpRegOptions.hpp.

virtual void Ipopt::RegisteredOption::SetLowerInteger ( const Index lower) [inline, virtual]

set the Integer version of the lower bound - can be called for OT_Integer

Definition at line 195 of file IpRegOptions.hpp.

virtual const bool& Ipopt::RegisteredOption::HasUpper ( ) const [inline, virtual]

check if the option has an upper bound - can be called for OT_Number & OT_Integer

Definition at line 203 of file IpRegOptions.hpp.

virtual const bool& Ipopt::RegisteredOption::UpperStrict ( ) const [inline, virtual]

check if the upper bound is strict - can be called for OT_Number

Definition at line 210 of file IpRegOptions.hpp.

virtual Number Ipopt::RegisteredOption::UpperNumber ( ) const [inline, virtual]

get the Number version of the upper bound - can be called for OT_Number

Definition at line 217 of file IpRegOptions.hpp.

virtual void Ipopt::RegisteredOption::SetUpperNumber ( const Number upper,
const bool &  strict 
) [inline, virtual]

set the Number version of the upper bound - can be called for OT_Number

Definition at line 224 of file IpRegOptions.hpp.

virtual Index Ipopt::RegisteredOption::UpperInteger ( ) const [inline, virtual]

get the Integer version of the upper bound - can be called for OT_Integer

Definition at line 233 of file IpRegOptions.hpp.

virtual void Ipopt::RegisteredOption::SetUpperInteger ( const Index upper) [inline, virtual]

set the Integer version of the upper bound - can be called for OT_Integer

Definition at line 240 of file IpRegOptions.hpp.

virtual void Ipopt::RegisteredOption::AddValidStringSetting ( const std::string  value,
const std::string  description 
) [inline, virtual]

method to add valid string entries - can be called for OT_String

Definition at line 248 of file IpRegOptions.hpp.

virtual Number Ipopt::RegisteredOption::DefaultNumber ( ) const [inline, virtual]

get the default as a Number - can be called for OT_Number

Definition at line 255 of file IpRegOptions.hpp.

virtual void Ipopt::RegisteredOption::SetDefaultNumber ( const Number default_value) [inline, virtual]

Set the default as a Number - can be called for OT_Number.

Definition at line 261 of file IpRegOptions.hpp.

virtual Index Ipopt::RegisteredOption::DefaultInteger ( ) const [inline, virtual]

get the default as an Integer - can be called for OT_Integer

Definition at line 267 of file IpRegOptions.hpp.

virtual void Ipopt::RegisteredOption::SetDefaultInteger ( const Index default_value) [inline, virtual]

Set the default as an Integer - can be called for OT_Integer.

Definition at line 274 of file IpRegOptions.hpp.

virtual std::string Ipopt::RegisteredOption::DefaultString ( ) const [inline, virtual]

get the default as a string - can be called for OT_String

Definition at line 280 of file IpRegOptions.hpp.

virtual Index Ipopt::RegisteredOption::DefaultStringAsEnum ( ) const [inline, virtual]

get the default as a string, but as the index of the string in the list - helps map from a string to an enum- can be called for OT_String

Definition at line 288 of file IpRegOptions.hpp.

virtual void Ipopt::RegisteredOption::SetDefaultString ( const std::string &  default_value) [inline, virtual]

Set the default as a string - can be called for OT_String.

Definition at line 294 of file IpRegOptions.hpp.

virtual std::vector<string_entry> Ipopt::RegisteredOption::GetValidStrings ( ) const [inline, virtual]

get the valid string settings - can be called for OT_String

Definition at line 300 of file IpRegOptions.hpp.

virtual bool Ipopt::RegisteredOption::IsValidNumberSetting ( const Number value) const [inline, virtual]

Check if the Number value is a valid setting - can be called for OT_Number.

Definition at line 307 of file IpRegOptions.hpp.

virtual bool Ipopt::RegisteredOption::IsValidIntegerSetting ( const Index value) const [inline, virtual]

Check if the Integer value is a valid setting - can be called for OT_Integer.

Definition at line 322 of file IpRegOptions.hpp.

virtual bool Ipopt::RegisteredOption::IsValidStringSetting ( const std::string &  value) const [virtual]

Check if the String value is a valid setting - can be called for OT_String.

virtual std::string Ipopt::RegisteredOption::MapStringSetting ( const std::string &  value) const [virtual]

Map a user setting (allowing any case) to the case used when the setting was registered.

virtual Index Ipopt::RegisteredOption::MapStringSettingToEnum ( const std::string &  value) const [virtual]

Map a user setting (allowing any case) to the index of the matched setting in the list of string settings.

Helps map a string setting to an enumeration.

virtual void Ipopt::RegisteredOption::OutputDescription ( const Journalist jnlst) const [virtual]

output a description of the option

virtual void Ipopt::RegisteredOption::OutputShortDescription ( const Journalist jnlst) const [virtual]

output a more concise version

virtual void Ipopt::RegisteredOption::OutputLatexDescription ( const Journalist jnlst) const [virtual]

output a latex version

void Ipopt::RegisteredOption::MakeValidLatexString ( std::string  source,
std::string &  dest 
) const [private]
std::string Ipopt::RegisteredOption::MakeValidLatexNumber ( Number  value) const [private]
bool Ipopt::RegisteredOption::string_equal_insensitive ( const std::string &  s1,
const std::string &  s2 
) const [private]

Compare two strings and return true if they are equal (case insensitive comparison)


Member Data Documentation

std::string Ipopt::RegisteredOption::name_ [private]

Definition at line 357 of file IpRegOptions.hpp.

Definition at line 358 of file IpRegOptions.hpp.

Definition at line 359 of file IpRegOptions.hpp.

Definition at line 360 of file IpRegOptions.hpp.

Definition at line 361 of file IpRegOptions.hpp.

Definition at line 363 of file IpRegOptions.hpp.

Definition at line 364 of file IpRegOptions.hpp.

Definition at line 365 of file IpRegOptions.hpp.

Definition at line 366 of file IpRegOptions.hpp.

Definition at line 367 of file IpRegOptions.hpp.

Definition at line 368 of file IpRegOptions.hpp.

Definition at line 369 of file IpRegOptions.hpp.

Definition at line 379 of file IpRegOptions.hpp.

Definition at line 380 of file IpRegOptions.hpp.

Has the information as how many-th option this one was registered.

Definition at line 384 of file IpRegOptions.hpp.


The documentation for this class was generated from the following file:
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Defines