2. ´ðËÜŪ¤Ê»ÈÍÑÊýË¡

package <packname>
version <version>

option <long> <short> <desc> {argtype} {typestr="<type descr>"} \
    {default="<default value>"} {required} {argoptional} {multiple}
option <long> <short> <desc> {typestr="<type descr>"} \
    {values="value1","value2",...} {default="<default value>"} \
    {required} {argoptional} {multiple}
option <long> <short> <desc> flag <on/off>

section "section name" {sectiondesc="optional section description"}

# file sample1.ggo 
option  "str-opt"     s "A string option, for a filename" \
     string typestr="filename" no 
option  "my-opt"      m "Another integer option, \
     this time the description of the \
     option should be quite long to require wrapping... possibly \
     more than one wrapping :-) especially if I\nrequire a line break" int no 
option  "int-opt"     i "A int option"         int        yes 
section "more involved options" \
     sectiondesc="the following options\nare more complex"
option  "flag-opt"    - "A flag option"        flag       off
option  "funct-opt"   F "A function option"    no 
section "last option section"
option  "long-opt"    - "A long option"        long       no 
option  "def-opt"     - "A string option with default" \
     string default="Hello" no
option  "enum-opt"    - "A string option with list of values" \
     values="foo","bar","hello" default="hello" no

gengetopt < sample1.ggo

gengetopt < sample1.ggo --file-name=cmdline1 --unamed-opts

/* cmdline1.h */

/* File autogenerated by gengetopt version 2.14rc  */

#ifndef CMDLINE1_H
#define CMDLINE1_H

/* If we use autoconf.  */
#ifdef HAVE_CONFIG_H
#include "config.h"
#endif

#ifdef __cplusplus
extern "C" {
#endif /* __cplusplus */

#ifndef CMDLINE_PARSER_PACKAGE
#define CMDLINE_PARSER_PACKAGE "sample1"
#endif

#ifndef CMDLINE_PARSER_VERSION
#define CMDLINE_PARSER_VERSION "2.0"
#endif

struct gengetopt_args_info
{
  char * str_opt_arg;       /* A string option, for a filename.  */
  char * str_opt_orig;       /* A string option, for a filename original value given at command line.  */
  int my_opt_arg;       /* Another integer option, this time the description of the option should be quite long to require wrapping... possibly more than one wrapping :-) especially if I\nrequire a line break.  */
  char * my_opt_orig;       /* Another integer option, this time the description of the option should be quite long to require wrapping... possibly more than one wrapping :-) especially if I\nrequire a line break original value given at command line.  */
  int int_opt_arg;       /* A int option.  */
  char * int_opt_orig;       /* A int option original value given at command line.  */
  int flag_opt_flag;       /* A flag option (default=off).  */
  long long_opt_arg;       /* A long option.  */
  char * long_opt_orig;       /* A long option original value given at command line.  */
  char * def_opt_arg;       /* A string option with default (default='Hello').  */
  char * def_opt_orig;       /* A string option with default original value given at command line.  */
  char * enum_opt_arg;       /* A string option with list of values (default='hello').  */
  char * enum_opt_orig;       /* A string option with list of values original value given at command line.  */
  
  int help_given ;       /* Whether help was given.  */
  int version_given ;       /* Whether version was given.  */
  int str_opt_given ;       /* Whether str-opt was given.  */
  int my_opt_given ;       /* Whether my-opt was given.  */
  int int_opt_given ;       /* Whether int-opt was given.  */
  int flag_opt_given ;       /* Whether flag-opt was given.  */
  int funct_opt_given ;       /* Whether funct-opt was given.  */
  int long_opt_given ;       /* Whether long-opt was given.  */
  int def_opt_given ;       /* Whether def-opt was given.  */
  int enum_opt_given ;       /* Whether enum-opt was given.  */

  char **inputs ; /* unamed options */
  unsigned inputs_num ; /* unamed options number */
} ;

int cmdline_parser (int argc, char * const *argv, struct gengetopt_args_info *args_info);
int cmdline_parser2 (int argc, char * const *argv, struct gengetopt_args_info *args_info, int override, int initialize, int check_required);
int cmdline_parser_file_save(const char *filename, struct gengetopt_args_info *args_info);

void cmdline_parser_print_help(void);
void cmdline_parser_print_version(void);

void cmdline_parser_init (struct gengetopt_args_info *args_info);
void cmdline_parser_free (struct gengetopt_args_info *args_info);

int cmdline_parser_required (struct gengetopt_args_info *args_info, const char *prog_name);

extern char *cmdline_parser_enum_opt_values[] ;       /* Possible values for enum-opt.  */


#ifdef __cplusplus
}
#endif /* __cplusplus */
#endif /* CMDLINE1_H */

/* main1.cc */
/* we try to use gengetopt generated file in a C++ program */
/* we don't use autoconf and automake vars */

#include <iostream>
#include "stdlib.h"

#include "cmdline1.h"

using std::cout;
using std::endl;

int
main (int argc, char **argv)
{
  gengetopt_args_info args_info;

  cout << "This one is from a C++ program" << endl ;
  cout << "Try to launch me with some options" << endl ;
  cout << "(type sample1 --help for the complete list)" << endl ;
  cout << "For example: ./sample1 *.* --funct-opt" << endl ;

  /* let's call our cmdline parser */
  if (cmdline_parser (argc, argv, &args_info) != 0)
    exit(1) ;

  cout << "Here are the options you passed..." << endl;

  for ( unsigned i = 0 ; i < args_info.inputs_num ; ++i )
    cout << "file: " << args_info.inputs[i] << endl ;

  if ( args_info.funct_opt_given )
    cout << "You chose --funct-opt or -F." << endl ;

  if ( args_info.str_opt_given )
    cout << "You inserted " << args_info.str_opt_arg << " for " <<
      "--str-opt option." << endl ;

  if ( args_info.int_opt_given )
    cout << "This is the integer you input: " << 
      args_info.int_opt_arg << "." << endl;

  if (args_info.flag_opt_given)
    cout << "The flag option was given!" << endl;

  cout << "The flag is " << ( args_info.flag_opt_flag ? "on" : "off" ) <<
    "." << endl ;

  cout << args_info.def_opt_arg << "! ";

  cout << "Have a nice day! :-)" << endl ;

  cmdline_parser_free (&args_info); /* release allocated memory */

  return 0;
}

gcc -c cmdline1.c
g++ -c main1.cc
g++ -o sample1 cmdline1.o main1.o

$ ./sample1 -s "hello" --int-opt 1234
This one is from a C++ program
Try to launch me with some options
(type sample1 --help for the complete list)
For example: ./sample1 *.* --funct-opt
Here are the options you passed...
You inserted hello for --str-opt option.
This is the integer you input: 1234.
The flag is off.
Have a nice day! :-)

$ ./sample1 *.h -i -100 -x
This one is from a C++ program
Try to launch me with some options
(type sample1 --help for the complete list)
For example: ./sample1 *.* --funct-opt
Here are the options you passed...
file: cmdline1.h
file: cmdline2.h
file: cmdline.h
file: getopt.h
This is the integer you input: -100.
The flag is on.
Have a nice day! :-)

$ ./sample1
This one is from a C++ program
Try to launch me with some options
(type sample1 --help for the complete list)
For example: ./sample1 *.* --funct-opt
sample1: `--int-opt' (`-i') option required!

sample1 2.0

Usage: sample1 -iINT|--int-opt=INT [-h|--help] [-V|--version] 
         -sfilename|--str-opt=filename -mINT|--my-opt=INT [--flag-opt] 
         [-F|--funct-opt] --long-opt=LONG --def-opt=STRING  [FILES]...

  -h, --help              Print help and exit
  -V, --version           Print version and exit
  -s, --str-opt=filename  A string option, for a filename
  -m, --my-opt=INT        Another integer option, this time the description of
                            the option should be quite long to require
                            wrapping... possibly more than one wrapping :-)
                            especially if I
                            require a line break
  -i, --int-opt=INT       A int option

more involved options:
the following options
are more complex
      --flag-opt          A flag option  (default=off)
  -F, --funct-opt         A function option

last option section:
      --long-opt=LONG     A long option
      --def-opt=STRING    A string option with default  (default=`Hello')
      --enum-opt=STRING   A string option with list of values  (possible
                            values="foo", "bar", "hello" default=`hello')