Latest 1.92.0 1.91.0-1 1.91.0 1.90.0 1.89.0 1.88.0 1.87.0 1.86.0 1.85.0 1.84.0 1.83.0 1.82.0 1.81.0 1.80.0 1.79.0 1.78.0 1.77.0 1.76.0 1.75.0 1.74.0 1.73.0 1.72.0 1.71.0 1.70.0 1.69.0 1.68.0 1.67.0 1.66.0 1.65.1 1.65.0 1.64.0 1.63.0 1.62.0 1.61.0 1.60.0 1.59.0 1.58.0 1.57.0 1.56.0 1.55.0 1.54.0 1.53.0 1.52.0 1.51.0 1.50.0 1.49.0 1.48.0 1.47.0 1.46.1 1.46.0 1.45.0 1.44.0 1.43.0 1.42.0 1.41.0 1.40.0 1.39.0 1.38.0 1.37.0 1.36.0 1.35.0 1.34.1 1.34.0 1.33.1 1.33.0 1.32.0 1.31.0 1.30.2 1.30.1 1.30.0 1.29.0 1.28.0 1.27.0 1.26.0 1.25.1-bgl 1.25.1 1.25.0 1.24.0 1.23.0 1.22.0 1.21.2 1.21.1 1.21.0 1.20.2 1.20.1 1.20.0 1.19.0 1.18.3 1.18.2 1.18.0 1.17.0 1.16.1
Log In
Latest 1.92.0 1.91.0-1 1.91.0 1.90.0 1.89.0 1.88.0 1.87.0 1.86.0 1.85.0 1.84.0 1.83.0 1.82.0 1.81.0 1.80.0 1.79.0 1.78.0 1.77.0 1.76.0 1.75.0 1.74.0 1.73.0 1.72.0 1.71.0 1.70.0 1.69.0 1.68.0 1.67.0 1.66.0 1.65.1 1.65.0 1.64.0 1.63.0 1.62.0 1.61.0 1.60.0 1.59.0 1.58.0 1.57.0 1.56.0 1.55.0 1.54.0 1.53.0 1.52.0 1.51.0 1.50.0 1.49.0 1.48.0 1.47.0 1.46.1 1.46.0 1.45.0 1.44.0 1.43.0 1.42.0 1.41.0 1.40.0 1.39.0 1.38.0 1.37.0 1.36.0 1.35.0 1.34.1 1.34.0 1.33.1 1.33.0 1.32.0 1.31.0 1.30.2 1.30.1 1.30.0 1.29.0 1.28.0 1.27.0 1.26.0 1.25.1-bgl 1.25.1 1.25.0 1.24.0 1.23.0 1.22.0 1.21.2 1.21.1 1.21.0 1.20.2 1.20.1 1.20.0 1.19.0 1.18.3 1.18.2 1.18.0 1.17.0 1.16.1
Log In
IO Miscellaneous C++11
Added in 1.32.0

Boost.ProgramOptions

The program_options library allows program developers to obtain program options, that is (name, value) pairs from the user, via conventional methods such as command line and config file.

Documentation Source code Discuss in Slack GitHub Issues

About Boost.ProgramOptions

Please check out the library's documentation to learn more.

View documentation

Quick Start

Dependencies

Any Bind Config Core Detail Function Iterator Lexical Cast Smart Ptr ThrowException Tokenizer Type Traits

Contributors: This Release

Documentation

Program Options, part of the collection of Boost C++ Libraries, allows for definition and acquisition of (name, value) pairs from the user via conventional methods such as command line and config file. It is roughly analogous to getopt_long, but for use with C++.

License

Distributed under the Boost Software License, Version 1.0.

Properties

  • C++11
  • Requires Linking

Development

The library is essentially done. No major new features are expected, the primary goal is stability, as well as small changes to re-align with the evolution of Boost C++ Libraries and C++.

  • Good PRs within the scope are welcome. It may take some time, and maybe a ping or two, to get merged.
  • Good issues are appreciated, but realistically, might remain open indefinitely, unless you also prepare a PR.
  • Drive-by PRs and issues are not welcome.
  • AI-assisted PRs are OK, but you should self-review every changed line.

Build Status

(in progress...)

Branch Travis Appveyor codecov.io Deps Docs Tests
master Build Status Build status codecov Deps Documentation Enter the Matrix
develop Build Status Build status codecov Deps Documentation Enter the Matrix

Directories

Name Purpose
build build script for link library
ci continuous integration scripts
doc documentation
example use case examples
include headers
src source code for link library
test unit tests

More information

  • Ask questions: Be sure to read the documentation first to see if it answers your question.
  • Report bugs: Be sure to mention Boost version, platform and compiler you're using. A small compilable code sample to reproduce the problem is always good as well.
  • Submit Pull Requests against the develop branch. Note that by submitting patches you agree to license your modifications under the Boost Software License, Version 1.0. Be sure to include tests proving your changes work properly.
  • Discussions about the library are held on the Boost developers mailing list. Be sure to read the discussion policy before posting and add the [program_options] tag at the beginning of the subject line.
Join the Boost Developers Mailing List
Get the latest on releases, features, security patches, fixes and all major announcements.

All Contributors