---

Properties.h

Go to the documentation of this file.

/*
 * Properties.h
 *
 * Copyright 2003, MobileSpear Inc. (www.mobilespear.com). All rights reserved.
 * Copyright 2003, David Resnick. All rights reserved.
 *
 * See the file doc\license.txt for the terms of usage and distribution.
 */

#ifndef _BOGOTEL_PROPERTIES_H_
#define _BOGOTEL_PROPERTIES_H_

#include <map>
#include <string>
#include <fstream>
#include <iostream>
#include <stdexcept>

namespace bogotel {

    class CPropertiesFailure : public std::runtime_error {
    public:
        CPropertiesFailure(const std::string& reason);
    };

    class CProperties : public std::map<std::string, std::string> 
    {
    public:
        CProperties();
        virtual ~CProperties();

        void load(const std::string filename) throw (CPropertiesFailure);

        // These mappings will replace any mappings that this CProperties had for any of 
        // the keys currently in the specified CProperties.
        void putAll(CProperties& prop);

        const std::string   getProperty(const std::string& strKey);

        const std::string   getProperty(const std::string& strKey, const std::string& strDefault);
        const int           getProperty(const std::string& strKey, const int iDefault);
        const long          getProperty(const std::string& strKey, const long lDefault);
        const unsigned long getProperty(const std::string& strKey, const unsigned long ulDefault);

        const int setProperty(const std::string& strKey, const int iValue);
        const std::string setProperty(const std::string& strKey, const std::string& strValue);

        void list(std::ostream& out);

    protected:
        static const std::string _strBlank;

    private:

        static const char * const szKeyTerminators;

    public:
        typedef std::map<std::string, std::string> StringMap;
    };
}

#endif // ! def _BOGOTEL_PROPERTIES_H_

---