Inshaping: include/anyarg.h Source File

Inshaping

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