vpParseArgv Class Reference

#include <vpParseArgv.h>

Public Types
enum	vpArgvType {   ARGV_CONSTANT, ARGV_INT, ARGV_LONG, ARGV_STRING,   ARGV_REST, ARGV_FLOAT, ARGV_DOUBLE, ARGV_FUNC,   ARGV_GENFUNC, ARGV_HELP, ARGV_END }
enum	vpArgvFlags {   ARGV_NO_DEFAULTS = 0x1, ARGV_NO_LEFTOVERS = 0x2, ARGV_NO_ABBREV = 0x4, ARGV_DONT_SKIP_FIRST_ARG = 0x8,   ARGV_NO_PRINT = 0x10 }

Static Public Member Functions
static bool	parse (int *argcPtr, const char **argv, vpArgvInfo *argTable, int flags)
static int	parse (int argc, const char **argv, const char *validOpts, const char **param)

Static Public Attributes
static vpArgvInfo	defaultTable [2]

Detailed Description

Command line argument parsing.

The code below shows a first way to parse command line arguments using vpParseArgv class. It allows to specify an option name with more than one character.

#include <stdio.h>
#include <visp/vpParseArgv.h>

// Usage : [-int <integer value>] [-float <float value>] [-double <double value>] [-h]
int main(int argc, const char ** argv)
{
  // Variables to set by command line parsing
  int    i_val = 0;
  float  f_val = 0;
  double d_val = 0;

  // Parse the command line to set the variables
  vpParseArgv::vpArgvInfo argTable[] =
    {
      {"-int", vpParseArgv::ARGV_INT, (char*) NULL, (char *) &i_val,
     "An integer value."},
      {"-float", vpParseArgv::ARGV_FLOAT, (char*) NULL, (char *) &f_val,
       "A float value."},
      {"-double", vpParseArgv::ARGV_DOUBLE, (char*) NULL, (char *) &d_val,
       "A double value."},
      {"-h", vpParseArgv::ARGV_HELP, (char*) NULL, (char *) NULL,
       "Print the help."},
      {(char*) NULL, vpParseArgv::ARGV_END, (char*) NULL, (char*) NULL, (char*) NULL}
    } ;

  // Read the command line options
  if(vpParseArgv::parse(&argc, argv, argTable, 
            vpParseArgv::ARGV_NO_LEFTOVERS |
            vpParseArgv::ARGV_NO_ABBREV | 
            vpParseArgv::ARGV_NO_DEFAULTS)) {
    return (false);
  }
 
  // i_val, f_val, d_val may have new values
}

The code below shows an other way to parse command line arguments using vpParseArgv class. Here command line options are only one character long.

#include <stdio.h>
#include <stdlib.h>
#include <visp/vpParseArgv.h>

// List of allowed command line options
#define GETOPTARGS  "d:f:i:h" // double point mean here that the preceding option request an argument

// Usage : [-i <integer value>] [-f <float value>] [-d <double value>] [-h]
int main(int argc, const char ** argv)
{
  // Variables to set by command line parsing
  int    i_val = 0;
  float  f_val = 0;
  double d_val = 0;

  // Parse the command line to set the variables
  const char *optarg;
  int   c;
  while ((c = vpParseArgv::parse(argc, argv, GETOPTARGS, &optarg)) > 1) {

    switch (c) {
    case 'd': d_val = atof(optarg); break;
    case 'f': f_val = (float) atof(optarg); break;
    case 'i': i_val = atoi(optarg); break;
    case 'h': printf("Usage: ...\n"); return true; break;

    default:
      printf("Usage: ...\n"); return true; break;
    }
  }
  if ((c == 1) || (c == -1)) {
    // standalone param or error
    printf("Usage: ...\n");
    return false;
  }
 
  // i_val, f_val, d_val may have new values
}

Examples:

SickLDMRS-Process.cpp.

Definition at line 134 of file vpParseArgv.h.

Member Enumeration Documentation

enum vpParseArgv::vpArgvFlags

Flag bits.

Enumerator
ARGV_NO_DEFAULTS	No default options like -help.
ARGV_NO_LEFTOVERS	Print an error message if an option is not in the argument list.
ARGV_NO_ABBREV	No abrevation. Print an error message if an option is abrevated (ie "-i" in place of "-int" which is requested).
ARGV_DONT_SKIP_FIRST_ARG	Don't skip first argument.
ARGV_NO_PRINT	No printings.

Definition at line 157 of file vpParseArgv.h.

enum vpParseArgv::vpArgvType

Legal values for the type field of a vpArgvInfo.

Enumerator
ARGV_CONSTANT	Stand alone argument.
ARGV_INT	Argument is associated to an int.
ARGV_LONG	Argument is associated to a long.
ARGV_STRING	Argument is associated to a char * string.
ARGV_REST
ARGV_FLOAT	Argument is associated to a float.
ARGV_DOUBLE	Argument is associated to a double.
ARGV_FUNC
ARGV_GENFUNC
ARGV_HELP	Argument is for help displaying.
ARGV_END	End of the argument list.

Definition at line 140 of file vpParseArgv.h.

Member Function Documentation

bool vpParseArgv::parse ( int *  argcPtr, const char **  argv, vpArgvInfo *  argTable, int  flags  )

static

Process an argv array according to a table of expectedvcommand-line options.

The return value is a boolean value with true indicating an error. If an error occurs then an error message is printed on stderr. Under normal conditions, both *argcPtr and *argv are modified to return the arguments that couldn't be processed here (they didn't match the option table, or followed an vpParseArgv::ARGV_REST argument).

Parameters

argcPtr	Pointer to the count of command line arguments.
argv	Array of command line argument strings.
argTable	Array of command-specific argument descriptions.
flags	This parameter is to set with vpParseArgv::vpArgvFlags values or combinations of these values using the OR operator (vpParseArgv::ARGV_NO_LEFTOVERS | vpParseArgv::ARGV_NO_DEFAULTS). If the vpParseArgv::ARGV_NO_DEFAULTS bit is set, then don't generate information for default options.

Examples:

AROgre.cpp, AROgreBasic.cpp, BSpline.cpp, displayD3D.cpp, displayGTK.cpp, displayOpenCV.cpp, displaySequence.cpp, displayX.cpp, displayXMulti.cpp, fernClassifier.cpp, grab1394CMU.cpp, grab1394Two.cpp, grabDirectShow.cpp, grabDirectShowMulti.cpp, grabDisk.cpp, grabV4l2.cpp, histogram.cpp, homographyHartleyDLT2DObject.cpp, homographyHLM2DObject.cpp, homographyHLM3DObject.cpp, homographyRansac2DObject.cpp, imageDiskRW.cpp, imageSequenceReader.cpp, keyPointSurf.cpp, mbtEdgeKltTracking.cpp, mbtEdgeTracking.cpp, mbtKltTracking.cpp, moveAfma4.cpp, moveBiclops.cpp, Nurbs.cpp, parallelPort.cpp, parse-argv1.cpp, parse-argv2.cpp, photometricVisualServoing.cpp, planarObjectDetector.cpp, poseVirtualVS.cpp, ringLight.cpp, servoAfma4Point2DCamVelocityKalman.cpp, servoBiclopsPoint2DArtVelocity.cpp, servoSimu3D_cdMc_CamVelocity.cpp, servoSimu3D_cdMc_CamVelocityWithoutVpServo.cpp, servoSimu3D_cMcd_CamVelocity.cpp, servoSimu3D_cMcd_CamVelocityWithoutVpServo.cpp, servoSimu4Points.cpp, servoSimuAfma6FourPoints2DCamVelocity.cpp, servoSimuCircle2DCamVelocity.cpp, servoSimuCircle2DCamVelocityDisplay.cpp, servoSimuCylinder.cpp, servoSimuCylinder2DCamVelocityDisplay.cpp, servoSimuCylinder2DCamVelocityDisplaySecondaryTask.cpp, servoSimuFourPoints2DCamVelocity.cpp, servoSimuFourPoints2DCamVelocityDisplay.cpp, servoSimuFourPoints2DPolarCamVelocityDisplay.cpp, servoSimuLine2DCamVelocityDisplay.cpp, servoSimuPoint2DCamVelocity1.cpp, servoSimuPoint2DCamVelocity2.cpp, servoSimuPoint2DCamVelocity3.cpp, servoSimuPoint2DhalfCamVelocity1.cpp, servoSimuPoint2DhalfCamVelocity2.cpp, servoSimuPoint2DhalfCamVelocity3.cpp, servoSimuPoint3DCamVelocity.cpp, servoSimuSphere.cpp, servoSimuSphere2DCamVelocity.cpp, servoSimuSphere2DCamVelocitySecondaryTask.cpp, servoSimuSquareLine2DCamVelocityDisplay.cpp, servoSimuThetaUCamVelocity.cpp, servoSimuViper850FourPoints2DCamVelocity.cpp, SickLDMRS-Process.cpp, simulateCircle2DCamVelocity.cpp, simulateFourPoints2DCartesianCamVelocity.cpp, simulateFourPoints2DPolarCamVelocity.cpp, templateTracker.cpp, testClick.cpp, testColvector.cpp, testConversion.cpp, testCreateSubImage.cpp, testDisplacement.cpp, testDisplayRoi.cpp, testDisplays.cpp, testFeatureSegment.cpp, testIoPGM.cpp, testIoPPM.cpp, testMatrix.cpp, testMatrixException.cpp, testMatrixInverse.cpp, testMouseEvent.cpp, testPose.cpp, testReadImage.cpp, testRobust.cpp, testSurfKeyPoint.cpp, testSvd.cpp, testTime.cpp, testTrackDot.cpp, testTwistMatrix.cpp, testUndistortImage.cpp, testVideoDevice.cpp, testVideoDeviceDual.cpp, testXmlParser.cpp, trackDot.cpp, trackDot2.cpp, trackDot2WithAutoDetection.cpp, trackKltOpencv.cpp, trackMeCircle.cpp, trackMeEllipse.cpp, trackMeLine.cpp, trackMeNurbs.cpp, videoReader.cpp, and wireframeSimulator.cpp.

Definition at line 80 of file vpParseArgv.cpp.

References ARGV_CONSTANT, ARGV_DONT_SKIP_FIRST_ARG, ARGV_DOUBLE, ARGV_END, ARGV_FLOAT, ARGV_FUNC, ARGV_GENFUNC, ARGV_HELP, ARGV_INT, ARGV_LONG, ARGV_NO_ABBREV, ARGV_NO_LEFTOVERS, ARGV_REST, ARGV_STRING, and defaultTable.

int vpParseArgv::parse ( int  argc, const char **  argv, const char *  validOpts, const char **  param  )

static

Get next command line option and parameter.

Parameters

argc	Count of command line arguments.
argv	Array of command line argument strings.
validOpts	String of valid case-sensitive option characters, a ':' following a given character means that option can take a parameter.
param	Pointer to a pointer to a string for output.

Returns

If valid option is found, the character value of that option is returned, and *param points to the parameter if given, or is NULL if no param.

If standalone parameter (with no option) is found, 1 is returned, and param points to the standalone parameter

If option is found, but it is not in the list of valid options, -1 is returned, and *param points to the invalid argument.

When end of argument list is reached, 0 is returned, and *param is NULL.

Definition at line 507 of file vpParseArgv.cpp.

Member Data Documentation

vpParseArgv::vpArgvInfo vpParseArgv::defaultTable

static

Initial value:

= {
    {"-help", ARGV_HELP, (char *) NULL, (char *) NULL,
    "Print summary of command-line options and abort.\n"},
    {NULL, ARGV_END, (char *) NULL, (char *) NULL,
    (char *) NULL}
}

Definition at line 183 of file vpParseArgv.h.

Referenced by parse().