Switch branches/tags
Nothing to show
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
71 lines (55 sloc) 2.87 KB
// -----------------------------------------------------------------------------
// A simple application demonstrating the library in action.
// -----------------------------------------------------------------------------
#include <stdlib.h>
#include <stdio.h>
#include "janus.h"
// Callback function for the 'foo' command. The function receives a pointer
// to an ArgParser instance containing the command's parsed arguments. Here
// we simply dump the parser to stdout.
void callback(ArgParser *parser) {
puts("---------- callback ----------");
// This sample application will parse its own command-line arguments.
int main(int argc, char **argv) {
// We instantiate an argument parser, optionally supplying help text and
// a version string. Supplying help text activates an automatic --help
// flag, supplying a version string activates an automatic --version
// flag. We can pass NULL for either parameter.
ArgParser *parser = ap_new("Help!", "Version 1.2.3");
// Register a flag, --bool, with a single-character alias, -b. A flag is a
// boolean option - it's either present (true) or absent (false).
ap_new_flag(parser, "bool b");
// Register a string option, --string <arg>, with a single-character
// alias, -s <arg>, and fallback value "foobar".
ap_new_str(parser, "string s", "foobar");
// Register an integer option, --int <arg>, with a single-character alias,
// -i <arg>, and fallback value 123.
ap_new_int(parser, "int i", 123);
// Register a floating-point option, --double <arg>, with a single-
// character alias, -d <arg>, and fallback value 1.0.
ap_new_double(parser, "double d", 1.0);
// Register a command 'foo'. We need to supply the command's help text and
// callback function.
ArgParser *cmd = ap_new_cmd(parser, "foo", "Foo!", callback);
// Registering a command returns a new ArgParser instance dedicated to
// parsing the command's arguments. We can register as many flags and
// options as we like on this sub-parser. Note that the sub-parser can
// reuse the parent's option names without interference.
ap_new_flag(cmd, "bool b");
ap_new_int(cmd, "int i", 456);
// Once all our options and commands have been registered we can call the
// ap_parse() function with an array of argument strings. (Note that we
// only need to call ap_parse() on the root parser - command arguments
// are parsed automatically.)
ap_parse(parser, argc, argv);
// We can now retrieve our option and argument values from the parser
// instance. Here we simply dump the parser to stdout.
// We can call ap_free() to free the memory occupied by the parser
// instance. This will automatically free the memory occupied by
// any associated command parsers.