AAO DRAMA/DRAMA2 C++ Interface
Public Member Functions | List of all members
drama::gitarg::Int< MinVal, MaxVal, DefaultVal > Class Template Reference

Detailed Description

template<long int MinVal = LONG_MIN, long int MaxVal = LONG_MAX, long int DefaultVal = 0>
class drama::gitarg::Int< MinVal, MaxVal, DefaultVal >

A class which reads integer values from an SDS argument structure.

A C++ class which provides an interface to GitArgGetI() . It Implements an integer type which includes the method Get(), to fetch its value from an SDS structure. There is also a constructor which does the Get operation.

See also
GitArgGetI()
Template Parameters
MinValueThe minimum value acceptable in a Get ( operation. Default is LONG_MIN (from limits.h)
MaxValueThe maximum value acceptable in a Get operation. Default is LONG_MAX (from limits.h)
DefaultValThe default value for the item. This is NOT validated against the range and hence can be used to set it to a identifiable particular value, if desired. Defaults to zero.

#include "gitarg.hh"

Public Member Functions

 Int (const long def=DefaultVal)
 Simple constructor with a default value specified. More...
 
 Int (const sds::Id &Id, const std::string &Name="Argument1", const int Position=1, const long Default=DefaultVal, const Flags flags=Flags::KeepErr)
 Constructor which contructs the value from an item in an SDS structure. More...
 
virtual void Get (const sds::Id &Id, const std::string &Name="Argument1", const int Position=1, const long int Default=0, const Flags flags=Flags::KeepErr)
 Get the value of the object from an SDS structure. More...
 
 operator long int () const
 Conversion operator - given git::Int, return a long int. More...
 

Constructor & Destructor Documentation

template<long int MinVal = LONG_MIN, long int MaxVal = LONG_MAX, long int DefaultVal = 0>
drama::gitarg::Int< MinVal, MaxVal, DefaultVal >::Int ( const long  def = DefaultVal)
inline

Simple constructor with a default value specified.

Parameters
defThe default value to use. If not specified, uses template argument "DefaultVal".
template<long int MinVal = LONG_MIN, long int MaxVal = LONG_MAX, long int DefaultVal = 0>
drama::gitarg::Int< MinVal, MaxVal, DefaultVal >::Int ( const sds::Id Id,
const std::string &  Name = "Argument1",
const int  Position = 1,
const long  Default = DefaultVal,
const Flags  flags = Flags::KeepErr 
)
inline

Constructor which contructs the value from an item in 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. (

Parameters
IdThe SDS structure.
NameThe name of the item within the structure.
PositionIf the item does not exist by the name, then presume this position.
DefaultThe default value. If not specified, uses "DefaultVal".
flagsWhich GIT Flags to apply. If you specify KeepErr, then an exception is throw if the value in the SDS structure is invalid. 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.

References drama::Default, and drama::gitarg::Int< MinVal, MaxVal, DefaultVal >::Get().

Member Function Documentation

template<long int MinVal = LONG_MIN, long int MaxVal = LONG_MAX, long int DefaultVal = 0>
virtual void drama::gitarg::Int< MinVal, MaxVal, DefaultVal >::Get ( const sds::Id Id,
const std::string &  Name = "Argument1",
const int  Position = 1,
const long int  Default = 0,
const Flags  flags = Flags::KeepErr 
)
inlinevirtual

Get the value of the object 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.

Parameters
IdThe SDS structure.
NameThe name of the item within the structure.
PositionIf the item does not exist by the name, then presume this position.
DefaultThe default value.
flagsWhich GIT Flags to apply. If you specify KeepErr, then an exception is throw if the value in the SDS structure is invalid. 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.

References drama::Default, and DramaTHROW.

Referenced by drama::gitarg::Int< MinVal, MaxVal, DefaultVal >::Int().

template<long int MinVal = LONG_MIN, long int MaxVal = LONG_MAX, long int DefaultVal = 0>
drama::gitarg::Int< MinVal, MaxVal, DefaultVal >::operator long int ( ) const
inline

Conversion operator - given git::Int, return a long int.


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

Click here for the DRAMA home page and here for the AAO home page.

For more information, contact tjf@aao.gov.au 

Generated on Mon Feb 22 2016 15:57:53 for AAO DRAMA/DRAMA2 C++ Interface by doxygen 1.8.10