yat  0.21pre
Public Member Functions | Protected Member Functions | List of all members
theplu::yat::utility::OptionInFile Class Reference

Class for file related options. More...

#include <yat/utility/OptionInFile.h>

Inheritance diagram for theplu::yat::utility::OptionInFile:
theplu::yat::utility::OptionFile theplu::yat::utility::OptionArg< std::string > theplu::yat::utility::Option

Public Member Functions

 OptionInFile (CommandLine &cmd, std::string name, std::string desc, bool required=false) YAT_DEPRECATE_GCC_PRE4_3
 Constructor. More...
 
virtual ~OptionInFile (void)
 Destructor.
 
std::istream & istream (void)
 
void print_arg (std::string arg)
 
std::string value (void) const
 
void value (std::string v)
 set value More...
 
std::string description (void) const
 
void description (const std::string &description)
 set description More...
 
std::string long_name (void) const
 
void parse (std::vector< std::string >::iterator &, const std::vector< std::string >::iterator &)
 parsing the commandline
 
bool present (void) const
 Get if option was found in cmd. More...
 
std::string print (void)
 print help output More...
 
void reset (void)
 sets present to false
 
char short_name (void) const
 
void validate (void)
 Validate the Option. More...
 

Protected Member Functions

bool required (void) const
 
const CommandLinecmd (void) const
 

Detailed Description

Class for file related options.

Deprecated:
Provided for backward compatibility with the 0.5 API. Use OptionFile and StreamRedirect instead (see CommandLine for example code).

Constructor & Destructor Documentation

◆ OptionInFile()

theplu::yat::utility::OptionInFile::OptionInFile ( CommandLine cmd,
std::string  name,
std::string  desc,
bool  required = false 
)

Constructor.

Parameters
cmdCommandline Option is associated with
namestring such as "file" for –file, "f" for -f or "f,file" for having both short and long option name
descstring used in help display
requiredIf true option must be found in commandline or exception is thrown in validation

Member Function Documentation

◆ cmd()

const CommandLine& theplu::yat::utility::Option::cmd ( void  ) const
protectedinherited
Returns
const reference to CommandLine Option belongs to.

◆ description() [1/2]

std::string theplu::yat::utility::Option::description ( void  ) const
inherited
Returns
description

◆ description() [2/2]

void theplu::yat::utility::Option::description ( const std::string &  description)
inherited

set description

Since
New in yat 0.7

◆ istream()

std::istream& theplu::yat::utility::OptionInFile::istream ( void  )
Returns
ifstream corresponding to value(). If option was not found during parsing, std::cin is returned.

◆ long_name()

std::string theplu::yat::utility::Option::long_name ( void  ) const
inherited
Returns
long name e.g. 'help' for –help option.

◆ present()

bool theplu::yat::utility::Option::present ( void  ) const
inherited

Get if option was found in cmd.

Returns
true if option has been detected in parsing

◆ print()

std::string theplu::yat::utility::Option::print ( void  )
inherited

print help output

This function calls the four virtual private functions print1, print2, print3, and print4. This allows an inherited class to implement one (or several) of these functions and keep the default output of the others. The default behavior is that:

◆ print_arg()

void theplu::yat::utility::OptionArg< std::string >::print_arg ( std::string  arg)
inlineinherited
Parameters
argstring to be used in help output such as '=TARGET' in '–target=TARGET'. See print3().
Since
New in yat 0.5.

◆ required()

bool theplu::yat::utility::OptionArg< std::string >::required ( void  ) const
inlineprotectedinherited
Returns
true if Option is required, i.e., if Option is not found during parsing an exception will be thrown.

◆ short_name()

char theplu::yat::utility::Option::short_name ( void  ) const
inherited
Returns
short name e.g. 'h' for -h option.

◆ validate()

void theplu::yat::utility::Option::validate ( void  )
inherited

Validate the Option.

This function is called by CommandLine::parse() after all options have been detected and parsed (see Option::parse()).

◆ value() [1/2]

std::string theplu::yat::utility::OptionArg< std::string >::value ( void  ) const
inlineinherited
Returns
value

◆ value() [2/2]

void theplu::yat::utility::OptionArg< std::string >::value ( std::string  v)
inlineinherited

set value

Since
new in yat 0.5

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

Generated on Wed Jan 25 2023 03:34:29 for yat by  doxygen 1.8.14