Description
class Rose::CommandLine::IntervalParser< Interval >
Parse an interval.
An interval is specified in one of the following forms, where N and M are non-negative integers:
- "N" is a singleton interval.
- "N,M" is the min/max form specifying the two inclusive end points. M must not be less than N.
- "N-M" is the begin/end form where M is greater than N and not included in the interval.
- "N+M" is the base/size form where N is the minimum value and M is the number of items.
The integers can be specified in decimal, octal, hexadecimal, or binary using the usual C/C++ syntax.
Definition at line 32 of file IntervalParser.h.
#include <Rose/CommandLine/IntervalParser.h>
Public Types | |
| using | Ptr = Sawyer::SharedPointer< IntervalParser > |
| Shared-ownership pointer. | |
 Public Types inherited from Sawyer::CommandLine::ValueParser | |
| typedef SharedPointer< ValueParser > | Ptr |
| Reference counting pointer for this class. | |
Static Public Member Functions | |
| static Ptr | instance () |
| Default allocating constructor. | |
| static Ptr | instance (const Sawyer::CommandLine::ValueSaver::Ptr &valueSaver) |
| Allocating constructor. | |
| static std::string | docString (const std::string &interval="interval", const std::string &value="value") |
| Runtime documentation. | |
| static Interval | parse (const char *input, const char **rest) |
| Parse an interval from a C string. | |
| static Interval | parse (const std::string &input) |
| Parse an interval from a C++ string. | |
| static std::string | toString (const Interval &interval) |
| Unparse an interval to a string. | |
Protected Member Functions | |
| IntervalParser (const Sawyer::CommandLine::ValueSaver::Ptr &valueSaver) | |
| Protected Member Functions inherited from Sawyer::CommandLine::ValueParser | |
| ValueParser () | |
| Constructor for derived classes. | |
| ValueParser (const ValueSaver::Ptr &valueSaver) | |
| Constructor for derived classes. | |
Additional Inherited Members | |
| Public Member Functions inherited from Sawyer::CommandLine::ValueParser | |
| ParsedValue | matchString (const std::string &) |
| Parse the entire string and return a value. | |
| ParsedValue | match (Cursor &) |
| Parse a value from the beginning of the specified string. | |
| Ptr | valueSaver (const ValueSaver::Ptr &f) |
| Property: functor responsible for saving a parsed value in user storage. | |
| const ValueSaver::Ptr | valueSaver () const |
| Property: functor responsible for saving a parsed value in user storage. | |
| Public Member Functions inherited from Sawyer::SharedObject | |
| SharedObject () | |
| Default constructor. | |
| SharedObject (const SharedObject &) | |
| Copy constructor. | |
| virtual | ~SharedObject () |
| Virtual destructor. | |
| SharedObject & | operator= (const SharedObject &) |
| Assignment. | |
| Public Member Functions inherited from Sawyer::SharedFromThis< ValueParser > | |
| SharedPointer< ValueParser > | sharedFromThis () |
Create a shared pointer from this. | |
| SharedPointer< const ValueParser > | sharedFromThis () const |
Create a shared pointer from this. | |
Member Typedef Documentation
◆ Ptr
| using Rose::CommandLine::IntervalParser< Interval >::Ptr = Sawyer::SharedPointer<IntervalParser> |
Constructor & Destructor Documentation
◆ IntervalParser() [1/2]
|
inlineprotected |
Definition at line 34 of file IntervalParser.h.
◆ IntervalParser() [2/2]
|
inlineprotected |
Definition at line 36 of file IntervalParser.h.
Member Function Documentation
◆ instance() [1/2]
|
inlinestatic |
Default allocating constructor.
Definition at line 46 of file IntervalParser.h.
◆ instance() [2/2]
|
inlinestatic |
Allocating constructor.
Definition at line 51 of file IntervalParser.h.
References Sawyer::CommandLine::ValueParser::valueSaver().
◆ docString()
|
inlinestatic |
Runtime documentation.
Definition at line 56 of file IntervalParser.h.
◆ parse() [1/2]
|
inlinestatic |
Parse an interval from a C string.
Tries to parse an interval from the input string, and if successful adjusts rest to point to the first character beyond what was parsed. If a syntax error occurs, then an std::runtime_error is thrown.
Definition at line 75 of file IntervalParser.h.
Referenced by Rose::CommandLine::IntervalParser< Interval >::parse().
◆ parse() [2/2]
|
inlinestatic |
Parse an interval from a C++ string.
Tries to parse an interval from the input string. The string may contain leading and trailing white space, but any extra characters will cause a syntax error. Syntax errors are reported by throwing std::runtime_error. Since the underlying parsing is done on C strings, this function is ill-defined when the input contains NUL characters.
Definition at line 188 of file IntervalParser.h.
References Rose::StringUtility::cEscape(), and Rose::CommandLine::IntervalParser< Interval >::parse().
◆ toString()
|
inlinestatic |
Unparse an interval to a string.
Definition at line 199 of file IntervalParser.h.
References Rose::StringUtility::addrToString().
The documentation for this class was generated from the following file:
