blob: d9452fcd0786be5d815acd2ddde65e80327855b2 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
|
# cpp-optparse
This is yet another option parser for C++. It is modelled after the excellent
Python optparse API. Although incomplete, anyone familiar to
[optparse](http://docs.python.org/library/optparse.html) should feel at home.
- Copyright (c) 2010 Johannes Weißl
- License: MIT License
## Design decisions
- Elegant and easy usage more important than speed / flexibility
- Small size more important than feature completeness, e.g.:
* No unicode
* No checking for user programming errors
* No conflict handlers
* No adding of new actions
## FAQ
- Why not use getopt/getopt_long?
* Not C++ / not completely POSIX
* Too cumbersome to use, would need lot of additional code
- Why not use Boost.Program_options?
* Boost not installed on all target platforms (esp. cluster, HPC, ...)
* Too big to include just for option handling for many projects:
322 *.h (44750 lines) + 7 *.cpp (2078 lines)
- Why not use tclap/Opag/Options/CmdLine/Anyoption/Argument_helper/...?
* Similarity to Python desired for faster learning curve
## Future work
- Support nargs > 1?
## Example
```cpp
using optparse::OptionParser;
OptionParser parser = OptionParser() .description("just an example");
parser.add_option("-f", "--file") .dest("filename")
.help("write report to FILE") .metavar("FILE");
parser.add_option("-q", "--quiet")
.action("store_false") .dest("verbose") .set_default("1")
.help("don't print status messages to stdout");
optparse::Values options = parser.parse_args(argc, argv);
vector<string> args = parser.args();
if (options.get("verbose"))
cout << options["filename"] << endl;
```
|
