DebugUtil::WrapperGetOpt Class Reference

class supporting argument parsing for executing programs to debug More...

Inherits GetOpt.

## Public Member Functions

| split (list< string > args, reference< list< string >> wrp_args, reference< *string > pgm_name, reference< list< string >> pgm_args)
| Parses input arguments until a standalone argument is found. More...

## Detailed Description

class supporting argument parsing for executing programs to debug

When implementing a wrapper that executes a program whose name is passed on the command line, we can divide the arguments usually into 3 groups:

- internal wrapper arguments
- target program filename
- program arguments

The class support argument parsing for such a case.

Examples:

        (   # GetOpt options
            'help': 'h,help',
            'verbose': 'v,verbose',
            'listen': 'l,listen=s@',
        );
        wrapper-prog -v -l xxx xxx -v -l    # the second xxx is target program name
        wrapper-prog -v -h xxx xxx          # the first xxx is target program name
        wrapper-prog -v --listen=xxx xxx    # the second xxx is target program name
        wrapper-prog -v --listen xxx xxx    # the second xxx is target program name

## Member Function Documentation

## split()

DebugUtil::WrapperGetOpt::split | ( | list< string > | args,
|  | reference< list< string >> | wrp_args,
|  | reference< *string > | pgm_name,
|  | reference< list< string >> | pgm_args
| ) |  |

Parses input arguments until a standalone argument is found.

Parameters

  args | List of arguments passed to wrapper, typically ARGV
  wrp_args | returns list of wrapper arguments
  pgm_name | returns target program filename. "" is considered as special file name (stdin), NOTHING when no name provided
  pgm_args | return List of target program arguments

Example:
  hash opts = (
  'help': 'h,help',
  'verbose': 'v,verbose',
  'listen': 'l,listen=s@',
  );
  WrapperGetOpt g(opts);
  list dargs;
  hash opt;
  *string fileName;
  g.split(ARGV, \dargs, \fileName, \ARGV);
  try {
  opt = g.parse2(\dargs);
  } catch (hash ex) {
  stderr.printf("%s: %s\n", ex.err, ex.desc);
  help(-1);
  }
  if (exists fileName) {
  stderr.print("No input file\n");
  exit(-1);
  }