g++ [flags ...] commandline ... -l /isip/tools/lib/$ISIP_BINARY/lib_shell.a

#include <CommandLine.h>

~CommandLine();
CommandLine();
CommandLine(const CommandLine& arg);
boolean setHelp(const unichar* help_message);
String& addOptionParam(Long& var, const String& param, long def_value);
boolean parse(int argc, const char** argv);
long getOptionIndex(const String& param_name);

String com_str(L"foo.exe -swap -sf 7000.0 -help");

CommandLine cmdl;

// add an swap flag
//
String flag_param(L"swap");
Boolean swap;
cmdl.addFlagParam(swap, flag_param);

// add a sample frequency
//
String sf_param(L"sf");
Float sf;
cmdl.addOptionParam(sf, sf_param, (float)8000.0);

// parse the commandline
//
cmdl.parse(com_str);

// test the swap flag
//
if (swap) {
 Console::put(L"swap flag specified");
}

// print the sample frequency
//
sf.debug(L"sample frequency");

• This example shows how to retrieve the command line arguments and values for the following program:

  foo.exe -nbytes 4 -mode stereo file.raw

  The code below demonstrates how to initialize a command line object to process this command line:

  // declare a command line, and a string containing an example command line
  //
  CommandLine cmdl;
  String str(L"foo.exe -nbytes 4 -mode stereo file.raw");
  
  // add the mode
  //
  String mode_param(L"mode");
  String mode_def(L"play");
  String mode;
         
  cmdl.addOptionParam(mode, mode_param, mode_def);
         
  // add the number of bytes
  //
  String nbytes_param(L"nbytes");
  Long nbytes;
  cmdl.addOptionParam(nbytes, nbytes_param, (long)2);
         
  // set the help message
  //
  cmdl.setHelp(#include "dbg_help.help");
         
  // parse the commandline
  //
  cmdl.parse(str);
         
  // print the mode
  //
  mode.debug(L"mode");
         
  // get number of unused arguments
  //
  Long num_arg = (long)cmdl.numArguments();
         
  // get unused arguments
  //
  String arg;
  cmdl.getArgument(arg, 0);
         
  // print the number of unused arguments
  //
  num_arg.debug(L"numArguments");
         
  // print the unused argument
  //
  arg.debug(L"getArgument");

• The main advantage of this class is that it is used by every utility, and hence centralizes command line argument processing. It is also a way of providing a uniform interface across all utilities, since this class standardizes the syntax for command line arguments.