Get()

virtual void drama::gitarg::Filename::Get ( const sds::Id &  Id, const std::string &  Name = "Argument1", const int  Position = 1, const std::string &  Default = "", const Flags  flags = Flags::KeepErr  )

virtual

Fetch the value of this item from an SDS structure.

The value is fetched from the named item (arg #2) within the SDS structure specified. or the Position (constructor arg #3) item in the
structure if the item named does not exist.

The code confirms the value represents a file which exists and can be read by this program.

Note

The DRAMA lock must be taken when executing this. If in a thread, the preference is to take it by constructing a drama::AccessDrama object to ensure the action context is correct.

Parameters

Id	The SDS structure.
Name	The name of the item within the structure.
Position	If the item does not exist by the name, then presume this position.
Default	The default value.
flags	Which GIT Flags to apply. If you specify KeepErr, then an exception is throw if the value in the SDS structure is invalid or does not represent the name of file which exists and can be read by this program. If you don't specify KeepErr and and the SDS structure does not contain a value item, then the value is set to the supplied default.

Reimplemented from drama::gitarg::String.

Referenced by Filename(), and Filename().