Boost C++ 库

...世界上最受尊敬、设计最专业的 C++ 库项目之一。 Herb SutterAndrei Alexandrescu, C++ Coding Standards

Class options_description - Boost C++ 函数库
PrevUpHomeNext

Class options_description

boost::program_options::options_description

提要

// In header: <boost/program_options/options_description.hpp>


class options_description {
public:

  // public member functions
  options_description(unsigned = m_default_line_length, 
                      unsigned = m_default_line_length/2);
  options_description(const std::string &, unsigned = m_default_line_length, 
                      unsigned = m_default_line_length/2);
  void add(shared_ptr< option_description >);
  options_description & add(const options_description &);
  unsigned get_option_column_width() const;
  options_description_easy_init add_options();
  const option_description & 
  find(const std::string &, bool, bool = false, bool = false) const;
  const option_description * 
  find_nothrow(const std::string &, bool, bool = false, bool = false) const;
  const std::vector< shared_ptr< option_description > > & options() const;
  void print(std::ostream &, unsigned = 0) const;

  // friend functions
  BOOST_PROGRAM_OPTIONS_DECL std::ostream & 
  operator<<(std::ostream &, const options_description &);

  // public data members
  static const unsigned m_default_line_length;
};

描述

一组选项描述。它提供了添加新选项(add_options 方法)的便捷接口,以及按名称搜索选项的功能。

有关选项添加接口的讨论,请参阅此处。

另请参阅: option_description

options_description 公共成员函数

  1. options_description(unsigned line_length = m_default_line_length, 
                        unsigned min_description_length = m_default_line_length/2);

    创建实例。

  2. options_description(const std::string & caption, 
                        unsigned line_length = m_default_line_length, 
                        unsigned min_description_length = m_default_line_length/2);

    创建实例。“caption”参数为该 `options_description` 实例命名。主要用于输出。“description_length”指定应为描述文本保留的列数;如果选项文本侵占到此范围,则描述将从下一行开始。

  3. void add(shared_ptr< option_description > desc);

    添加新的变量描述。如果短名称或长名称与已存在的变量匹配,则抛出 duplicate_variable_error。

  4. options_description & add(const options_description & desc);

    添加一组选项描述。其效果与单独添加“desc”中的所有 `option_descriptions` 相同,不同之处在于输出运算符将显示一个单独的组。返回 *this。

  5. unsigned get_option_column_width() const;

    查找选项列的最大宽度,包括组中的选项。

  6. options_description_easy_init add_options();

    返回一个实现定义的类型对象,适用于将选项添加到 `options_description`。返回的对象将具有重载的 operator(),其参数类型与 `option_description` 构造函数匹配。调用该运算符将创建一个新的 `option_description` 实例并将其添加。

  7. const option_description & 
    find(const std::string & name, bool approx, bool long_ignore_case = false, 
         bool short_ignore_case = false) const;
  8. const option_description * 
    find_nothrow(const std::string & name, bool approx, 
                 bool long_ignore_case = false, bool short_ignore_case = false) const;
  9. const std::vector< shared_ptr< option_description > > & options() const;
  10. void print(std::ostream & os, unsigned width = 0) const;

    将“desc”输出到指定的流,调用“f”来输出每个 `option_description` 元素。

options_description 友元函数

  1. BOOST_PROGRAM_OPTIONS_DECL std::ostream & 
    operator<<(std::ostream & os, const options_description & desc);

    生成“desc”的可读输出,列出选项、它们的描述和允许的参数。之前传递给 add 的其他 `options_description` 实例将单独输出。


PrevUpHomeNext