fltk/examples/howto-parse-args.cxx

107 lines
3.4 KiB
C++

//
// How to parse command line arguments - Duncan Gibson 2010-10-23
//
// First posted in https://www.fltk.org/newsgroups.php?gfltk.general+v:22493
// in thread "fltk-1.x : parsing command line arguments"
//
// Shows how to decode additional command line arguments using Fl::args()
// on top of the "standard" options used by the toolkit itself.
//
// Note that this only handles "option separateValue" rather than the
// usual *nix idiom of "option=value", and provides no validation nor
// conversion of the parameter string into ints or floats.
//
// Example 1:
//
// ./howto-parse-args -ti "FLTK is great" -o "FLTK is a great GUI tool"
//
// Example 2: translated to Japanese and simplified Chinese, respectively,
// by a well known internet translation service.
//
// ./howto-parse-args -ti "FLTKは素晴らしいです" -o "FLTK 是一个很棒的 GUI 工具"
//
// Copyright 1998-2023 by Bill Spitzak and others.
//
// This library is free software. Distribution and use rights are outlined in
// the file "COPYING" which should have been included with this file. If this
// file is missing or damaged, see the license at:
//
// https://www.fltk.org/COPYING.php
//
// Please see the following page on how to report bugs and issues:
//
// https://www.fltk.org/bugs.php
//
#include <stdio.h>
#include <string.h>
#include <FL/Fl.H>
#include <FL/Fl_Box.H>
#include <FL/Fl_Window.H>
int helpFlag = 0;
char *optionString = 0;
/*
* callback function passed to Fl::args() to parse individual argument.
* If there is a match, 'i' must be incremented by 2 or 1 as appropriate.
* If there is no match, Fl::args() will then call Fl::arg() as fallback
* to try to match the "standard" FLTK parameters.
*
* Returns 2 if argv[i] matches with required parameter in argv[i+1],
* returns 1 if argv[i] matches on its own,
* returns 0 if argv[i] does not match.
*/
int arg(int argc, char **argv, int &i) {
if (strcmp("-h", argv[i]) == 0 || strcmp("--help", argv[i]) == 0) {
helpFlag = 1;
i += 1;
return 1;
}
if (strcmp("-o", argv[i]) == 0 || strcmp("--option", argv[i]) == 0) {
if (i < argc-1 && argv[i+1] != 0) {
optionString = argv[i+1];
i += 2;
return 2;
}
}
return 0;
}
int main(int argc, char** argv) {
// Convert commandline arguments in 'argv' to UTF-8 on Windows.
// This is a no-op on all other platforms (see documentation).
Fl::args_to_utf8(argc, argv);
int i = 1;
if (Fl::args(argc, argv, i, arg) < argc)
// note the concatenated strings to give a single format string!
Fl::fatal("error: unknown option: %s\n"
"usage: %s [options]\n"
" -h | --help : print extended help message\n"
" -o | --option # : example option with parameter\n"
" plus standard fltk options\n",
argv[i], argv[0]);
if (helpFlag)
Fl::fatal("usage: %s [options]\n"
" -h | --help : print extended help message\n"
" -o | --option # : example option with parameter\n"
" plus standard fltk options:\n"
"%s\n",
argv[0], Fl::help);
Fl_Window* mainWin = new Fl_Window(300, 200);
Fl_Box* textBox = new Fl_Box(0, 0, 300, 200);
if (optionString != 0)
textBox->label(optionString);
else
textBox->label("re-run with [-o|--option] text");
mainWin->resizable(mainWin);
mainWin->show(argc, argv);
return Fl::run();
}