Click here to Skip to main content
15,867,594 members
Articles / Programming Languages / C++
Article

Object Oriented Command Line Parser

Rate me:
Please Sign up or sign in to vote.
4.54/5 (13 votes)
26 Jan 20042 min read 79.9K   2.7K   50   8
Object oriented extensible command line parser

Introduction

This class is useful in any object oriented command line applications. It provides an easy way to parse, check and distribute the command line arguments. This class parses the arguments in all these formats: <lu>

  • -b
  • -h www.codeproject.com
  • stdafx.cpp
  • -temp:-7 <lu>

Additionally this class is prepared to parse arguments starting with "--" or "/" at the same time.

Background

The following convention is used to identify the three types of arguments:

  • The arguments that act like a flag ("ls -l") are called empty arguments.
  • Those that also have a value ("netstat -p tcp") are called value arguments.
  • And those who don't have any "-" ("copy a.cpp b.cpp") are called default arguments.

If it's necessary to specify negative numbers (like -temp -7) and to avoid that the engine parses two different empty arguments instead of a value argument, the user can type the command and its value separated by a ":" (like -temp:-7)

Using the code

First of all, the class interface ICmdLineParam must be implemented by all the classes that require to receive the command line arguments. We can implement only a class that receive all the arguments or any number of classes that receive any number of arguments. This interface has two virtual methods: Parse and GetError.

class CConfiguration : public ICmdLineParam
{
public:
    bool Parse(string argument,string value)
    {
        // The parser calls this method to indicate the name 
        // of the arguments and/or
        // the values, only when applicable. The '-' or '/' 
        // of the arguments are eliminated
        // before calling this method.
        // return false only if the parser must stop, on a serious error.
        // return true when the argument is OK or is malformed, 
        // in this second case 
        // the function GetError must return a description, see below.
    }
    std::string GetError()
    {
        // if a fail in command line occurs, this method must return 
        // a description of the error.
        // Ex: "Inaccesible input file", "invalid type of algorithm",..,etc.
        // return an empty string  to indicate that the arguments were OK.
    }
};

Second, a command parser must be declared and also all the objects that must receive the arguments.

CCommandLineParser parser;

CConfiguration configuration;
CFileList fileList;
CErrorEntry errObj;

The most important in this process is to assign every argument to an object. This code register the valid arguments and its type (value, empty or default).

// Value arguments
parser.PutValueCommand("out",&configuration);
parser.PutValueCommand("alg",&configuration);

// Empty arguments
parser.PutEmptyCommand("h",&errObj);
parser.PutEmptyCommand("help",&errObj);

// Default arguments, only one object can be asigned that will
// receive all the arguments.
parser.SetDefaultCommand(&fileList);

// Parsing errors.
parser.SetErrorCommand(&errObj);

This code above parse a command line with this format:

[-h] [-help] [-alg md5|sha1] [-out hex] file_1 file_2 ... file_n

Finally the process must start calling the method ParseArguments

if(parser.ParseArguments(argc,argv))
{
    // Application starts here
}

If the user types an invalid argument that is not registered or not type a value in a value argument, then an special argument is passed to the object registered with method SetErrorCommand. Also if one of the classes that implements ICmdLineParam returns a not empty string in GetError method, then another special argument is passed to the error registered class on its method Parse. This special arguments are:

  • UNKNOWN_PARAM argument not registered. Parameter 'value' is assigned with invalid argument.
  • NO_VALUE_PARAM value required. Parameter 'value' is assigned with the value argument.
  • GENERIC_ERROR a ICmdLineParam object returned an error description. Parameter 'value' is assigned with the error description.

This class must output to the user all the descriptions of the errors. See class CError on the demo project for an example.

Points of Interest

This code becomes handy when is necessary to add a new functionality to an already made application. It's easy to add new arguments or new values to previous defined arguments.

History

  • 24 Nov 03 - updated downloads

License

This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here


Written By
Spain Spain
This member has not yet provided a Biography. Assume it's interesting and varied, and probably something to do with programming.

Comments and Discussions

 
GeneralSuggestion - automatically generate 'usage' text Pin
RichardC22-Dec-04 14:02
RichardC22-Dec-04 14:02 
A pretty good effort at creating a general-purpose command-line parser!
Given that you have a list of required, default and optional parameters then you should be able to auto-create the 'usage' string instead of #define-ing it.

Cheers

- Richard
GeneralBug Pin
grb12-Jan-04 12:31
grb12-Jan-04 12:31 
GeneralRe: Bug Pin
Daniel Vela18-Jan-04 7:56
Daniel Vela18-Jan-04 7:56 
GeneralRe: Bug Pin
Sef Tarbell23-Jan-04 6:11
Sef Tarbell23-Jan-04 6:11 
GeneralRe: Bug Pin
Daniel Vela23-Jan-04 8:30
Daniel Vela23-Jan-04 8:30 
GeneralRe: Bug Pin
Alexey Yakovlev29-Jan-04 9:56
Alexey Yakovlev29-Jan-04 9:56 
GeneralRe: Bug Pin
Daniel Vela29-Jan-04 10:31
Daniel Vela29-Jan-04 10:31 
Generalwhy not use '=' for numeric values Pin
s.piras30-Sep-05 3:32
s.piras30-Sep-05 3:32 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.