boost :: program_optionsを使用すると、引数の名前はどのように設定されますか？

Question

boost::program_optionsを使用している場合、boost::program_options::value<>()の引数の名前を設定するにはどうすればよいですか？

#include <iostream> 
#include <boost/program_options.hpp> 

int main() 
{ 
    boost::program_options::options_description desc; 

    desc.add_options() 
    ("width", boost::program_options::value<int>(), 
    "Give width"); 

    std::cout << desc << std::endl; 

    return 0; 
} 

上記のコードは与える：

--width arg   Give width 

私が欲しいものNUMのようなより説明的なものでarg名前を置き換えることです：

--width NUM   Give width 

Answer 1

最近のバージョンのBoost > = 1.61）これは完全にサポートされています。「LEVEL」の代わりに「引数」と印刷されてチュートリアル、最初の例の若干の変更を下回る：

po::options_description desc("Allowed options"); 
desc.add_options() 
    ("help", "produce help message") 
    ("compression", po::value<int>()->value_name("LEVEL"), "set compression level") 
; 

Live Example

Answer 2

一つが何か違う経由でargを置き換えることができますグローバル変数 boost::program_options::arg：

boost::program_options::arg = "NUM"; 

しかし、グローバル変数であるため、複数のオプションが異なる引数を必要とする場合は、問題を解決するのに役立ちません。

Answer 3

クラスは引数名をパラメータ化しないため、独自のクラスを定義する必要があります。このような何かを：

--witdh foo give width 

Answer 4

Codebenderによって与えられたアプローチは、使用できる唯一のものです：

struct my_arg_type 
    : public boost::program_options::typed_value<int> 
{ 
    my_arg_type(std::string const& name) 
     : boost::program_options::typed_value<int>(&my_value) 
     , my_name(name) 
     , my_value(0) 
    { 
    } 
    std::string name() const { return my_name; } 
    std::string my_name; 
    int my_value; 
}; 

boost::program_options::options_description desc; 

my_arg_type arg("foo"); 
desc.add_options() 
    ("width", &arg, "give width"); 

このような何かを与える必要があります。これは実際には意図的です。引数の名前に「NUM」を使用することは、価値がないマイクロ最適化のようです。オプションの良い説明はまた、どんな種類の議論が期待されるかを述べるべきです。

Answer 5

現在のバージョンのboost（1.53）では、Tim Sylvesterが提案したように独自のクラスを作る必要はありません。 boost :: program_options :: typed_valueを使うことができます。どのvalue_nameを設定できるか。

#include <iostream> 
#include <boost/program_options.hpp> 
using boost::program_options::typed_value; 
using boost::program_options::options_description; 

int main(int argc, char **argv) { 
    options_description desc("Usage"); 

    int someValue; 
    auto someOption = new typed_value<decltype(someValue)>(&someValue); 
    someOption->value_name("NUM"); 
    desc.add_options() 
     ("some-option,s", someOption, "The option\n"); 

    std::cout << desc << std::endl; 
    return 0; 
} 

が設定され、引数名が表示されます：

Usage: 
-s [ --some-option ] NUM The option 

Answer 6

daminetreg's answer作品を、しかし、オプション項目の多くのために使用された場合、それは少し冗長にすることができます。

template<class T> 
typed_value<T>* 
value(T* v, const char * value_typename) 
{ 
    typed_value<T>* r = new typed_value<T>(v); 
    r->value_name(value_typename); 

    return r;   
} 

を使用して、あなたがこのような新しいprogram_option作成して追加することができます：

int width; 
desc.add_options() 
    ("width", boost::program_options::value<int>(&width, "NUM"), 
    "Give width"); 

（注：私はちょうどvalue<T>(T* v)テンプレートのオーバーロードが追加value_nameと私のvalue_sematic Sを構築するために一緒にハッキング、これをOPが使用したいデフォルトのvalue()コンストラクタではありません）。