1 // Arg_parser - A POSIX/GNU command line argument parser.
2 // Copyright (C) 2006, 2007, 2008, 2009, 2010 Antonio Diaz Diaz.
3 // Copyright (C) 2008, 2009, 2010, 2011, 2012 Free Software Foundation, Inc.
5 // This program is free software: you can redistribute it and/or modify
6 // it under the terms of the GNU General Public License as published by
7 // the Free Software Foundation, either version 3 of the License, or
8 // (at your option) any later version.
10 // This program is distributed in the hope that it will be useful,
11 // but WITHOUT ANY WARRANTY; without even the implied warranty of
12 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 // GNU General Public License for more details.
15 // You should have received a copy of the GNU General Public License
16 // along with this program. If not, see <http://www.gnu.org/licenses/>.
19 // Arg_parser reads the arguments in `argv' and creates a number of
20 // option codes, option arguments and non-option arguments.
22 // In case of error, `error' returns a non-empty error message.
24 // `options' is an array of `struct Option' terminated by an element
25 // containing a code which is zero. A null name means a short-only
26 // option. A code value outside the unsigned char range means a
29 // Arg_parser normally makes it appear as if all the option arguments
30 // were specified before all the non-option arguments for the purposes
31 // of parsing, even if the user of your program intermixed option and
32 // non-option arguments. If you want the arguments in the exact order
33 // the user typed them, call `Arg_parser' with `in_order' = true.
35 // The argument `--' terminates all options; any following arguments are
36 // treated as non-option arguments, even if they begin with a hyphen.
38 // The syntax for optional option arguments is `-<short_option><argument>'
39 // (without whitespace), or `--<long_option>=<argument>'.
41 // This class has been modified with a templated parser.argument<>
42 // method, allowing typesafe handling of different return types, and
43 // saving using strto* on the user side. I've added an exception class
44 // because I'd like to know if we call an argument outside the range
45 // of argument - there's no reasonable situation in which that would
56 enum Has_arg
{ no
, yes
, maybe
};
60 int code
; // Short option letter or code ( code != 0 )
61 const char * name
; // Long option name (maybe null)
65 class ArgParserException
: public std::exception
68 ArgParserException(std::string s
)
73 virtual ~ArgParserException() throw() {}
75 const char* what() const throw() { return _msg
.c_str(); }
87 Record( const int c
= 0 ) : code( c
) {}
91 std::vector
< Record
> data
;
93 bool parse_long_option( const char * const opt
, const char * const arg
,
94 const Option options
[], int & argind
) throw();
95 bool parse_short_option( const char * const opt
, const char * const arg
,
96 const Option options
[], int & argind
) throw();
99 DSOEXPORT
Arg_parser( const int argc
, const char * const argv
[],
100 const Option options
[], const bool in_order
= false ) throw();
102 // Restricted constructor. Parses a single token and argument (if any)
103 DSOEXPORT
Arg_parser( const char * const opt
, const char * const arg
,
104 const Option options
[] ) throw();
106 const std::string
& error() const throw() { return _error
; }
108 // The number of arguments parsed (may be different from argc)
109 int arguments() const throw() { return data
.size(); }
111 // If code( i ) is 0, argument( i ) is a non-option.
112 // Else argument( i ) is the option's argument (or empty).
113 int code( const int i
) const throw()
115 if( i
>= 0 && i
< arguments() ) return data
[i
].code
;
119 std::string
argument(const int i
) const throw(ArgParserException
)
121 if( i
>= 0 && i
< arguments() ) return data
[i
].argument
;
126 T
argument(const int i
) const throw (ArgParserException
)
129 if( i
>= 0 && i
< arguments() )
131 std::istringstream
in(data
[i
].argument
);
135 else throw ArgParserException("Code out of range");
142 // indent-tabs-mode: t