SUMO - Simulation of Urban MObility
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Modules Pages
Option_FileName Class Reference

#include <Option.h>

Inheritance diagram for Option_FileName:
Inheritance graph
Collaboration diagram for Option_FileName:
Collaboration graph

Public Member Functions

virtual bool getBool () const
 Returns the stored boolean value. More...
 
const std::string & getDescription () const
 Returns the description of what this option does. More...
 
virtual SUMOReal getFloat () const
 Returns the stored SUMOReal value. More...
 
virtual int getInt () const
 Returns the stored integer value. More...
 
virtual const IntVectorgetIntVector () const
 Returns the stored integer vector. More...
 
std::string getString () const
 Returns the stored string value. More...
 
virtual const std::string & getTypeName () const
 Returns the mml-type name of this option. More...
 
std::string getValueString () const
 Returns the string-representation of the value. More...
 
virtual bool isBool () const
 Returns the information whether the option is a bool option. More...
 
virtual bool isDefault () const
 Returns the information whether the option holds the default value. More...
 
bool isFileName () const
 Returns true, the information whether this option is a file name. More...
 
bool isSet () const
 returns the information whether this options holds a valid value More...
 
bool isWriteable () const
 Returns the information whether the option may be set a further time. More...
 
Option_FileNameoperator= (const Option_FileName &s)
 Assignment operator. More...
 
 Option_FileName ()
 Constructor for an option with no default value. More...
 
 Option_FileName (const std::string &value)
 Constructor for an option with a default value. More...
 
 Option_FileName (const Option_String &s)
 Copy constructor. More...
 
void resetDefault ()
 Resets the option to be on its default value. More...
 
void resetWritable ()
 Resets the option to be writeable. More...
 
bool set (const std::string &v)
 Stores the given value. More...
 
void setDescription (const std::string &desc)
 Sets the description of what this option does. More...
 
void unSet ()
 marks this option as unset More...
 
virtual ~Option_FileName ()
 Destructor. More...
 

Protected Member Functions

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

Protected Attributes

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

Detailed Description

Definition at line 583 of file Option.h.

Constructor & Destructor Documentation

Option_FileName::Option_FileName ( )

Constructor for an option with no default value.

Definition at line 419 of file Option.cpp.

References Option::myTypeName.

Option_FileName::Option_FileName ( const std::string &  value)

Constructor for an option with a default value.

Parameters
[in]valueThis option's default value

Definition at line 425 of file Option.cpp.

References Option::myTypeName.

Option_FileName::Option_FileName ( const Option_String s)

Copy constructor.

Definition at line 431 of file Option.cpp.

Option_FileName::~Option_FileName ( )
virtual

Destructor.

Definition at line 435 of file Option.cpp.

Member Function Documentation

bool Option::getBool ( ) const
virtualinherited

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
InvalidArgumentIf the class is not an instance of Option_Bool

Reimplemented in Option_Bool.

Definition at line 104 of file Option.cpp.

Referenced by OptionsCont::getBool().

const std::string & Option::getDescription ( ) const
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 169 of file Option.cpp.

References Option::myDescription.

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

SUMOReal Option::getFloat ( ) const
virtualinherited

Returns the stored SUMOReal value.

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

Returns
Returns the stored real number if being an instance of Option_Float
Exceptions
InvalidArgumentIf the class is not an instance of Option_Float

Reimplemented in Option_Float.

Definition at line 86 of file Option.cpp.

Referenced by OptionsCont::getFloat().

int Option::getInt ( ) const
virtualinherited

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
InvalidArgumentIf the class is not an instance of Option_Integer

Reimplemented in Option_Integer.

Definition at line 92 of file Option.cpp.

Referenced by OptionsCont::getInt().

const IntVector & Option::getIntVector ( ) const
virtualinherited

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
InvalidArgumentIf the class is not an instance of Option_IntVector

Reimplemented in Option_IntVector.

Definition at line 110 of file Option.cpp.

Referenced by OptionsCont::getIntVector().

std::string Option_String::getString ( ) const
virtualinherited

Returns the stored string value.

See also
std::string Option::getString()
Returns
Returns the stored string

Reimplemented from Option.

Definition at line 280 of file Option.cpp.

References Option_String::myValue.

const std::string & Option::getTypeName ( ) const
virtualinherited

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 181 of file Option.cpp.

References Option::myTypeName.

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

std::string Option_FileName::getValueString ( ) const
virtual

Returns the string-representation of the value.

The value is URL-encoded using StringUtils::urlEncode and returned.

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

Reimplemented from Option_String.

Definition at line 452 of file Option.cpp.

References Option_String::myValue, and StringUtils::urlEncode().

bool Option::isBool ( ) const
virtualinherited

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 133 of file Option.cpp.

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

bool Option::isDefault ( ) const
virtualinherited

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 139 of file Option.cpp.

References Option::myHaveTheDefaultValue.

Referenced by OptionsCont::writeConfiguration().

bool Option_FileName::isFileName ( ) const
virtual

Returns true, the information whether this option is a file name.

Returns true.

Returns
true

Reimplemented from Option.

Definition at line 446 of file Option.cpp.

bool Option::isSet ( ) const
inherited

returns the information whether this options holds a valid value

Returns
Whether a value has been set

Definition at line 80 of file Option.cpp.

References Option::myAmSet.

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

bool Option::isWriteable ( ) const
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 151 of file Option.cpp.

References Option::myAmWritable.

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

bool Option::markSet ( )
protectedinherited

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 116 of file Option.cpp.

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

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

Option_FileName & Option_FileName::operator= ( const Option_FileName s)

Assignment operator.

Definition at line 439 of file Option.cpp.

References Option_String::operator=().

void Option::resetDefault ( )
inherited

Resets the option to be on its default value.

An option is on its default after initialisation with a value, but as soon as it gets set, it is no longer. This method resets the default-flag.

Definition at line 163 of file Option.cpp.

References Option::myHaveTheDefaultValue.

Referenced by OptionsCont::setDefault().

void Option::resetWritable ( )
inherited

Resets the option to be writeable.

An option is writable after initialisation, but as soon as it gets set, it is no longer writeable. This method resets the writable-flag.

Definition at line 157 of file Option.cpp.

References Option::myAmWritable.

bool Option_String::set ( const std::string &  v)
virtualinherited

Stores the given value.

The value is 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").

See also
bool Option::set(std::string v)
Returns
Whether the new value could be set

Implements Option.

Definition at line 286 of file Option.cpp.

References Option::markSet(), and Option_String::myValue.

void Option::setDescription ( const std::string &  desc)
inherited

Sets 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 175 of file Option.cpp.

References Option::myDescription.

Referenced by OptionsCont::addDescription().

void Option::unSet ( )
inherited

marks this option as unset

Definition at line 126 of file Option.cpp.

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

Field Documentation

std::string Option::myTypeName
protectedinherited
std::string Option_String::myValue
protectedinherited

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

Definition at line 444 of file Option.h.

Referenced by Option_String::getString(), Option_String::getValueString(), getValueString(), Option_String::operator=(), Option_String::Option_String(), and Option_String::set().


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