nlib
misc/nflags/nflags.cpp

This demonstrates a simple way to build a command-line parser using nn::nlib::Nflags.

Using the Nflags class enable you to use the command-line argument settings as C++ variables. Because those variables can be defined scattered around in the program, this capability enhances the modularity of command-line programs.

/*--------------------------------------------------------------------------------*
Project: CrossRoad
Copyright (C)Nintendo All rights reserved.
These coded instructions, statements, and computer programs contain proprietary
information of Nintendo and/or its licensed developers and are protected by
national and international copyright laws. They may not be disclosed to third
parties or copied or duplicated in any form, in whole or in part, without the
prior written consent of Nintendo.
The content herein is highly confidential and should be handled accordingly.
*--------------------------------------------------------------------------------*/
#include "nn/nlib/Nflags.h"
//
// nlib_ns::Nflags is a helper class for developing command line tools.
// you can implement command line options easily with Nflags
//
NLIB_FLAGS_DEFINE_bool(boolswitch, false, "My boolean switch");
NLIB_FLAGS_DEFINE_int32(int32switch, 0, "My int switch");
NLIB_FLAGS_DEFINE_string(stringswitch, "", "My string switch");
char* g_argvbuf[128] = {NULL};
int g_argc;
char** g_argv = &g_argvbuf[0];
bool NflagsSampleHelp() {
char args[2][128] = {"mycommand", "--help"};
g_argv[0] = args[0];
g_argv[1] = args[1];
g_argc = 2;
nlib_printf("\nParsing 'mycommand --help'\n");
errno_t e = Nflags::Parse(&g_argc, &g_argv);
if (nlib_is_error(e)) {
nlib_printf("PARSE ERROR\n");
return false;
}
// you can access xxxxx by NLIB_FLAGS_xxxxx
// NLIB_FLAGS_help is predefined
if (NLIB_FLAGS_help) {
// --help
Nflags::PrintHelp();
}
return true;
}
bool NflagsSampleCommand() {
char args[6][128] = {"mycommand", "--boolswitch", "--int32switch=12345",
"--stringswitch=Phi,Beta,Kappa", "--", "filename"};
g_argv[0] = args[0];
g_argv[1] = args[1];
g_argv[2] = args[2];
g_argv[3] = args[3];
g_argv[4] = args[4];
g_argv[5] = args[5];
g_argc = 6;
"\nParsing 'mycommand "
"--boolswitch "
"--int32switch=12345 "
"--stringswitch=Phi,Beta,Kappa "
"-- filename"
"'\n");
errno_t e = Nflags::Parse(&g_argc, &g_argv);
if (nlib_is_error(e)) {
nlib_printf("PARSE ERROR\n");
return false;
}
// you can access the variable, which is defined by NLIB_FLAGS_DEFINE_xxxx(yyyy, ...),
// by NLIB_FLAGS_yyyy.
// if compilation unit is different,
// you declare NLIB_FLAGS_DECLARE_xxxx(yyyy), and you can use NLIB_FLAGS_yyyy.
nlib_printf("boolswitch: %s\n", NLIB_FLAGS_boolswitch ? "true" : "false");
nlib_printf("int32switch: %d\n", NLIB_FLAGS_int32switch);
nlib_printf("stringswitch: %s\n", NLIB_FLAGS_stringswitch);
// a string list with comma can be splitted by Nflags::GetStringCommaList()
// the arguments which became the options are removed from argv, argc.
// you can use the rest of them without Nflags
nlib_printf("g_argc after parsing: %d\n", g_argc);
for (int i = 0; i < g_argc; ++i) {
nlib_printf("g_argv[%d] = '%s'\n", i, g_argv[i]);
}
return true;
}
bool SampleMain(int, char**) { return NflagsSampleHelp() && NflagsSampleCommand(); }
NLIB_MAINFUNC