Inshaping: include/anyarg.h Source File

Inshaping

previous page next page
Inshaping 0.1
include
 
 /*
 A single letter option begins with a hyphen '-'. The parsing of single letter options follows POSIX conventions.
 
 A long option begins with two hyphens '--'. The parsing of long options follows GNU conventions.
 
 Only specify/define a option once, otherwise you will incurr an error.
 
 Example:
 Supposing program \c foo has two flags (-a -all, -v --verbose) and two taking-value options (-s
 --buffer-size, -n), you can turn on flag a and v, set option s to 100 and n to 50, and pass another two
 non-option arguments (abc and xyz) to foo by:
 
 foo -av -s 100 -n 50 abc xyz foo -av
 --buffer-size=100 -n 50 abc xyz
 foo --all --verbose --buffer-size=100 -n 50 abc xyz
 
 POSIX conventions:
 http://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap12.html
 
 GNU extensions:
 http://www.gnu.org/prep/standards/html_node/Command_002dLine-Interfaces.html
 */
 
 
 #ifndef __ANYARG_H__
 #define __ANYARG_H__
 
 #include <string>
 #include <vector>
 #include <cstdlib>
 #include <cstring>
 
 using std::string;
 using std::vector;
 
 
 struct Option
 {
     char type;    // type of option
     char letter;  // single-letter label of an option
     string name;   // long name of an option
 //  char valtype;  // value type, [BSID], bool: B, string: S, int: I, double: D
     string value_str; // option value as a string
     union {           // option value as a bool, int or double value
         bool value_bool;
         int value_int;
         double value_double;
     };
     string desc;   // a short sentence to describe an option
     string meta;   // a META word to specify the type of option argument, such as "FILE", "SIZE"
 
     Option():type(0), letter(), name(), value_str(), value_double(0.0), desc(), meta() {}
     bool set_value(const char *opt_value);
     bool set_desc_meta(const char *opt_desc);
 };
 
 
 class Anyarg
 {
   public:
     Anyarg();
 
 
     bool add_flag(const char *name, char letter, const char *desc);
     bool add_flag(char letter, const char *desc);
 
 
     // Add an option with a string value
     bool add_option_str(const char *name, char letter, const char *v0, const char *desc);
     bool add_option_str(char letter, const char *v0, const char *desc);
 
     // Add an option with an integer value
     bool add_option_int(char letter, int v0, const char *desc);
     bool add_option_int(const char *name, char letter, int v0, const char *desc);
 
     // Add an option with an double value
     bool add_option_double(char letter, double v0, const char *desc);
     bool add_option_double(const char *name, char letter, double v0, const char *desc);
     
     bool parse_argv(int argc, char **argv);
     
 
     bool is_true(const char *name) const;
     bool is_true(char letter) const;
     
 
     // Get the value of an option with string values
     const char *get_value_str(const char *name) const;
     const char *get_value_str(char letter) const;
     
     // Get the value of an option with integer values
     int get_value_int(const char *name) const;
     int get_value_int(char letter) const;
 
     // Get the value of an option with double values
     double get_value_double(const char *name) const;
     double get_value_double(char letter) const;
 
     int get_argc() const;
 
     const char *get_arg(int i) const;
 
     const char *auto_usage();
 
   private:
     string prog_name_;  // name of the program
     int argc_;    // count of non-option arguments
     vector<string> argv_; // vector of non-option arguments
 
     vector<Option> options_; // vector of options
     
     string help_;     // formatted help for options
 
     Anyarg(const Anyarg &); // prevent the copy of a anyarg object
 
     Anyarg & operator = (const Anyarg &); // prevent assignment of anyarg object
     
     bool is_new_option(const char *name, char letter);
 
     int  get_optind(char letter) const;
 
     int  get_optind(const char *name) const;
     
     // Show information of all options, for debugging.
     void show_options() const;
 };
 
 #endif
Generated by
1.8.14
previous page start next page