---

HxRegKey.h

/*
 *  Copyright (c) 1998, University of Amsterdam, The Netherlands.
 *  All rights reserved.
 *
 *
 *  Author(s):
 *  Dennis Koelma (koelma@wins.uva.nl)
 *  Edo Poll (poll@wins.uva.nl)
 */

#ifndef HxRegKey_h
#define HxRegKey_h

#include "HxIoFwd.h"
#include "HxString.h"
#include "HxStringList.h"

#include "HxRegData.h"
#include "HxRegValue.h"

#include "HxRegKeyList.h"
#include "HxRegValueList.h"

#pragma warning (disable : 4786)

#include <list>
#include <vector>
#include <map>
#include <algorithm>

typedef std::map<HxString, HxRegKeyPtr, std::less<HxString> >   HxRegKeyMap;
typedef HxRegKeyMap::value_type                                 HxRegKeyEntry;

//
// Take care in using delete on HxRegKey*, keys can be part of a registry.
//

class L_HXBASIS HxRegKey
{
public:
                        ~HxRegKey();

    static HxRegKey*    createRootKey();

    HxString            getName() const;
    HxRegKey*           getParent() const;

    HxRegKey*           insertKey(HxString path);
    void                eraseKey(HxString name);

    HxRegKey*           findKey(HxString path) const;
    HxRegKey*           findKey(
                            HxStringListConstIter first,
                            HxStringListConstIter last) const;

    int                 getKeyList(HxRegKeyListBackInserter) const;
    size_t              keyListSize() const;

    void                insertValue(HxString name, const HxRegData& data);
    void                insertValue(const HxRegValue& value);
    void                eraseValue(HxString name);

    const HxRegValue*   findValue(HxString name) const;

                        // Below are shorthands for findValue.
                        // Existence of the values cannot be determined
                        // from the return value.
    int                 getInt(HxString name) const;
    HxString            getString(HxString name) const;

    int                 getValueList(HxRegValueListBackInserter);
    size_t              valueListSize() const;

    STD_OSTREAM&        put(STD_OSTREAM&) const;
    STD_OSTREAM&        put(STD_OSTREAM&, HxString path, int cCode = 0) const;

private:
                        HxRegKey(HxString name, HxRegKey* parent);
                        HxRegKey();
                        HxRegKey(const HxRegKey&);

    const HxRegKey&     operator=(const HxRegKey&);

    typedef std::vector<HxRegValue>  ValueVector;

    HxRegKey*           insertOneKey(HxString name);

#pragma warning (disable : 4251)
    HxString            _name;
    HxRegKeyMap*        _keys;
    ValueVector         _values;
    HxRegKey*           _parent;
#pragma warning (default : 4251)

    friend class HxRegKeyFriend;
};

inline STD_OSTREAM&
operator<<(STD_OSTREAM& os, const HxRegKey& key)
{
    return key.put(os);
}

inline HxString
HxRegKey::getName() const
{
    return _name;
}

inline HxRegKey*
HxRegKey::getParent() const
{
    return _parent;
}

inline void
HxRegKey::insertValue(HxString name, const HxRegData& data)
{
    insertValue(HxRegValue(name, data));
}

inline int
HxRegKey::getInt(HxString name) const
{
    const HxRegValue* val = findValue(name);
    return val ? val->getData().getInt() : 0;
}

inline HxString
HxRegKey::getString(HxString name) const
{
    const HxRegValue* val = findValue(name);
    return val ? val->getData().getString() : HxString();
}

#endif

---