ossimArgumentParser.h

Go to the documentation of this file.

//-------------------------------------------------------------------------
//
// This code was taken from Open Scene Graph and incorporated from into
// OSSIM.
//
//-------------------------------------------------------------------------
// $Id: ossimArgumentParser.h 22491 2013-11-26 18:17:29Z dburken $
#ifndef ossimArgumentParser_HEADER
#define ossimArgumentParser_HEADER 1
#include <ossim/base/ossimConstants.h>
#include <ossim/base/ossimString.h>
#include <map>
#include <string>
#include <iosfwd>

class ossimApplicationUsage;

class OSSIMDLLEXPORT ossimArgumentParser
{
public:
   
   class ossimParameter
   {
   public:
      enum ossimParameterType
      {
         OSSIM_FLOAT_PARAMETER,
         OSSIM_DOUBLE_PARAMETER,
         OSSIM_INT_PARAMETER,
         OSSIM_UNSIGNED_INT_PARAMETER,
         OSSIM_STRING_PARAMETER,
      };
      
      union ossimValueUnion
      {
         float*          theFloat;
         double*         theDouble;
         int*            theInt;
         unsigned int*   theUint;
         std::string*    theString;
      };
      
      ossimParameter(float& value)
      {
         theType = OSSIM_FLOAT_PARAMETER; theValue.theFloat = &value;
      }
      
      ossimParameter(double& value)
      {
         theType = OSSIM_DOUBLE_PARAMETER; theValue.theDouble = &value;
      }
      
      ossimParameter(int& value)
      {
         theType = OSSIM_INT_PARAMETER; theValue.theInt = &value;
      }
      
      ossimParameter(unsigned int& value)
      {
         theType = OSSIM_UNSIGNED_INT_PARAMETER; theValue.theUint = &value;
      }
      
      ossimParameter(std::string& value)
      {
         theType = OSSIM_STRING_PARAMETER; theValue.theString = &value;
      }
      
      ossimParameter(ossimString& value)
      {
         theType = OSSIM_STRING_PARAMETER; theValue.theString =
                                              &(value.string());
      }
      
      bool valid(const char* str) const;
      bool assign(const char* str);

   protected:
      
      ossimParameterType   theType;
      ossimValueUnion      theValue;
   };
   
   static bool isOption(const char* str);
   
   static bool isString(const char* str);
   
   static bool isNumber(const char* str);
   
public:
   
   ossimArgumentParser(int* argc,char **argv);
   ossimArgumentParser(const ossimString& commandLine);

   ~ossimArgumentParser();

   void initialize(int* argc, const char **argv); 
   
   void setApplicationUsage(ossimApplicationUsage* usage) { theUsage = usage; }
   ossimApplicationUsage* getApplicationUsage() { return theUsage; }
   const ossimApplicationUsage* getApplicationUsage() const { return theUsage; }
   
   int& argc() { return *theArgc; }
   
   char** argv() { return theArgv; }
   
   char* operator [] (int pos) { return theArgv[pos]; }
   
   const char* operator [] (int pos) const { return theArgv[pos]; }
   
   std::string getApplicationName() const;
   
   int find(const std::string& str) const;
   
   bool isOption(int pos) const;
   
   bool isString(int pos) const;
   
   bool isNumber(int pos) const;
   
   bool containsOptions() const;
   
   void remove(int pos,int num=1);
   
   void insert(int pos, const ossimString& arg);

   bool match(int pos, const std::string& str) const;
   
   bool read(const std::string& str);
   bool read(const std::string& str, ossimParameter value1);
   bool read(const std::string& str, ossimParameter value1,
             ossimParameter value2);
   bool read(const std::string& str, ossimParameter value1,
             ossimParameter value2, ossimParameter value3);
   bool read(const std::string& str, ossimParameter value1,
             ossimParameter value2, ossimParameter value3,
             ossimParameter value4);
   bool read(const std::string& str, ossimParameter value1,
             ossimParameter value2, ossimParameter value3,
             ossimParameter value4, ossimParameter value5);
   bool read(const std::string& str, ossimParameter value1,
             ossimParameter value2, ossimParameter value3,
             ossimParameter value4, ossimParameter value5,
             ossimParameter value6);
   
   bool read(const std::string& str, std::vector<ossimString>& param_list);

   int numberOfParams(const std::string& str,
                      const ossimParameter value) const;
   
   bool read(int pos, const std::string& str);
   bool read(int pos, const std::string& str, ossimParameter value1);
   bool read(int pos, const std::string& str, ossimParameter value1,
             ossimParameter value2);
   bool read(int pos, const std::string& str, ossimParameter value1,
             ossimParameter value2, ossimParameter value3);
   bool read(int pos, const std::string& str, ossimParameter value1,
             ossimParameter value2, ossimParameter value3,
             ossimParameter value4);
   
   
   enum ossimErrorSeverity
   {
      OSSIM_BENIGN = 0,
      OSSIM_CRITICAL = 1
   };
   
   typedef std::map<std::string,ossimErrorSeverity> ossimErrorMessageMap;
   
   bool errors(ossimErrorSeverity severity=OSSIM_BENIGN) const;
   
   void reportError(const std::string& message,
                    ossimErrorSeverity severity=OSSIM_CRITICAL);
   
   void reportRemainingOptionsAsUnrecognized(
      ossimErrorSeverity severity=OSSIM_BENIGN);
   
   ossimErrorMessageMap& getErrorMessageMap();
   
   const ossimErrorMessageMap& getErrorMessageMap() const;
   
   void writeErrorMessages(std::ostream& output,
                           ossimErrorSeverity sevrity=OSSIM_BENIGN);
   
   
protected:
   
   int*                     theArgc;
   char**                   theArgv;
   ossimErrorMessageMap     theErrorMessageMap;
   ossimApplicationUsage*   theUsage;
   bool                     theMemAllocated;
        
};

#endif