File: README.md

package info (click to toggle)
dolphin-emu 2512%2Bdfsg-2
  • links: PTS, VCS
  • area: main
  • in suites: sid
  • size: 76,328 kB
  • sloc: cpp: 499,023; ansic: 119,674; python: 6,547; sh: 2,338; makefile: 1,093; asm: 726; pascal: 257; javascript: 183; perl: 97; objc: 75; xml: 30
file content (53 lines) | stat: -rw-r--r-- 1,676 bytes parent folder | download
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;
```