Синтаксическая информация предоставляется классом<boost::program_options::options_description>и некоторыми методами класса<boost::program_options::value_semantic>и включает:

Рассмотрим следующий пример:

options_description desc;
desc.add_options()
    ("help", "produce help message")
    ("compression", value<string>(), "compression level")
    ("verbose", value<string>()->implicit_value("0"), "verbosity level")
    ("email", value<string>()->multitoken(), "email to send to")
    ;
      

Для первого параметра мы указываем только название и описание. Никакое значение не может быть указано в парсируемом источнике. Для первого варианта пользователь должен указать значение, используя один токен. Для третьего варианта пользователь может либо предоставить один токен для значения, либо вообще не предоставлять токен. Для последнего варианта значение может охватывать несколько токенов. Например, следующая командная строка ОК:

          test --help --compression 10 --verbose --email beadle@mars beadle2@mars
      

options.add_options()
    ("help", "   A long help msg a long help msg a long help msg a long help
msg a long help msg a long help msg a long help msg a long help msg ")
    ;
        

  --help                    A long help msg a long
                        help msg a long help msg
                        a long help msg a long
                        help msg a long help msg
                        a long help msg a long
                        help msg
        

options.add_options()
      ("well_formated", "As you can see this is a very well formatted
option description.\n"
                        "You can do this for example:\n\n"
                        "Values:\n"
                        "  Value1: \tdoes this and that, bla bla bla bla
bla bla bla bla bla bla bla bla bla bla bla\n"
                        "  Value2: \tdoes something else, bla bla bla bla
bla bla bla bla bla bla bla bla bla bla bla\n\n"
                        "    This paragraph has a first line indent only,
bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla");
        

  --well_formated       As you can see this is a
                        very well formatted
                        option description.
                        You can do this for
                        example:
                        Values:
                          Value1: does this and
                                  that, bla bla
                                  bla bla bla bla
                                  bla bla bla bla
                                  bla bla bla bla
                                  bla
                          Value2: does something
                                  else, bla bla
                                  bla bla bla bla
                                  bla bla bla bla
                                  bla bla bla bla
                                  bla
                            This paragraph has a
                        first line indent only,
                        bla bla bla bla bla bla
                        bla bla bla bla bla bla
                        bla bla bla
        

Семантическая информация полностью предоставлена классом<boost::program_options::value_semantic>. Например:

options_description desc;
desc.add_options()
    ("compression", value<int>()->default_value(10), "compression level")
    ("email", value< vector<string> >()
        ->composing()->notifier(&your_function), "email")
    ;

В этих декларациях указывается, что значение по умолчанию первого варианта составляет 10, что второй вариант может появиться несколько раз и все экземпляры должны быть объединены, и что после проведения разбора библиотека вызовет функцию<&your_function>, передавая значение опции «электронная почта» в качестве аргумента.

Наше определение опции как пары (имя, значение) просто и полезно, но в одном особом случае командной строки есть проблема. Командная строка может включать в себяпозиционную опцию, которая вообще не указывает никакого имени, например:

          archiver --compression=9 /etc/passwd
        

Здесь элемент «/etc/passwd» не имеет названия опции.

Одно из решений заключается в том, чтобы попросить пользователя самостоятельно извлечь позиционные опции и обрабатывать их по своему усмотрению. Тем не менее, есть более приятный подход - предоставить метод автоматического присвоения имен для позиционных опций, чтобы вышеуказанная командная строка могла интерпретироваться так же, как:

          archiver --compression=9 --input-file=/etc/passwd
        

Класс<positional_options_description>позволяет парсеру командной строки присваивать имена. Класс определяет, сколько позиционных опций разрешено, и для каждого разрешенного опциона указывает название. Например:

positional_options_description pd; pd.add("input-file", 1);

Уточняется, что для ровно одного, во-первых, позиционного варианта имя будет «вход-файл».

Можно указать, что номеру или даже всем позиционным опциям присваивается одно и то же имя.

positional_options_description pd;
pd.add("output-file", 2).add("input-file", -1);

В приведенном выше примере первые два позиционных варианта будут связаны с именем «выход-файл», а любые другие с именем «вход-файл».

	Warning
	Класс<positional_options_description>определяет только перевод с позиции на имя, и имя опции должно быть зарегистрировано с экземпляром класса<options_description>.

Функция<parse_config_file>реализует разбор простых INI-подобных конфигурационных файлов. Синтаксис файла конфигурации основан на строке:

Имена опций относятся к именам разделов, поэтому следующая часть файла конфигурации:

[gui.accessibility]
visual_bell=yes
      

является эквивалентным

gui.accessibility.visual_bell=yes
      

Переменные средыявляются струнными переменными, которые доступны для всех программ через<getenv>функцию библиотеки времени выполнения C. Операционная система позволяет устанавливать начальные значения для данного пользователя, а значения могут быть дополнительно изменены в командной строке. Например, в Windows можно использовать<autoexec.bat>файл или (в последних версиях) диалог<Control Panel/System/Advanced/Environment Variables>, а также Unix & #8212; файлы</etc/profile>,<~/.profile>и<~/.bash_profile>. Поскольку переменные среды могут быть установлены для всей системы, они особенно подходят для опций, которые применяются ко всем программам.

Переменные среды можно разобрать с помощью функции<parse_environment>. Функция имеет несколько перегруженных версий. Первый параметр всегда является экземпляром<options_description>, а второй определяет, какие переменные должны быть обработаны, и какие имена опций должны соответствовать ему. Для описания второго параметра необходимо рассмотреть условности имен переменных среды.

Если у вас есть опция, которая должна быть указана через переменную среды, вам нужно составить имя переменной. Чтобы избежать столкновений имен, мы предлагаем использовать достаточно уникальный префикс для переменных среды. Кроме того, в то время как имена опций наиболее вероятны в нижнем случае, переменные среды обычно используют верхний случай. Так, для названия опции<proxy>переменная среды может быть названа<BOOST_PROXY>. Во время разбора необходимо выполнить обратное преобразование имен. Это достигается путем прохождения выбранного префикса в качестве второго параметра функции<parse_environment>. Скажем, если вы передадите<BOOST_>в качестве префикса, и есть две переменные,<CVSROOT>и<BOOST_PROXY>, первая переменная будет проигнорирована, а вторая будет преобразована в опцию<proxy>.

Вышеприведенная логика во многих случаях достаточна, но также можно пройти, как второй параметр функции<parse_environment>, любую функцию, принимающую<std::string>и возвращающую<std::string>. Эта функция будет вызываться для каждой переменной среды и должна возвращать либо название опции, либо пустую строку, если переменная должна быть проигнорирована.