teleport/common/libex/include/ex/ex_ini.h

#ifndef __EX_INI_H__
#define __EX_INI_H__

/*
特别注意：

1. 以 分号';' 或者 井号'#' 作为注释行的第一个字符
2. 不支持行内注释
3. 值对以第一个等号分隔，等号前后如果有空格会被忽略，之后的空格会保留，包括行尾空格
4. 如果有不属于某个小节的值对，可以使用GetDumySection()获取
   DumySection主要是为了能够兼容简单的Python文件做配置文件。
*/

#include "ex_str.h"
#include <map>

typedef std::map<ex_wstr, ex_wstr> ex_ini_kvs;

class ExIniSection
{
public:
    ExIniSection();

    explicit ExIniSection(const ex_wstr& strSectionName);

    ~ExIniSection();

    void ClearUp();

    ex_wstr Name() { return m_strName; }

    void GetStr(const ex_wstr& strKey, ex_wstr& strValue, const ex_wstr& strDefault);

    bool GetStr(const ex_wstr& strKey, ex_wstr& strValue);

    void GetInt(const ex_wstr& strKey, int& iValue, int iDefault);

    bool GetInt(const ex_wstr& strKey, int& iValue);

    void GetBool(const ex_wstr& strKey, bool& bValue, bool bDefault);

    bool GetBool(const ex_wstr& strKey, bool& bValue);

    bool SetValue(const ex_wstr& strKey, const ex_wstr& strValue, bool bAddIfNotExists = false);

    ex_ini_kvs& GetKeyValues() { return m_kvs; }

    int Count() const
    {
        return (int) m_kvs.size();
    }

    void Save(FILE* file, int codepage);

#ifdef EX_DEBUG
    void Dump(void);
#endif

protected:
    bool _IsKeyExists(const ex_wstr& strKey);

private:
    ex_wstr m_strName;
    ex_ini_kvs m_kvs;
};


typedef std::map<ex_wstr, ExIniSection*> ex_ini_sections;

// Ini file
class ExIniFile
{
public:
    enum PARSE_RV
    {
        PARSE_ERROR,
        PARSE_SECTION,
        PARSE_KEYVALUE,
        PARSE_COMMENT,
        PARSE_OTHER
    };

public:
    ExIniFile();

    ~ExIniFile();

    const ex_wstr& get_filename() { return m_file_path; }

    void ClearUp();

    // Read and parse special file.
    bool LoadFromFile(const ex_wstr& strFileName, bool bClearOld = true);

    bool LoadFromMemory(const ex_wstr& strData, bool bClearOld = true);

    ex_ini_sections& GetAllSections() { return m_secs; }

    ExIniSection* GetSection(const ex_wstr& strName, bool bCreateIfNotExists = false);

    ExIniSection* GetDumySection() { return &m_dumy_sec; }

    int Count() const
    {
        return (int) (m_secs.size());
    }

    void Save(int codepage = EX_CODEPAGE_UTF8);

#ifdef EX_DEBUG
    void Dump(void);
#endif

protected:
    static PARSE_RV parse_line_(const ex_wstr& strLine, ex_wstr& strKey, ex_wstr& strValue);

    bool process_line_(const ex_wstr& strLine, ExIniSection** pCurSection);

private:
    ex_ini_sections m_secs;
    ExIniSection m_dumy_sec;
    ex_wstr m_file_path;
};

#endif // __EX_INI_H__