| ... |
... |
@@ -27,23 +27,22 @@
|
| 27 |
27 |
#include <sstream>
|
| 28 |
28 |
#include <algorithm>
|
| 29 |
29 |
#include <lemon/error.h>
|
| 30 |
30 |
|
| 31 |
31 |
///\ingroup misc
|
| 32 |
32 |
///\file
|
| 33 |
|
///\brief A tools to parse command line arguments.
|
| 34 |
|
///
|
| 35 |
|
///\author Alpar Juttner
|
|
33 |
///\brief A tool to parse command line arguments.
|
| 36 |
34 |
|
| 37 |
35 |
namespace lemon {
|
| 38 |
36 |
|
| 39 |
37 |
///Command line arguments parser
|
| 40 |
38 |
|
| 41 |
39 |
///\ingroup misc
|
| 42 |
|
///Command line arguments parser
|
|
40 |
///Command line arguments parser.
|
| 43 |
41 |
///
|
|
42 |
///For a complete example see the \ref arg_parser_demo.cc demo file.
|
| 44 |
43 |
class ArgParser {
|
| 45 |
44 |
|
| 46 |
45 |
static void _showHelp(void *p);
|
| 47 |
46 |
protected:
|
| 48 |
47 |
|
| 49 |
48 |
int _argc;
|
| ... |
... |
@@ -162,13 +161,13 @@
|
| 162 |
161 |
///\retval value The value of the argument will be written to this variable.
|
| 163 |
162 |
///\param obl Indicate if the option is mandatory.
|
| 164 |
163 |
ArgParser &stringOption(const std::string &name,
|
| 165 |
164 |
const std::string &help,
|
| 166 |
165 |
std::string value="", bool obl=false);
|
| 167 |
166 |
|
| 168 |
|
///\name Options with an external strorage.
|
|
167 |
///\name Options with external storage
|
| 169 |
168 |
///Using this functions, the value of the option will be directly written
|
| 170 |
169 |
///into a variable once the option appears in the command line.
|
| 171 |
170 |
|
| 172 |
171 |
///@{
|
| 173 |
172 |
|
| 174 |
173 |
///Add a new integer type option with a storage reference
|
| ... |
... |
@@ -219,15 +218,15 @@
|
| 219 |
218 |
|
| 220 |
219 |
///@{
|
| 221 |
220 |
|
| 222 |
221 |
///Boundle some options into a group
|
| 223 |
222 |
|
| 224 |
223 |
/// You can group some option by calling this function repeatedly for each
|
| 225 |
|
/// option to be grupped with the same groupname.
|
| 226 |
|
///\param group The group name
|
| 227 |
|
///\param opt The option name
|
|
224 |
/// option to be grouped with the same groupname.
|
|
225 |
///\param group The group name.
|
|
226 |
///\param opt The option name.
|
| 228 |
227 |
ArgParser &optionGroup(const std::string &group,
|
| 229 |
228 |
const std::string &opt);
|
| 230 |
229 |
|
| 231 |
230 |
///Make the members of a group exclusive
|
| 232 |
231 |
|
| 233 |
232 |
///If you call this function for a group, than at most one of them can be
|
| ... |
... |
@@ -239,30 +238,30 @@
|
| 239 |
238 |
///Using this function, at least one of the members of \c group
|
| 240 |
239 |
///must be given.
|
| 241 |
240 |
ArgParser &mandatoryGroup(const std::string &group);
|
| 242 |
241 |
|
| 243 |
242 |
///Create synonym to an option
|
| 244 |
243 |
|
| 245 |
|
///With this function you can create a sysnonym called \c sys of the
|
|
244 |
///With this function you can create a synonym \c syn of the
|
| 246 |
245 |
///option \c opt.
|
| 247 |
246 |
ArgParser &synonym(const std::string &syn,
|
| 248 |
247 |
const std::string &opt);
|
| 249 |
248 |
|
| 250 |
249 |
///@}
|
| 251 |
250 |
|
| 252 |
251 |
///Give help string for non-parsed arguments.
|
| 253 |
252 |
|
| 254 |
253 |
///With this function you can give help string for non-parsed arguments.
|
| 255 |
|
///the parameter \c name will be printed in the short usage line, while
|
|
254 |
///The parameter \c name will be printed in the short usage line, while
|
| 256 |
255 |
///\c help gives a more detailed description.
|
| 257 |
256 |
ArgParser &other(const std::string &name,
|
| 258 |
257 |
const std::string &help="");
|
| 259 |
258 |
|
| 260 |
|
///Non option type arguments.
|
|
259 |
///Give back the non-option type arguments.
|
| 261 |
260 |
|
| 262 |
|
///Gives back a reference to a vector consisting of the program arguments
|
|
261 |
///Give back a reference to a vector consisting of the program arguments
|
| 263 |
262 |
///not starting with a '-' character.
|
| 264 |
263 |
std::vector<std::string> &files() { return _file_args; }
|
| 265 |
264 |
|
| 266 |
265 |
///Give back the command name (the 0th argument)
|
| 267 |
266 |
const std::string &commandName() { return _command_name; }
|
| 268 |
267 |
|
| ... |
... |
@@ -295,15 +294,15 @@
|
| 295 |
294 |
}
|
| 296 |
295 |
|
| 297 |
296 |
|
| 298 |
297 |
///Magic type for operator[]
|
| 299 |
298 |
|
| 300 |
299 |
///This is the type of the return value of ArgParser::operator[]().
|
| 301 |
|
///It automatically converts to int, double, bool or std::string if
|
| 302 |
|
///the type of the option matches, otherwise it throws an exception.
|
| 303 |
|
///(i.e. it performs runtime type checking).
|
|
300 |
///It automatically converts to \c int, \c double, \c bool or
|
|
301 |
///\c std::string if the type of the option matches, otherwise it
|
|
302 |
///throws an exception (i.e. it performs runtime type checking).
|
| 304 |
303 |
class RefType
|
| 305 |
304 |
{
|
| 306 |
305 |
ArgParser &_parser;
|
| 307 |
306 |
std::string _name;
|
| 308 |
307 |
public:
|
| 309 |
308 |
///\e
|
| ... |
... |
@@ -352,13 +351,13 @@
|
| 352 |
351 |
}
|
| 353 |
352 |
|
| 354 |
353 |
};
|
| 355 |
354 |
|
| 356 |
355 |
///Give back the value of an option
|
| 357 |
356 |
|
| 358 |
|
///Give back the value of an option
|
|
357 |
///Give back the value of an option.
|
| 359 |
358 |
///\sa RefType
|
| 360 |
359 |
RefType operator[](const std::string &n)
|
| 361 |
360 |
{
|
| 362 |
361 |
return RefType(*this, n);
|
| 363 |
362 |
}
|
| 364 |
363 |
|