Option_Float Class Reference

#include <Option.h>

Inheritance diagram for Option_Float:

Option

Detailed Description

Definition at line 441 of file Option.h.


Public Member Functions

virtual bool getBool () const throw (InvalidArgument)
 Returns the stored boolean value.
const std::string & getDescription () const throw ()
 Returns the description of what this option does.
SUMOReal getFloat () const throw (InvalidArgument)
 Returns the stored SUMOReal value.
virtual int getInt () const throw (InvalidArgument)
 Returns the stored integer value.
virtual const IntVector & getIntVector () const throw (InvalidArgument)
 Returns the stored integer vector.
virtual std::string getString () const throw (InvalidArgument)
 Returns the stored string value.
virtual const std::string & getTypeName () const throw ()
 Returns the mml-type name of this option.
std::string getValueString () const throw (InvalidArgument)
 Returns the string-representation of the value.
virtual bool isBool () const throw ()
 Returns the information whether the option is a bool option.
virtual bool isDefault () const throw ()
 Returns the information whether the option holds the default value.
virtual bool isFileName () const throw ()
 Returns the information whether this option is a file name.
bool isSet () const throw ()
 returns the information whether this options holds a valid value
bool isWriteable () const throw ()
 Returns the information whether the option may be set a further time.
Option_Float & operator= (const Option_Float &s) throw ()
 Assignment operator.
 Option_Float (const Option_Float &s) throw ()
 Copy constructor.
 Option_Float (SUMOReal value) throw ()
 Constructor for an option with a default value.
 Option_Float () throw ()
 Constructor for an option with no default value.
virtual bool set (bool v) throw (InvalidArgument)
 Sets the value (used for bool options).
bool set (const std::string &v) throw (InvalidArgument)
 Stores the given value after parsing it into a SUMOReal.
 ~Option_Float () throw ()
 Destructor.

Protected Member Functions

bool markSet () throw ()
 Marks the information as set.

Protected Attributes

std::string myTypeName
 A type name for this option (has presets, but may be overwritten).

Private Attributes

SUMOReal myValue

Friends

class OptionsCont

Constructor & Destructor Documentation

Option_Float::Option_Float (  )  throw ()

Constructor for an option with no default value.

Calls Option(false)

Definition at line 294 of file Option.cpp.

References Option::myTypeName.

00295         : Option() {
00296     myTypeName = "FLOAT";
00297 }

Option_Float::Option_Float ( SUMOReal  value  )  throw ()

Constructor for an option with a default value.

Calls Option(true)

Parameters:
[in] value This option's default value

Definition at line 300 of file Option.cpp.

References Option::myTypeName.

00301         : Option(true), myValue(value) {
00302     myTypeName = "FLOAT";
00303 }

Option_Float::Option_Float ( const Option_Float &  s  )  throw ()

Copy constructor.

Definition at line 309 of file Option.cpp.

References myValue.

00310         : Option(s) {
00311     myValue = s.myValue;
00312 }

Option_Float::~Option_Float (  )  throw ()

Destructor.

Definition at line 306 of file Option.cpp.

00306 {}

Member Function Documentation

bool Option::getBool (  )  const throw (InvalidArgument) [virtual, inherited]

Returns the stored boolean value.

Option_Bool returns the stored boolean in this method's reimplementation. All other option classes do not override this method which throws an InvalidArgument-exception.

Returns:
Returns the stored boolean if being an instance of Option_Bool
Exceptions:
InvalidArgument If the class is not an instance of Option_Bool

Reimplemented in Option_Bool.

Definition at line 99 of file Option.cpp.

Referenced by OptionsCont::getBool().

00099                                              {
00100     throw InvalidArgument("This is not a bool-option");
00101 }

const std::string & Option::getDescription (  )  const throw () [inherited]

Returns the description of what this option does.

The description stored in myDescription is returned.

Returns:
The description of this option's purpose

Definition at line 163 of file Option.cpp.

References Option::myDescription.

Referenced by OptionsCont::printHelp(), and OptionsCont::writeConfiguration().

00163                                      {
00164     return myDescription;
00165 }

SUMOReal Option_Float::getFloat (  )  const throw (InvalidArgument) [virtual]

Returns the stored SUMOReal value.

See also:
SUMOReal Option::getFloat()
Returns:
Returns the stored real number

Reimplemented from Option.

Definition at line 327 of file Option.cpp.

References myValue.

00327                                                     {
00328     return myValue;
00329 }

int Option::getInt (  )  const throw (InvalidArgument) [virtual, inherited]

Returns the stored integer value.

Option_Integer returns the stored integer number in this method's reimplementation. All other option classesdo not override this method which throws an InvalidArgument-exception.

Returns:
Returns the stored integer number if being an instance of Option_Integer
Exceptions:
InvalidArgument If the class is not an instance of Option_Integer

Reimplemented in Option_Integer.

Definition at line 87 of file Option.cpp.

Referenced by OptionsCont::getInt().

00087                                             {
00088     throw InvalidArgument("This is not an int-option");
00089 }

const IntVector & Option::getIntVector (  )  const throw (InvalidArgument) [virtual, inherited]

Returns the stored integer vector.

Option_IntVector returns the stored integer vector in this method's reimplementation. All other option classes do not override this method which throws an InvalidArgument-exception.

Returns:
Returns the stored integer vector if being an instance of Option_IntVector
Exceptions:
InvalidArgument If the class is not an instance of Option_IntVector

Reimplemented in Option_IntVector.

Definition at line 105 of file Option.cpp.

Referenced by OptionsCont::getIntVector().

00105                                                   {
00106     throw InvalidArgument("This is not an int vector-option");
00107 }

std::string Option::getString (  )  const throw (InvalidArgument) [virtual, inherited]

Returns the stored string value.

Option_String and Option_FileName return the stored string in this method's reimplementation. All other option classes do not override this method which throws an InvalidArgument-exception.

Returns:
Returns the stored string if being an instance of Option_String
Exceptions:
InvalidArgument If the class is not an instance of Option_String

Reimplemented in Option_String.

Definition at line 93 of file Option.cpp.

Referenced by OptionsCont::getString(), and OptionsCont::getStringVector().

00093                                                {
00094     throw InvalidArgument("This is not a string-option");
00095 }

const std::string & Option::getTypeName (  )  const throw () [virtual, inherited]

Returns the mml-type name of this option.

The type name stored in myTypeName is returned.

Returns:
The man-readable type name

Definition at line 169 of file Option.cpp.

References Option::myTypeName.

Referenced by OptionsCont::printHelp().

00169                                   {
00170     return myTypeName;
00171 }

std::string Option_Float::getValueString (  )  const throw (InvalidArgument) [virtual]

Returns the string-representation of the value.

The stored value is encoded into a string and returned.

See also:
std::string Option::getValueString()
Returns:
The stored value encoded into a string

Reimplemented from Option.

Definition at line 345 of file Option.cpp.

References myValue.

00345                                                           {
00346     std::ostringstream s;
00347     s << myValue;
00348     return s.str();
00349 }

bool Option::isBool (  )  const throw () [virtual, inherited]

Returns the information whether the option is a bool option.

Returns false. Only Option_Bool overrides this method returning true.

Returns:
true if the Option is an Option_Bool, false otherwise

Reimplemented in Option_Bool.

Definition at line 139 of file Option.cpp.

Referenced by OptionsCont::isBool(), OptionsCont::printHelp(), and OptionsCont::set().

00139                              {
00140     return false;
00141 }

bool Option::isDefault (  )  const throw () [virtual, inherited]

Returns the information whether the option holds the default value.

Returns:
true if the option was not set from command line / configuration, false otherwise

Definition at line 145 of file Option.cpp.

References Option::myHaveTheDefaultValue.

Referenced by OptionsCont::writeConfiguration().

00145                                 {
00146     return myHaveTheDefaultValue;
00147 }

bool Option::isFileName (  )  const throw () [virtual, inherited]

Returns the information whether this option is a file name.

Returns false. Only Option_FileName overrides this method returning true.

Returns:
true if the Option is an Option_FileName, false otherwise

Reimplemented in Option_FileName.

Definition at line 151 of file Option.cpp.

00151                                  {
00152     return false;
00153 }

bool Option::isSet (  )  const throw () [inherited]

returns the information whether this options holds a valid value

Returns:
Whether a value has been set

Definition at line 75 of file Option.cpp.

References Option::myAmSet.

Referenced by OptionsCont::checkDependingSuboptions(), OptionsCont::isUsableFileList(), and OptionsCont::writeConfiguration().

00075                             {
00076     return myAmSet;
00077 }

bool Option::isWriteable (  )  const throw () [inherited]

Returns the information whether the option may be set a further time.

This method returns whether the option was not already set using command line options / configuration. This is done by returning the value of myAmWritable.

Returns:
Whether the option may be set from the command line / configuration

Definition at line 157 of file Option.cpp.

References Option::myAmWritable.

Referenced by OptionsCont::isWriteable(), and OptionsCont::set().

00157                                   {
00158     return myAmWritable;
00159 }

bool Option::markSet (  )  throw () [protected, inherited]

Marks the information as set.

Sets the "myAmSet" - information. Returns whether the option was writeable before.

Returns:
Whether the option was not set before.

Definition at line 123 of file Option.cpp.

References Option::myAmSet, Option::myAmWritable, and Option::myHaveTheDefaultValue.

Referenced by Option_IntVector::set(), Option_Bool::set(), set(), Option_String::set(), and Option_Integer::set().

00123                         {
00124     bool ret = myAmWritable;
00125     myHaveTheDefaultValue = false;
00126     myAmSet = true;
00127     myAmWritable = false;
00128     return ret;
00129 }

Option_Float & Option_Float::operator= ( const Option_Float &  s  )  throw ()

Assignment operator.

Definition at line 316 of file Option.cpp.

References myValue, and Option::operator=().

00316                                                      {
00317     if (this==&s) {
00318         return *this;
00319     }
00320     Option::operator=(s);
00321     myValue = s.myValue;
00322     return *this;
00323 }

bool Option::set ( bool  v  )  throw (InvalidArgument) [virtual, inherited]

Sets the value (used for bool options).

Returns:
Whether the new value could be set

Reimplemented in Option_Bool.

Definition at line 117 of file Option.cpp.

00117                                        {
00118     throw InvalidArgument("This is not a bool-option.");
00119 }

bool Option_Float::set ( const std::string &  v  )  throw (InvalidArgument) [virtual]

Stores the given value after parsing it into a SUMOReal.

The value is converted into a SUMOReal and stored in "myValue". Then, "markSet" is called in order to know that a value has been set.

The method returns whether the value could be set (the return value from "markSet").

If the string could not be converted into a SUMOReal, an InvalidArgument is thrown.

See also:
bool Option::set(std::string v)
Returns:
Whether the new value could be set
Exceptions:
InvalidArgument If the value could not be converted into a SUMOReal

Reimplemented from Option.

Definition at line 333 of file Option.cpp.

References TplConvert< E >::_2SUMOReal(), Option::markSet(), and myValue.

00333                                                            {
00334     try {
00335         myValue = TplConvert<char>::_2SUMOReal(v.c_str());
00336         return markSet();
00337     } catch (...) {
00338         std::string s = "'" + v + "' is not a valid float (should be).";
00339         throw InvalidArgument(s);
00340     }
00341 }

Friends And Related Function Documentation

friend class OptionsCont [friend, inherited]

OptionsCont is a friend class

Definition at line 217 of file Option.h.

Field Documentation

std::string Option::myTypeName [protected, inherited]

A type name for this option (has presets, but may be overwritten).

Definition at line 269 of file Option.h.

Referenced by Option::getTypeName(), Option_Bool::Option_Bool(), Option_FileName::Option_FileName(), Option_Float(), Option_Integer::Option_Integer(), Option_IntVector::Option_IntVector(), and Option_String::Option_String().

SUMOReal Option_Float::myValue [private]

the value, valid only when the base-classes "myAmSet"-member is true

Definition at line 508 of file Option.h.

Referenced by getFloat(), getValueString(), operator=(), Option_Float(), and set().

The documentation for this class was generated from the following files:
Generated on Wed May 5 00:06:57 2010 for Sumo - Simulation of Urban MObility by  doxygen 1.5.6