Public Member Functions | |
OFConsoleApplication (const char *app, const char *desc=NULL, const char *rcsid=NULL) | |
constructor | |
~OFConsoleApplication () | |
destructor | |
OFBool | parseCommandLine (OFCommandLine &cmd, int argCount, char *argValue[], const int flags=0, const int startPos=1) |
parse command line. | |
void | printHeader (const OFBool hostInfo=OFFalse, const OFBool stdError=OFFalse) |
print header of console application (consisting of identifier, name and description) | |
void | printUsage (const OFCommandLine *cmd=NULL) |
print usage (syntax of command line options) to standard output stream | |
void | printArguments (OFCommandLine *cmd=NULL) |
print expanded command line arguments to standard error stream | |
void | printIdentifier () |
print resource identifier to standard error stream | |
void | printError (const char *str, const int code=1) |
print error message (incl. | |
void | printWarning (const char *str, const char *prefix="warning") |
print warning message (w/o header) to standard error stream | |
void | printMessage (const char *str) |
print message (w/o header) to standard error stream. | |
OFBool | quietMode () const |
check quiet mode | |
void | setQuietMode (const OFBool mode=OFTrue) |
switch on/off quiet mode | |
void | checkValue (const OFCommandLine::E_ValueStatus status, OFCommandLine *cmd=NULL) |
check value status and print error message if necessary | |
void | checkParam (const OFCommandLine::E_ParamValueStatus status, OFCommandLine *cmd=NULL) |
check parameter status and print error message if necessary | |
void | checkDependence (const char *subOpt, const char *baseOpt, OFBool condition) |
check dependence between sub and base option and report an error if required. | |
void | checkConflict (const char *firstOpt, const char *secondOpt, OFBool condition) |
check conflict between two options and report an error if required. | |
Private Member Functions | |
OFConsoleApplication (const OFConsoleApplication &) | |
OFConsoleApplication & | operator= (const OFConsoleApplication &) |
Private Attributes | |
OFString | Name |
Name of the application (short form). | |
OFString | Description |
Short description of the application. | |
OFString | Identification |
Identification string (rcsid). | |
OFBool | QuietMode |
Switch on/off error and warning messages. | |
OFCommandLine * | CmdLine |
Pointer to associated CommandLine class. |
Builds an envelope for the OFCommandLine class to provide a consistent behaviour for all DCMTK console applications. Performs console output operations and error checking.
Definition at line 49 of file ofconapp.h.
OFConsoleApplication::OFConsoleApplication | ( | const char * | app, | |
const char * | desc = NULL , |
|||
const char * | rcsid = NULL | |||
) |
constructor
app | application name | |
desc | (short) description of what the application does | |
rcsid | identifier for console application |
OFBool OFConsoleApplication::parseCommandLine | ( | OFCommandLine & | cmd, | |
int | argCount, | |||
char * | argValue[], | |||
const int | flags = 0 , |
|||
const int | startPos = 1 | |||
) |
parse command line.
If the command line has no argument (in case at least one argument is required) and if the command line has only one argument, namely "--help" or the specified shortcut, (in all cases) the usage is printed (see printUsage).
cmd | reference to the OFCommandLine object | |
argCount | number of arguments (argc) | |
argValue | pointer to argument array (argv[]) | |
flags | flags to be used for parsing (e.g. OFCommandLine::PF_ExpandWildcards) | |
startPos | first argument to be parsed (default: 1, i.e. omit program name) |
void OFConsoleApplication::printHeader | ( | const OFBool | hostInfo = OFFalse , |
|
const OFBool | stdError = OFFalse | |||
) |
print header of console application (consisting of identifier, name and description)
hostInfo | print host information as reported by 'config.guess' if OFTrue | |
stdError | print to standard error stream if OFTrue (default: standard output) |
void OFConsoleApplication::printUsage | ( | const OFCommandLine * | cmd = NULL |
) |
print usage (syntax of command line options) to standard output stream
cmd | reference to command line class (default: object used for parsing) |
void OFConsoleApplication::printArguments | ( | OFCommandLine * | cmd = NULL |
) |
print expanded command line arguments to standard error stream
cmd | reference to command line class (default: object used for parsing) |
void OFConsoleApplication::printError | ( | const char * | str, | |
const int | code = 1 | |||
) |
print error message (incl.
header) to standard error stream and exit with error code
str | error message to be printed | |
code | error code to be returned (exit) |
void OFConsoleApplication::printWarning | ( | const char * | str, | |
const char * | prefix = "warning" | |||
) |
print warning message (w/o header) to standard error stream
str | warning message to be printed | |
prefix | prefix printed in front of the message |
void OFConsoleApplication::printMessage | ( | const char * | str | ) |
print message (w/o header) to standard error stream.
str | message to be printed |
OFBool OFConsoleApplication::quietMode | ( | ) | const |
check quiet mode
void OFConsoleApplication::setQuietMode | ( | const OFBool | mode = OFTrue |
) |
switch on/off quiet mode
mode | if OFTrue all error and warning messages will be suppressed |
void OFConsoleApplication::checkValue | ( | const OFCommandLine::E_ValueStatus | status, | |
OFCommandLine * | cmd = NULL | |||
) |
check value status and print error message if necessary
status | status of OFCommandLine::getValue() call | |
cmd | reference to command line class (default: object used for parsing) |
void OFConsoleApplication::checkParam | ( | const OFCommandLine::E_ParamValueStatus | status, | |
OFCommandLine * | cmd = NULL | |||
) |
check parameter status and print error message if necessary
status | status of OFCommandLine::getParam() call | |
cmd | reference to command line class (default: object used for parsing) |
void OFConsoleApplication::checkDependence | ( | const char * | subOpt, | |
const char * | baseOpt, | |||
OFBool | condition | |||
) |
check dependence between sub and base option and report an error if required.
Message format: "error: " + subOpt + " only allowed with " + baseOpt
subOpt | option to be checked | |
baseOpt | base option required for sub option | |
condition | if false error message is printed (i.e. base option is absent) |
void OFConsoleApplication::checkConflict | ( | const char * | firstOpt, | |
const char * | secondOpt, | |||
OFBool | condition | |||
) |
check conflict between two options and report an error if required.
Message format: "error: " + firstOpt + " not allowed with " + secondOpt
firstOpt | first option to be checked | |
secondOpt | second option to be checked | |
condition | if true error message is printed (i.e. a conflict exists) |