Options.h

Go to the documentation of this file.

//
// Copyright (c) ZeroC, Inc. All rights reserved.
//
 
#ifndef ICE_UTIL_OPTIONS_H
#define ICE_UTIL_OPTIONS_H
 
#include <IceUtil/Config.h>
#include <IceUtil/RecMutex.h>
#include <IceUtil/Shared.h>
#include <IceUtil/Handle.h>
#include <IceUtil/Exception.h>
#include <string>
#include <vector>
#include <map>
 
namespace IceUtilInternal
{
 
class ICE_API APIException : public IceUtil::ExceptionHelper<APIException>
{
public:
 
    APIException(const char*, int, const ::std::string&);
#ifndef ICE_CPP11_COMPILER
    virtual ~APIException() throw();
#endif
    virtual ::std::string ice_id() const;
    virtual void ice_print(std::ostream&) const;
#ifndef ICE_CPP11_MAPPING
    virtual APIException* ice_clone() const;
#endif
 
    ::std::string reason;
};
 
ICE_API ::std::ostream& operator<<(::std::ostream&, const APIException&);
 
class ICE_API BadOptException : public IceUtil::ExceptionHelper<BadOptException>
{
public:
 
    BadOptException(const char*, int, const ::std::string&);
#ifndef ICE_CPP11_COMPILER
    virtual ~BadOptException() throw();
#endif
    virtual ::std::string ice_id() const;
    virtual void ice_print(std::ostream&) const;
 
#ifndef ICE_CPP11_MAPPING
    virtual BadOptException* ice_clone() const;
#endif
 
    ::std::string reason;
};
 
ICE_API ::std::ostream& operator<<(::std::ostream&, const BadOptException&);
 
class ICE_API Options
{
public:
 
    enum LengthType { ShortOpt, LongOpt };
    enum RepeatType { Repeat, NoRepeat };
    enum ArgType { NeedArg, NoArg };
 
    Options();
    void addOpt(const ::std::string&, const ::std::string& = "",
                ArgType = NoArg, ::std::string = "", RepeatType = NoRepeat);
 
    typedef ::std::vector< ::std::string> StringVector;
 
    static StringVector split(const ::std::string&);
    StringVector parse(const StringVector&);
    StringVector parse(int, const char* const []);
    bool isSet(const ::std::string&) const;
    ::std::string optArg(const ::std::string&) const;
    StringVector argVec(const ::std::string&) const;
 
private:
 
    struct OptionDetails : public IceUtil::Shared
    {
        LengthType length;
        ArgType arg;
        RepeatType repeat;
        bool hasDefault;
    };
    typedef IceUtil::Handle<OptionDetails> ODPtr;
 
    struct OptionValue : public IceUtil::Shared
    {
        ::std::string val;
    };
    typedef IceUtil::Handle<OptionValue> OValPtr;
 
    struct OptionValueVector : public IceUtil::Shared
    {
        ::std::vector< ::std::string> vals;
    };
    typedef IceUtil::Handle<OptionValueVector> OVecPtr;
 
    typedef ::std::map< ::std::string, ODPtr> ValidOpts; // Valid options and their details.
    typedef ::std::map< ::std::string, OValPtr> Opts; // Value of non-repeating options.
    typedef ::std::map< ::std::string, OVecPtr> ROpts; // Value of repeating options.
    typedef ::std::map< ::std::string, ::std::string> Synonyms; // Map from short to long option and vice versa.
 
    void addValidOpt(const ::std::string&, const ::std::string&, ArgType, const ::std::string&, RepeatType);
    ValidOpts::iterator checkOpt(const ::std::string&, LengthType);
    void setOpt(const ::std::string&, const ::std::string&, const ::std::string&, RepeatType);
    void setNonRepeatingOpt(const ::std::string&, const ::std::string&);
    void setRepeatingOpt(const ::std::string&, const ::std::string&);
    ValidOpts::const_iterator checkOptIsValid(const ::std::string&) const;
    ValidOpts::const_iterator checkOptHasArg(const ::std::string&) const;
    void updateSynonyms(const ::std::string&, const ::std::string&);
    ::std::string getSynonym(const ::std::string&) const;
 
    ValidOpts _validOpts;
    Opts _opts;
    ROpts _ropts;
    Synonyms _synonyms;
 
    bool parseCalled;
 
    IceUtil::RecMutex _m;
 
    Options(const Options&); // Not allowed.
    void operator=(const Options&); // Not allowed.
 
    static void checkArgs(const ::std::string&, const ::std::string&, bool, const ::std::string&);
};
 
}
 
#endif