Boost C++ 库

……世界上最受推崇、设计最精湛的 C++ 库项目之一。 — Herb Sutter 和 Andrei Alexandrescu, C++ Coding Standards

类 positional_options_description - Boost C++ 函数库

类 positional_options_description

boost::program_options::positional_options_description

提要

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


class positional_options_description {
public:

  // public member functions
  positional_options_description();
  positional_options_description & add(const char *, int);
  unsigned max_total_count() const;
  const std::string & name_for_position(unsigned) const;
};

描述

描述位置选项。

该类允许猜测位置选项的选项名称，这些选项在命令行中指定，并按位置标识。该类使用用户提供的信息将名称与每个位置选项关联起来，或告知没有已知名称。

主要假设是只有位置选项本身的相对顺序很重要，并且任何交叉插入的普通选项都不会影响对位置选项的解释。

用户通过指定前 N 个位置选项应命名为 X1，接下来的 M 个选项应命名为 X2，依此类推来初始化该类。

`positional_options_description` 公共成员函数

```
positional_options_description();
```
```
positional_options_description & add(const char * name, int max_count);
```
指定最多 'max_count' 个后续位置选项应命名为 'name'。值 '-1' 表示 '无限'。在调用 'max_value' 为 '-1' 之后，不能再调用 'add'。
```
unsigned max_total_count() const;
```
返回可以存在的位置选项的最大数量。可以返回 (numeric_limits<unsigned>::max)() 来表示无限数量。
```
const std::string & name_for_position(unsigned position) const;
```
返回应与 'position' 位置处的选项关联的名称。先决条件：position < max_total_count()