cpp-cmdline's Introduction

An easy way to analyse command line in C++.

This is a simple library for C++ to analyse command line.
This library only depends on STL.

Compiler Support

MSVC-2015
g++-4.9.2(-std=c++1y)
clang-3.4(-std=c++1y)

License

Codes covered by the MIT License.

Tutorial

For using it, you only need to include cmdline.hpp.

Simple usage:

#include "cmdline.hpp"

int main(int argc, char* argv[])
{
    cmdline::parser a;
    a.push({
        {
            "-h",                                   // short name
            "--help",                               // long name
            "Print usage.",                         // description
            false,                                  // is necessary or not
            "",                                     // default value
            [&a](auto&) { a.print_usage(); } // handle for doing something
        },
        {
            "-t", "--test", "You must use this option.", true, "", 
            [](auto&) { /*Do Nothing.*/ }
        },
        {
            "-o", "--output", "Print text.", true, "Hello World!",
            [](auto& str) {
                std::cout << str << std::endl;
            }
        }
    });
    a.exec(argc, argv);
    return 0;
}

And there are the execution results:

$ ./ut
Usage: ut --test --output=Hello World! [OPTIONS]...
Options: 
  -t, --test	You must use this option.
  -o, --output	Print text.[=Hello World!]
  -h, --help	Print usage.

$ ./ut -h
Usage: ut --test --output=Hello World! [OPTIONS]...
Options: 
  -t, --test	You must use this option.
  -o, --output	Print text.[=Hello World!]
  -h, --help	Print usage.

$ ./ut -o=fdagdag
Usage: ut --test --output=Hello World! [OPTIONS]...
Options: 
  -t, --test	You must use this option.
  -o, --output	Print text.[=Hello World!]
  -h, --help	Print usage.