Я хотел бы передать параметры моей программе на С++ следующим образом:
./myprog --setting=value
Существуют ли библиотеки, которые помогут мне сделать это легко?
Я хотел бы передать параметры моей программе на С++ следующим образом:
./myprog --setting=value
Существуют ли библиотеки, которые помогут мне сделать это легко?
GNU GetOpt.
Простой пример с использованием GetOpt:
// C/C++ Libraries:
#include <string>
#include <iostream>
#include <unistd.h>
// Namespaces:
using namespace std;
int main(int argc, char** argv) {
int opt;
bool flagA = false;
bool flagB = false;
// Shut GetOpt error messages down (return '?'):
opterr = 0;
// Retrieve the options:
while ( (opt = getopt(argc, argv, "ab")) != -1 ) { // for each option...
switch ( opt ) {
case 'a':
flagA = true;
break;
case 'b':
flagB = true;
break;
case '?': // unknown option...
cerr << "Unknown option: '" << char(optopt) << "'!" << endl;
break;
}
}
// Debug:
cout << "flagA = " << flagA << endl;
cout << "flagB = " << flagB << endl;
return 0;
}
Вы также можете использовать optarg, если у вас есть параметры, которые принимают аргументы.
TCLAP
- действительно приятный легкий дизайн и прост в использовании:
http://tclap.sourceforge.net/
Мне легче использовать ezOptionParser. Это также один заголовочный файл, не зависящий ни от чего, кроме STL, работает для Windows и Linux (скорее всего, другие платформы тоже), не имеет кривых обучения благодаря примерам, имеет функции, которые другие библиотеки не имеют (например, импорт/экспорт файлов с комментариями, произвольными именами опций с разделителями, форматированием автоматического использования и т.д.) и лицензируется LGPL.
И там есть Google library.
Действительно, разбор командной строки "разрешен". Просто выберите один.
В библиотеке GNU C есть эти инструменты, которые включают GetOpt.
Если вы используете Qt и как интерфейс GetOpt, froglogic опубликовал приятный интерфейс .
Я думаю, что GNU GetOpt не слишком быстро используется.
QT и Boost могут быть решением, но вам нужно загрузить и скомпилировать много кода.
Итак, я сам реализовал парсер, создающий std:: map параметров.
Например, вызывая:
./myProgram -v -p 1234
Картой будет:
["-v"][""]
["-p"]["1234"]
Использование:
int main(int argc, char *argv[]) {
MainOptions mo(argc, argv);
MainOptions::Option* opt = mo.getParamFromKey("-p");
const string type = opt ? (*opt).second : "";
cout << type << endl; /* print 1234 */
/* your check code */
}
MainOptions.h
#ifndef MAINOPTIONS_H_
#define MAINOPTIONS_H_
#include <map>
#include <string>
class MainOptions {
public:
typedef std::pair<std::string, std::string> Option;
MainOptions(int argc, char *argv[]);
virtual ~MainOptions();
std::string getAppName() const;
bool hasKey(const std::string&) const;
Option* getParamFromKey(const std::string&) const;
void printOptions() const;
private:
typedef std::map<std::string, std::string> Options;
void parse();
const char* const *begin() const;
const char* const *end() const;
const char* const *last() const;
Options options_;
int argc_;
char** argv_;
std::string appName_;
};
MainOptions.cpp
#include "MainOptions.h"
#include <iostream>
using namespace std;
MainOptions::MainOptions(int argc, char* argv[]) :
argc_(argc),
argv_(argv) {
appName_ = argv_[0];
this->parse();
}
MainOptions::~MainOptions() {
}
std::string MainOptions::getAppName() const {
return appName_;
}
void MainOptions::parse() {
typedef pair<string, string> Option;
Option* option = new pair<string, string>();
for (const char* const * i = this->begin() + 1; i != this->end(); i++) {
const string p = *i;
if (option->first == "" && p[0] == '-') {
option->first = p;
if (i == this->last()) {
options_.insert(Option(option->first, option->second));
}
continue;
} else if (option->first != "" && p[0] == '-') {
option->second = "null"; /* or leave empty? */
options_.insert(Option(option->first, option->second));
option->first = p;
option->second = "";
if (i == this->last()) {
options_.insert(Option(option->first, option->second));
}
continue;
} else if (option->first != "") {
option->second = p;
options_.insert(Option(option->first, option->second));
option->first = "";
option->second = "";
continue;
}
}
}
void MainOptions::printOptions() const {
std::map<std::string, std::string>::const_iterator m = options_.begin();
int i = 0;
if (options_.empty()) {
cout << "No parameters\n";
}
for (; m != options_.end(); m++, ++i) {
cout << "Parameter [" << i << "] [" << (*m).first << " " << (*m).second
<< "]\n";
}
}
const char* const *MainOptions::begin() const {
return argv_;
}
const char* const *MainOptions::end() const {
return argv_ + argc_;
}
const char* const *MainOptions::last() const {
return argv_ + argc_ - 1;
}
bool MainOptions::hasKey(const std::string& key) const {
return options_.find(key) != options_.end();
}
MainOptions::Option* MainOptions::getParamFromKey(
const std::string& key) const {
const Options::const_iterator i = options_.find(key);
MainOptions::Option* o = 0;
if (i != options_.end()) {
o = new MainOptions::Option((*i).first, (*i).second);
}
return o;
}
Если я могу использовать собственный рожок, я также хотел бы предложить взглянуть на библиотеку анализа параметров, которую я написал: dropt.
Одна из возможностей, которую он предлагает, что многие другие не поддерживают переопределение предыдущих параметров. Например, если у вас есть псевдоним оболочки:
alias bar="foo --flag1 --flag2 --flag3"
и вы хотите использовать bar
, но с --flag1
отключено, это позволяет:
bar --flag1=0
argstream
очень похож на boost.program_option
: он позволяет связывать переменные с параметрами и т.д. Однако он не обрабатывает параметры хранится в файле конфигурации.
Попробуйте библиотеку CLPP. Это простая и гибкая библиотека для синтаксического анализа параметров командной строки. Только для заголовков и кросс-платформенных. Использует только библиотеки ISO С++ и Boost С++. ИМХО это проще, чем Boost.Program_options.
Библиотека: http://sourceforge.net/projects/clp-parser/
26 октября 2010 г. - новый выпуск 2.0rc. Исправлено множество ошибок, исправлен полный рефакторинг исходного кода, документация, примеры и комментарии.
Qt 5.2 поставляется с API-интерфейсом командной строки.
Небольшой пример:
#include <QCoreApplication>
#include <QCommandLineParser>
#include <QDebug>
int main(int argc, char **argv)
{
QCoreApplication app(argc, argv);
app.setApplicationName("ToolX");
app.setApplicationVersion("1.2");
QCommandLineParser parser;
parser.setApplicationDescription("Tool for doing X.");
parser.addHelpOption();
parser.addVersionOption();
parser.addPositionalArgument("infile",
QCoreApplication::translate("main", "Input file."));
QCommandLineOption verbose_opt("+",
QCoreApplication::translate("main", "be verbose"));
parser.addOption(verbose_opt);
QCommandLineOption out_opt(QStringList() << "o" << "output",
QCoreApplication::translate("main", "Output file."),
QCoreApplication::translate("main", "filename"), // value name
QCoreApplication::translate("main", "out") // default value
);
parser.addOption(out_opt);
// exits on error
parser.process(app);
const QStringList args = parser.positionalArguments();
qDebug() << "Input files: " << args
<< ", verbose: " << parser.isSet(verbose_opt)
<< ", output: " << parser.value(out_opt)
<< '\n';
return 0;
}
Автоматически созданный экран справки:
$ ./qtopt -h Usage: ./qtopt [options] infile Tool for doing X. Options: -h, --help Displays this help. -v, --version Displays version information. -+ be verbose -o, --output Output file. Arguments: infile Input file.
Автоматически сгенерированный вывод версии:
$ ./qtopt -v ToolX 1.2
Некоторые реальные вызовы:
$ ./qtopt b1 -+ -o tmp blah.foo Input files: ("b1", "blah.foo") , verbose: true , output: "tmp" $ ./qtopt Input files: () , verbose: false , output: "out"
Ошибка синтаксического анализа:
$ ./qtopt --hlp Unknown option 'hlp'. $ echo $? 1
Если ваша программа уже использует библиотеки Qt ( >= 5.2), ее интерфейс анализа синтаксиса командной строки достаточно удобен, чтобы выполнить задание.
Помните, что встроенные Qt-параметры потребляются QApplication
до запуска парсера параметров.
Вы можете попробовать мой маленький вариант header (166 loc, так легко взломаемый) options.hpp. Это единая реализация заголовка и должна делать то, что вы просите. Он также автоматически распечатывает вашу страницу справки.
Есть пары парсеров аргументов С++, вы можете попробовать это из http://clp.sourceforge.net/, очень просто и удобно.