75 lines
2.7 KiB
C++
75 lines
2.7 KiB
C++
// Copyright Vladimir Prus 2004.
|
|
// Distributed under the Boost Software License, Version 1.0.
|
|
// (See accompanying file LICENSE_1_0.txt
|
|
// or copy at http://www.boost.org/LICENSE_1_0.txt)
|
|
|
|
#ifndef BOOST_PROGRAM_OPTIONS_POSITIONAL_OPTIONS_VP_2004_03_02
|
|
#define BOOST_PROGRAM_OPTIONS_POSITIONAL_OPTIONS_VP_2004_03_02
|
|
|
|
#include <boost/program_options/config.hpp>
|
|
|
|
#include <vector>
|
|
#include <string>
|
|
|
|
#if defined(BOOST_MSVC)
|
|
# pragma warning (push)
|
|
# pragma warning (disable:4251) // class 'std::vector<_Ty>' needs to have dll-interface to be used by clients of class 'boost::program_options::positional_options_description'
|
|
#endif
|
|
|
|
namespace boost { namespace program_options {
|
|
|
|
/** Describes positional options.
|
|
|
|
The class allows to guess option names for positional options, which
|
|
are specified on the command line and are identified by the position.
|
|
The class uses the information provided by the user to associate a name
|
|
with every positional option, or tell that no name is known.
|
|
|
|
The primary assumption is that only the relative order of the
|
|
positional options themselves matters, and that any interleaving
|
|
ordinary options don't affect interpretation of positional options.
|
|
|
|
The user initializes the class by specifying that first N positional
|
|
options should be given the name X1, following M options should be given
|
|
the name X2 and so on.
|
|
*/
|
|
class BOOST_PROGRAM_OPTIONS_DECL positional_options_description {
|
|
public:
|
|
positional_options_description();
|
|
|
|
/** Species that up to 'max_count' next positional options
|
|
should be given the 'name'. The value of '-1' means 'unlimited'.
|
|
No calls to 'add' can be made after call with 'max_value' equal to
|
|
'-1'.
|
|
*/
|
|
positional_options_description&
|
|
add(const char* name, int max_count);
|
|
|
|
/** Returns the maximum number of positional options that can
|
|
be present. Can return (numeric_limits<unsigned>::max)() to
|
|
indicate unlimited number. */
|
|
unsigned max_total_count() const;
|
|
|
|
/** Returns the name that should be associated with positional
|
|
options at 'position'.
|
|
Precondition: position < max_total_count()
|
|
*/
|
|
const std::string& name_for_position(unsigned position) const;
|
|
|
|
private:
|
|
// List of names corresponding to the positions. If the number of
|
|
// positions is unlimited, then the last name is stored in
|
|
// m_trailing;
|
|
std::vector<std::string> m_names;
|
|
std::string m_trailing;
|
|
};
|
|
|
|
}}
|
|
|
|
#if defined(BOOST_MSVC)
|
|
# pragma warning (pop)
|
|
#endif
|
|
|
|
#endif
|
|
|