SimpleIni.h

 
#ifndef INCLUDED_SimpleIni_h
#define INCLUDED_SimpleIni_h
 
#if defined(_MSC_VER) && (_MSC_VER >= 1020)
#pragma once
#endif
 
// Disable these warnings in MSVC:
//  4127 "conditional expression is constant" as the conversion classes trigger
//  it with the statement if (sizeof(SI_CHAR) == sizeof(char)). This test will
//  be optimized away in a release build.
//  4503 'insert' : decorated name length exceeded, name was truncated
//  4702 "unreachable code" as the MS STL header causes it in release mode.
//  Again, the code causing the warning will be cleaned up by the compiler.
//  4786 "identifier truncated to 256 characters" as this is thrown hundreds
//  of times VC6 as soon as STL is used.
#ifdef _MSC_VER
#pragma warning(push)
#pragma warning(disable : 4127 4503 4702 4786)
#endif
 
#include <algorithm>
#include <cstdlib>
#include <cstring>
#include <limits>
#include <list>
#include <map>
#include <stdio.h>
#include <string>
 
#ifdef SI_SUPPORT_IOSTREAMS
#include <iostream>
#endif // SI_SUPPORT_IOSTREAMS
 
#ifdef _DEBUG
#ifndef assert
#include <cassert>
#endif
#define SI_ASSERT(x) assert(x)
#else
#define SI_ASSERT(x)
#endif
 
using SI_Error = int;
 
constexpr int SI_OK = 0;       
constexpr int SI_UPDATED = 1;  
constexpr int SI_INSERTED = 2; 
 
// note: test for any error with (retval < 0)
constexpr int SI_FAIL = -1;  
constexpr int SI_NOMEM = -2; 
constexpr int SI_FILE = -3;  
 
constexpr size_t SI_MAX_FILE_SIZE = 1024ULL * 1024ULL * 1024ULL;
 
#define SI_UTF8_SIGNATURE "\xEF\xBB\xBF"
 
#ifdef _WIN32
#define SI_NEWLINE_A "\r\n"
#define SI_NEWLINE_W L"\r\n"
#else // !_WIN32
#define SI_NEWLINE_A "\n"
#define SI_NEWLINE_W L"\n"
#endif // _WIN32
 
#if defined(SI_CONVERT_ICU)
#include <unicode/ustring.h>
#endif
 
#if defined(_WIN32)
#define SI_HAS_WIDE_FILE
#define SI_WCHAR_T wchar_t
#elif defined(SI_CONVERT_ICU)
#define SI_HAS_WIDE_FILE
#define SI_WCHAR_T UChar
#endif
 
// ---------------------------------------------------------------------------
//                              MAIN TEMPLATE CLASS
// ---------------------------------------------------------------------------
 
template <class SI_CHAR, class SI_STRLESS, class SI_CONVERTER>
class CSimpleIniTempl {
public:
  typedef SI_CHAR SI_CHAR_T;
 
  struct Entry {
    const SI_CHAR *pItem;
    const SI_CHAR *pComment;
    int nOrder;
 
    Entry(const SI_CHAR *a_pszItem = NULL, int a_nOrder = 0)
        : pItem(a_pszItem), pComment(NULL), nOrder(a_nOrder) {}
    Entry(const SI_CHAR *a_pszItem, const SI_CHAR *a_pszComment, int a_nOrder)
        : pItem(a_pszItem), pComment(a_pszComment), nOrder(a_nOrder) {}
    Entry(const Entry &rhs) { operator=(rhs); }
    Entry &operator=(const Entry &rhs) {
      pItem = rhs.pItem;
      pComment = rhs.pComment;
      nOrder = rhs.nOrder;
      return *this;
    }
 
#if defined(_MSC_VER) && _MSC_VER <= 1200
    bool operator<(const Entry &rhs) const { return LoadOrder()(*this, rhs); }
    bool operator>(const Entry &rhs) const { return LoadOrder()(rhs, *this); }
#endif
 
    struct KeyOrder {
      bool operator()(const Entry &lhs, const Entry &rhs) const {
        const static SI_STRLESS isLess = SI_STRLESS();
        return isLess(lhs.pItem, rhs.pItem);
      }
    };
 
    struct LoadOrder {
      bool operator()(const Entry &lhs, const Entry &rhs) const {
        if (lhs.nOrder != rhs.nOrder) {
          return lhs.nOrder < rhs.nOrder;
        }
        return KeyOrder()(lhs, rhs);
      }
    };
  };
 
  typedef std::multimap<Entry, const SI_CHAR *, typename Entry::KeyOrder>
      TKeyVal;
 
  typedef std::map<Entry, TKeyVal, typename Entry::KeyOrder> TSection;
 
  typedef std::list<Entry> TNamesDepend;
 
  class OutputWriter {
  public:
    OutputWriter() {}
    virtual ~OutputWriter() {}
    virtual void Write(const char *a_pBuf) = 0;
 
  private:
    OutputWriter(const OutputWriter &);            // disable
    OutputWriter &operator=(const OutputWriter &); // disable
  };
 
  class FileWriter : public OutputWriter {
    FILE *m_file;
 
  public:
    FileWriter(FILE *a_file) : m_file(a_file) {}
    void Write(const char *a_pBuf) { fputs(a_pBuf, m_file); }
 
  private:
    FileWriter(const FileWriter &);            // disable
    FileWriter &operator=(const FileWriter &); // disable
  };
 
  class StringWriter : public OutputWriter {
    std::string &m_string;
 
  public:
    StringWriter(std::string &a_string) : m_string(a_string) {}
    void Write(const char *a_pBuf) { m_string.append(a_pBuf); }
 
  private:
    StringWriter(const StringWriter &);            // disable
    StringWriter &operator=(const StringWriter &); // disable
  };
 
#ifdef SI_SUPPORT_IOSTREAMS
  class StreamWriter : public OutputWriter {
    std::ostream &m_ostream;
 
  public:
    StreamWriter(std::ostream &a_ostream) : m_ostream(a_ostream) {}
    void Write(const char *a_pBuf) { m_ostream << a_pBuf; }
 
  private:
    StreamWriter(const StreamWriter &);            // disable
    StreamWriter &operator=(const StreamWriter &); // disable
  };
#endif // SI_SUPPORT_IOSTREAMS
 
  class Converter : private SI_CONVERTER {
  public:
    Converter(bool a_bStoreIsUtf8) : SI_CONVERTER(a_bStoreIsUtf8) {
      m_scratch.resize(1024);
    }
    Converter(const Converter &rhs) { operator=(rhs); }
    Converter &operator=(const Converter &rhs) {
      m_scratch = rhs.m_scratch;
      return *this;
    }
    bool ConvertToStore(const SI_CHAR *a_pszString) {
      size_t uLen = SI_CONVERTER::SizeToStore(a_pszString);
      if (uLen == (size_t)(-1)) {
        return false;
      }
      while (uLen > m_scratch.size()) {
        m_scratch.resize(m_scratch.size() * 2);
      }
      return SI_CONVERTER::ConvertToStore(
          a_pszString, const_cast<char *>(m_scratch.data()), m_scratch.size());
    }
    const char *Data() { return m_scratch.data(); }
 
  private:
    std::string m_scratch;
  };
 
public:
  /*-----------------------------------------------------------------------*/
 
  CSimpleIniTempl(bool a_bIsUtf8 = false, bool a_bMultiKey = false,
                  bool a_bMultiLine = false);
 
  ~CSimpleIniTempl();
 
  void Reset();
 
  bool IsEmpty() const { return m_data.empty(); }
 
  /*-----------------------------------------------------------------------*/
  void SetUnicode(bool a_bIsUtf8 = true) {
    if (!m_pData)
      m_bStoreIsUtf8 = a_bIsUtf8;
  }
 
  bool IsUnicode() const { return m_bStoreIsUtf8; }
 
  void SetMultiKey(bool a_bAllowMultiKey = true) {
    m_bAllowMultiKey = a_bAllowMultiKey;
  }
 
  bool IsMultiKey() const { return m_bAllowMultiKey; }
 
  void SetMultiLine(bool a_bAllowMultiLine = true) {
    m_bAllowMultiLine = a_bAllowMultiLine;
  }
 
  bool IsMultiLine() const { return m_bAllowMultiLine; }
 
  void SetSpaces(bool a_bSpaces = true) { m_bSpaces = a_bSpaces; }
 
  bool UsingSpaces() const { return m_bSpaces; }
 
  void SetQuotes(bool a_bParseQuotes = true) {
    m_bParseQuotes = a_bParseQuotes;
  }
 
  bool UsingQuotes() const { return m_bParseQuotes; }
 
  void SetAllowKeyOnly(bool a_bAllowKeyOnly = true) {
    m_bAllowKeyOnly = a_bAllowKeyOnly;
  }
 
  bool GetAllowKeyOnly() const { return m_bAllowKeyOnly; }
 
  /*-----------------------------------------------------------------------*/
  SI_Error LoadFile(const char *a_pszFile);
 
#ifdef SI_HAS_WIDE_FILE
  SI_Error LoadFile(const SI_WCHAR_T *a_pwszFile);
#endif // SI_HAS_WIDE_FILE
 
  SI_Error LoadFile(FILE *a_fpFile);
 
#ifdef SI_SUPPORT_IOSTREAMS
  SI_Error LoadData(std::istream &a_istream);
#endif // SI_SUPPORT_IOSTREAMS
 
  SI_Error LoadData(const std::string &a_strData) {
    return LoadData(a_strData.c_str(), a_strData.size());
  }
 
  SI_Error LoadData(const char *a_pData, size_t a_uDataLen);
 
  /*-----------------------------------------------------------------------*/
  SI_Error SaveFile(const char *a_pszFile, bool a_bAddSignature = true) const;
 
#ifdef SI_HAS_WIDE_FILE
  SI_Error SaveFile(const SI_WCHAR_T *a_pwszFile,
                    bool a_bAddSignature = true) const;
#endif // _WIN32
 
  SI_Error SaveFile(FILE *a_pFile, bool a_bAddSignature = false) const;
 
  SI_Error Save(OutputWriter &a_oOutput, bool a_bAddSignature = false) const;
 
#ifdef SI_SUPPORT_IOSTREAMS
  SI_Error Save(std::ostream &a_ostream, bool a_bAddSignature = false) const {
    StreamWriter writer(a_ostream);
    return Save(writer, a_bAddSignature);
  }
#endif // SI_SUPPORT_IOSTREAMS
 
  SI_Error Save(std::string &a_sBuffer, bool a_bAddSignature = false) const {
    StringWriter writer(a_sBuffer);
    return Save(writer, a_bAddSignature);
  }
 
  /*-----------------------------------------------------------------------*/
  void GetAllSections(TNamesDepend &a_names) const;
 
  bool GetAllKeys(const SI_CHAR *a_pSection, TNamesDepend &a_names) const;
 
  bool GetAllValues(const SI_CHAR *a_pSection, const SI_CHAR *a_pKey,
                    TNamesDepend &a_values) const;
 
  int GetSectionSize(const SI_CHAR *a_pSection) const;
 
  const TKeyVal *GetSection(const SI_CHAR *a_pSection) const;
 
  inline bool SectionExists(const SI_CHAR *a_pSection) const {
    return GetSection(a_pSection) != NULL;
  }
 
  inline bool KeyExists(const SI_CHAR *a_pSection,
                        const SI_CHAR *a_pKey) const {
    return GetValue(a_pSection, a_pKey) != NULL;
  }
 
  const SI_CHAR *GetValue(const SI_CHAR *a_pSection, const SI_CHAR *a_pKey,
                          const SI_CHAR *a_pDefault = NULL,
                          bool *a_pHasMultiple = NULL) const;
 
  long GetLongValue(const SI_CHAR *a_pSection, const SI_CHAR *a_pKey,
                    long a_nDefault = 0, bool *a_pHasMultiple = NULL) const;
 
  double GetDoubleValue(const SI_CHAR *a_pSection, const SI_CHAR *a_pKey,
                        double a_nDefault = 0,
                        bool *a_pHasMultiple = NULL) const;
 
  bool GetBoolValue(const SI_CHAR *a_pSection, const SI_CHAR *a_pKey,
                    bool a_bDefault = false, bool *a_pHasMultiple = NULL) const;
 
  SI_Error SetValue(const SI_CHAR *a_pSection, const SI_CHAR *a_pKey,
                    const SI_CHAR *a_pValue, const SI_CHAR *a_pComment = NULL,
                    bool a_bForceReplace = false) {
    return AddEntry(a_pSection, a_pKey, a_pValue, a_pComment, a_bForceReplace,
                    true);
  }
 
  SI_Error SetLongValue(const SI_CHAR *a_pSection, const SI_CHAR *a_pKey,
                        long a_nValue, const SI_CHAR *a_pComment = NULL,
                        bool a_bUseHex = false, bool a_bForceReplace = false);
 
  SI_Error SetDoubleValue(const SI_CHAR *a_pSection, const SI_CHAR *a_pKey,
                          double a_nValue, const SI_CHAR *a_pComment = NULL,
                          bool a_bForceReplace = false);
 
  SI_Error SetBoolValue(const SI_CHAR *a_pSection, const SI_CHAR *a_pKey,
                        bool a_bValue, const SI_CHAR *a_pComment = NULL,
                        bool a_bForceReplace = false);
 
  bool Delete(const SI_CHAR *a_pSection, const SI_CHAR *a_pKey,
              bool a_bRemoveEmpty = false);
 
  bool DeleteValue(const SI_CHAR *a_pSection, const SI_CHAR *a_pKey,
                   const SI_CHAR *a_pValue, bool a_bRemoveEmpty = false);
 
  /*-----------------------------------------------------------------------*/
  Converter GetConverter() const { return Converter(m_bStoreIsUtf8); }
 
  /*-----------------------------------------------------------------------*/
private:
  // copying is not permitted
  CSimpleIniTempl(const CSimpleIniTempl &);            // disabled
  CSimpleIniTempl &operator=(const CSimpleIniTempl &); // disabled
 
  SI_Error FindFileComment(SI_CHAR *&a_pData, bool a_bCopyStrings);
 
  bool FindEntry(SI_CHAR *&a_pData, const SI_CHAR *&a_pSection,
                 const SI_CHAR *&a_pKey, const SI_CHAR *&a_pVal,
                 const SI_CHAR *&a_pComment) const;
 
  SI_Error AddEntry(const SI_CHAR *a_pSection, const SI_CHAR *a_pKey,
                    const SI_CHAR *a_pValue, const SI_CHAR *a_pComment,
                    bool a_bForceReplace, bool a_bCopyStrings);
 
  inline bool IsSpace(SI_CHAR ch) const {
    return (ch == ' ' || ch == '\t' || ch == '\r' || ch == '\n');
  }
 
  inline bool IsComment(SI_CHAR ch) const { return (ch == ';' || ch == '#'); }
 
  inline void SkipNewLine(SI_CHAR *&a_pData) const {
    a_pData += (*a_pData == '\r' && *(a_pData + 1) == '\n') ? 2 : 1;
  }
 
  SI_Error CopyString(const SI_CHAR *&a_pString);
 
  void UndoIncrementalLoadData(const TNamesDepend &a_oAddedSections,
                               const TNamesDepend &a_oAddedKeys);
 
  void DeleteString(const SI_CHAR *a_pString);
 
  bool IsLess(const SI_CHAR *a_pLeft, const SI_CHAR *a_pRight) const {
    const static SI_STRLESS isLess = SI_STRLESS();
    return isLess(a_pLeft, a_pRight);
  }
 
  bool IsMultiLineTag(const SI_CHAR *a_pData) const;
  bool IsMultiLineData(const SI_CHAR *a_pData) const;
  bool IsSingleLineQuotedValue(const SI_CHAR *a_pData) const;
  bool LoadMultiLineText(SI_CHAR *&a_pData, const SI_CHAR *&a_pVal,
                         const SI_CHAR *a_pTagName,
                         bool a_bAllowBlankLinesInComment = false) const;
  bool IsNewLineChar(SI_CHAR a_c) const;
 
  bool OutputMultiLineText(OutputWriter &a_oOutput, Converter &a_oConverter,
                           const SI_CHAR *a_pText) const;
 
private:
  SI_CHAR *m_pData;
 
  size_t m_uDataLen;
 
  const SI_CHAR *m_pFileComment;
 
  const SI_CHAR m_cEmptyString;
 
  TSection m_data;
 
  TNamesDepend m_strings;
 
  bool m_bStoreIsUtf8;
 
  bool m_bAllowMultiKey;
 
  bool m_bAllowMultiLine;
 
  bool m_bSpaces;
 
  bool m_bParseQuotes;
 
  bool m_bAllowKeyOnly;
 
  int m_nOrder;
};
 
// ---------------------------------------------------------------------------
//                                  IMPLEMENTATION
// ---------------------------------------------------------------------------
 
template <class SI_CHAR, class SI_STRLESS, class SI_CONVERTER>
CSimpleIniTempl<SI_CHAR, SI_STRLESS, SI_CONVERTER>::CSimpleIniTempl(
    bool a_bIsUtf8, bool a_bAllowMultiKey, bool a_bAllowMultiLine)
    : m_pData(0), m_uDataLen(0), m_pFileComment(NULL), m_cEmptyString(0),
      m_bStoreIsUtf8(a_bIsUtf8), m_bAllowMultiKey(a_bAllowMultiKey),
      m_bAllowMultiLine(a_bAllowMultiLine), m_bSpaces(true),
      m_bParseQuotes(false), m_bAllowKeyOnly(false), m_nOrder(0) {}
 
template <class SI_CHAR, class SI_STRLESS, class SI_CONVERTER>
CSimpleIniTempl<SI_CHAR, SI_STRLESS, SI_CONVERTER>::~CSimpleIniTempl() {
  Reset();
}
 
template <class SI_CHAR, class SI_STRLESS, class SI_CONVERTER>
void CSimpleIniTempl<SI_CHAR, SI_STRLESS, SI_CONVERTER>::Reset() {
  // remove all data
  delete[] m_pData;
  m_pData = NULL;
  m_uDataLen = 0;
  m_pFileComment = NULL;
  m_nOrder = 0;
  if (!m_data.empty()) {
    m_data.erase(m_data.begin(), m_data.end());
  }
 
  // remove all strings
  if (!m_strings.empty()) {
    typename TNamesDepend::iterator i = m_strings.begin();
    for (; i != m_strings.end(); ++i) {
      delete[] const_cast<SI_CHAR *>(i->pItem);
    }
    m_strings.erase(m_strings.begin(), m_strings.end());
  }
}
 
namespace SI_Internal {
#ifdef SI_CONVERT_ICU
inline SI_Error UCharPathToUtf8(const UChar *a_pPath, char *&a_pUtf8Path) {
  a_pUtf8Path = NULL;
  UErrorCode status = U_ZERO_ERROR;
  int32_t uLen = 0;
  u_strToUTF8(NULL, 0, &uLen, a_pPath, -1, &status);
  if (U_FAILURE(status) && status != U_BUFFER_OVERFLOW_ERROR) {
    return SI_FILE;
  }
  if (uLen < 0) {
    return SI_FILE;
  }
  char *pBuf = new (std::nothrow) char[static_cast<size_t>(uLen) + 1];
  if (!pBuf) {
    return SI_NOMEM;
  }
  status = U_ZERO_ERROR;
  u_strToUTF8(pBuf, uLen + 1, NULL, a_pPath, -1, &status);
  if (U_FAILURE(status)) {
    delete[] pBuf;
    return SI_FILE;
  }
  a_pUtf8Path = pBuf;
  return SI_OK;
}
#endif // SI_CONVERT_ICU
 
inline bool GetFileSize(FILE *a_fpFile, size_t &a_uSize) {
  a_uSize = 0;
 
#if defined(_WIN32) && !defined(_WIN32_WCE)
  if (_fseeki64(a_fpFile, 0, SEEK_END) != 0) {
    return false;
  }
  const __int64 nSize = _ftelli64(a_fpFile);
  if (nSize < 0) {
    return false;
  }
  if (static_cast<unsigned long long>(nSize) >
      static_cast<unsigned long long>(SI_MAX_FILE_SIZE)) {
    return false;
  }
  if (static_cast<unsigned long long>(nSize) >
      static_cast<unsigned long long>(std::numeric_limits<size_t>::max())) {
    return false;
  }
  a_uSize = static_cast<size_t>(nSize);
  if (_fseeki64(a_fpFile, 0, SEEK_SET) != 0) {
    return false;
  }
  return true;
#elif defined(_POSIX_VERSION) || defined(__unix__) || defined(__APPLE__)
  if (fseeko(a_fpFile, 0, SEEK_END) != 0) {
    return false;
  }
  const off_t nSize = ftello(a_fpFile);
  if (nSize < 0) {
    return false;
  }
  if (static_cast<unsigned long long>(nSize) >
      static_cast<unsigned long long>(SI_MAX_FILE_SIZE)) {
    return false;
  }
  if (static_cast<unsigned long long>(nSize) >
      static_cast<unsigned long long>(std::numeric_limits<size_t>::max())) {
    return false;
  }
  a_uSize = static_cast<size_t>(nSize);
  if (fseeko(a_fpFile, 0, SEEK_SET) != 0) {
    return false;
  }
  return true;
#else
  if (fseek(a_fpFile, 0, SEEK_END) != 0) {
    return false;
  }
  const long nSize = ftell(a_fpFile);
  if (nSize < 0) {
    return false;
  }
  if (static_cast<unsigned long long>(nSize) >
      static_cast<unsigned long long>(SI_MAX_FILE_SIZE)) {
    return false;
  }
  a_uSize = static_cast<size_t>(nSize);
  if (fseek(a_fpFile, 0, SEEK_SET) != 0) {
    return false;
  }
  return true;
#endif
}
} // namespace SI_Internal
 
template <class SI_CHAR, class SI_STRLESS, class SI_CONVERTER>
SI_Error CSimpleIniTempl<SI_CHAR, SI_STRLESS, SI_CONVERTER>::LoadFile(
    const char *a_pszFile) {
  FILE *fp = NULL;
#if __STDC_WANT_SECURE_LIB__ && !_WIN32_WCE
  fopen_s(&fp, a_pszFile, "rb");
#else  // !__STDC_WANT_SECURE_LIB__
  fp = fopen(a_pszFile, "rb");
#endif // __STDC_WANT_SECURE_LIB__
  if (!fp) {
    return SI_FILE;
  }
  SI_Error rc = LoadFile(fp);
  fclose(fp);
  return rc;
}
 
#ifdef SI_HAS_WIDE_FILE
template <class SI_CHAR, class SI_STRLESS, class SI_CONVERTER>
SI_Error CSimpleIniTempl<SI_CHAR, SI_STRLESS, SI_CONVERTER>::LoadFile(
    const SI_WCHAR_T *a_pwszFile) {
#ifdef _WIN32
  FILE *fp = NULL;
#if __STDC_WANT_SECURE_LIB__ && !_WIN32_WCE
  _wfopen_s(&fp, a_pwszFile, L"rb");
#else  // !__STDC_WANT_SECURE_LIB__
  fp = _wfopen(a_pwszFile, L"rb");
#endif // __STDC_WANT_SECURE_LIB__
  if (!fp)
    return SI_FILE;
  SI_Error rc = LoadFile(fp);
  fclose(fp);
  return rc;
#else  // !_WIN32 (therefore SI_CONVERT_ICU)
  char *szFile = NULL;
  SI_Error rcPath = SI_Internal::UCharPathToUtf8(a_pwszFile, szFile);
  if (rcPath < 0) {
    return rcPath;
  }
  SI_Error rc = LoadFile(szFile);
  delete[] szFile;
  return rc;
#endif // _WIN32
}
#endif // SI_HAS_WIDE_FILE
 
template <class SI_CHAR, class SI_STRLESS, class SI_CONVERTER>
SI_Error
CSimpleIniTempl<SI_CHAR, SI_STRLESS, SI_CONVERTER>::LoadFile(FILE *a_fpFile) {
  size_t uSize = 0;
  if (!SI_Internal::GetFileSize(a_fpFile, uSize)) {
    return SI_FILE;
  }
  if (uSize == 0) {
    return SI_OK;
  }
 
  // allocate and ensure NULL terminated
  char *pData = new (std::nothrow) char[uSize + 1];
  if (!pData) {
    return SI_NOMEM;
  }
  pData[uSize] = 0;
 
  // load data into buffer
  size_t uRead = fread(pData, sizeof(char), uSize, a_fpFile);
  if (uRead != uSize) {
    delete[] pData;
    return SI_FILE;
  }
 
  // convert the raw data to unicode
  SI_Error rc = LoadData(pData, uRead);
  delete[] pData;
  return rc;
}
 
template <class SI_CHAR, class SI_STRLESS, class SI_CONVERTER>
SI_Error CSimpleIniTempl<SI_CHAR, SI_STRLESS, SI_CONVERTER>::LoadData(
    const char *a_pData, size_t a_uDataLen) {
  if (!a_pData) {
    return SI_OK;
  }
 
  // if the UTF-8 BOM exists, consume it and set mode to unicode, if we have
  // already loaded data and try to change mode half-way through then this will
  // be ignored and we will assert in debug versions
  if (a_uDataLen >= 3 && memcmp(a_pData, SI_UTF8_SIGNATURE, 3) == 0) {
    a_pData += 3;
    a_uDataLen -= 3;
    SI_ASSERT(m_bStoreIsUtf8 || !m_pData); // we don't expect mixed mode data
    SetUnicode();
  }
 
  if (a_uDataLen == 0) {
    return SI_OK;
  }
 
  // determine the length of the converted data
  SI_CONVERTER converter(m_bStoreIsUtf8);
  size_t uLen = converter.SizeFromStore(a_pData, a_uDataLen);
  if (uLen == (size_t)(-1)) {
    return SI_FAIL;
  }
 
  // check converted data size is within supported limits (SI_MAX_FILE_SIZE)
  if (uLen >= (SI_MAX_FILE_SIZE / sizeof(SI_CHAR))) {
    return SI_FILE;
  }
 
  // allocate memory for the data, ensure that there is a NULL
  // terminator wherever the converted data ends
  SI_CHAR *pData = new (std::nothrow) SI_CHAR[uLen + 1];
  if (!pData) {
    return SI_NOMEM;
  }
  memset(pData, 0, sizeof(SI_CHAR) * (uLen + 1));
 
  // convert the data
  if (!converter.ConvertFromStore(a_pData, a_uDataLen, pData, uLen)) {
    delete[] pData;
    return SI_FAIL;
  }
 
  // parse it
  const static SI_CHAR empty = 0;
  SI_CHAR *pWork = pData;
  const SI_CHAR *pSection = &empty;
  const SI_CHAR *pItem = NULL;
  const SI_CHAR *pVal = NULL;
  const SI_CHAR *pComment = NULL;
 
  // We copy the strings if we are loading data into this class when we
  // already have stored some.
  bool bCopyStrings = (m_pData != NULL);
 
  size_t nStringsBefore = 0;
  const SI_CHAR *pFileCommentBefore = NULL;
  TNamesDepend oAddedSections;
  TNamesDepend oAddedKeys;
  if (bCopyStrings) {
    nStringsBefore = m_strings.size();
    pFileCommentBefore = m_pFileComment;
  }
 
  // find a file comment if it exists, this is a comment that starts at the
  // beginning of the file and continues until the first blank line.
  SI_Error rc = FindFileComment(pWork, bCopyStrings);
  if (rc < 0) {
    delete[] pData;
    if (bCopyStrings) {
      m_pFileComment = pFileCommentBefore;
      while (m_strings.size() > nStringsBefore) {
        delete[] const_cast<SI_CHAR *>(m_strings.back().pItem);
        m_strings.pop_back();
      }
    } else {
      m_pFileComment = NULL;
    }
    return rc;
  }
 
  // add every entry in the file to the data table
  while (FindEntry(pWork, pSection, pItem, pVal, pComment)) {
    bool bSectionExisted = SectionExists(pSection);
    bool bKeyExisted = pItem && bSectionExisted && KeyExists(pSection, pItem);
 
    rc = AddEntry(pSection, pItem, pVal, pComment, false, bCopyStrings);
    if (rc < 0) {
      if (bCopyStrings) {
        m_pFileComment = pFileCommentBefore;
        UndoIncrementalLoadData(oAddedSections, oAddedKeys);
        while (m_strings.size() > nStringsBefore) {
          delete[] const_cast<SI_CHAR *>(m_strings.back().pItem);
          m_strings.pop_back();
        }
      } else {
        m_data.clear();
        m_pFileComment = NULL;
        m_nOrder = 0;
      }
      delete[] pData;
      return rc;
    }
 
    if (bCopyStrings) {
      if (!bSectionExisted && *pSection) {
        oAddedSections.push_back(Entry(pSection, NULL, 0));
      }
      if (pItem && !bKeyExisted) {
        oAddedKeys.push_back(Entry(pItem, pSection, 0));
      }
    }
  }
 
  // store these strings if we didn't copy them
  if (bCopyStrings) {
    delete[] pData;
  } else {
    m_pData = pData;
    m_uDataLen = uLen + 1;
  }
 
  return SI_OK;
}
 
#ifdef SI_SUPPORT_IOSTREAMS
template <class SI_CHAR, class SI_STRLESS, class SI_CONVERTER>
SI_Error CSimpleIniTempl<SI_CHAR, SI_STRLESS, SI_CONVERTER>::LoadData(
    std::istream &a_istream) {
  std::string strData;
  char buf[4096];
  while (a_istream.read(buf, sizeof(buf)) || a_istream.gcount() > 0) {
    const std::streamsize nRead = a_istream.gcount();
    for (std::streamsize i = 0; i < nRead; ++i) {
      if (buf[i] == '\0') {
        return SI_FAIL;
      }
    }
    if (strData.size() + static_cast<size_t>(nRead) > SI_MAX_FILE_SIZE) {
      return SI_FILE;
    }
    strData.append(buf, static_cast<size_t>(nRead));
  }
  return LoadData(strData.data(), strData.size());
}
#endif // SI_SUPPORT_IOSTREAMS
 
template <class SI_CHAR, class SI_STRLESS, class SI_CONVERTER>
SI_Error CSimpleIniTempl<SI_CHAR, SI_STRLESS, SI_CONVERTER>::FindFileComment(
    SI_CHAR *&a_pData, bool a_bCopyStrings) {
  // there can only be a single file comment
  if (m_pFileComment) {
    return SI_OK;
  }
 
  // Load the file comment as multi-line text, this will modify all of
  // the newline characters to be single \n chars
  if (!LoadMultiLineText(a_pData, m_pFileComment, NULL, false)) {
    return SI_OK;
  }
 
  // copy the string if necessary
  if (a_bCopyStrings) {
    SI_Error rc = CopyString(m_pFileComment);
    if (rc < 0)
      return rc;
  }
 
  return SI_OK;
}
 
template <class SI_CHAR, class SI_STRLESS, class SI_CONVERTER>
bool CSimpleIniTempl<SI_CHAR, SI_STRLESS, SI_CONVERTER>::FindEntry(
    SI_CHAR *&a_pData, const SI_CHAR *&a_pSection, const SI_CHAR *&a_pKey,
    const SI_CHAR *&a_pVal, const SI_CHAR *&a_pComment) const {
  a_pComment = NULL;
 
  bool bHaveValue = false;
  SI_CHAR *pTrail = NULL;
  while (*a_pData) {
    // skip spaces and empty lines
    while (*a_pData && IsSpace(*a_pData)) {
      ++a_pData;
    }
    if (!*a_pData) {
      break;
    }
 
    // skip processing of comment lines but keep a pointer to
    // the start of the comment.
    if (IsComment(*a_pData)) {
      LoadMultiLineText(a_pData, a_pComment, NULL, true);
      continue;
    }
 
    // process section names
    if (*a_pData == '[') {
      // skip leading spaces
      ++a_pData;
      while (*a_pData && IsSpace(*a_pData)) {
        ++a_pData;
      }
 
      // find the end of the section name (it may contain spaces)
      // and convert it to lowercase as necessary
      a_pSection = a_pData;
      while (*a_pData && *a_pData != ']' && !IsNewLineChar(*a_pData)) {
        ++a_pData;
      }
 
      // if it's an invalid line, just skip it
      if (*a_pData != ']') {
        continue;
      }
 
      // remove trailing spaces from the section
      pTrail = a_pData - 1;
      while (pTrail >= a_pSection && IsSpace(*pTrail)) {
        --pTrail;
      }
      ++pTrail;
      *pTrail = 0;
 
      // skip to the end of the line
      ++a_pData; // safe as checked that it == ']' above
      while (*a_pData && !IsNewLineChar(*a_pData)) {
        ++a_pData;
      }
 
      a_pKey = NULL;
      a_pVal = NULL;
      return true;
    }
 
    // find the end of the key name (it may contain spaces)
    a_pKey = a_pData;
    while (*a_pData && *a_pData != '=' && !IsNewLineChar(*a_pData)) {
      ++a_pData;
    }
    // *a_pData is null, equals, or newline
 
    // if no value and we don't allow no value, then invalid
    bHaveValue = (*a_pData == '=');
    if (!bHaveValue && !m_bAllowKeyOnly) {
      continue;
    }
 
    // empty keys are invalid
    if (bHaveValue && a_pKey == a_pData) {
      while (*a_pData && !IsNewLineChar(*a_pData)) {
        ++a_pData;
      }
      continue;
    }
 
    // remove trailing spaces from the key
    pTrail = a_pData - 1;
    while (pTrail >= a_pKey && IsSpace(*pTrail)) {
      --pTrail;
    }
    ++pTrail;
 
    if (bHaveValue) {
      // process the value
      *pTrail = 0;
 
      // skip leading whitespace on the value
      ++a_pData; // safe as checked that it == '=' above
      while (*a_pData && !IsNewLineChar(*a_pData) && IsSpace(*a_pData)) {
        ++a_pData;
      }
 
      // find the end of the value which is the end of this line
      a_pVal = a_pData;
      while (*a_pData && !IsNewLineChar(*a_pData)) {
        ++a_pData;
      }
 
      // remove trailing spaces from the value
      pTrail = a_pData - 1;
      if (*a_pData) { // prepare for the next round
        SkipNewLine(a_pData);
      }
      while (pTrail >= a_pVal && IsSpace(*pTrail)) {
        --pTrail;
      }
      ++pTrail;
      *pTrail = 0;
 
      // check for multi-line entries
      if (m_bAllowMultiLine && IsMultiLineTag(a_pVal)) {
        // skip the "<<<" to get the tag that will end the multiline
        const SI_CHAR *pTagName = a_pVal + 3;
        return LoadMultiLineText(a_pData, a_pVal, pTagName);
      }
 
      // check for quoted values, we are not supporting escapes in quoted values (yet)
      if (m_bParseQuotes) {
        --pTrail;
        if (pTrail > a_pVal && *a_pVal == '"' && *pTrail == '"') {
          ++a_pVal;
          *pTrail = 0;
        }
      }
    } else {
      // no value to process, just prepare for the next
      if (*a_pData) {
        SkipNewLine(a_pData);
      }
      *pTrail = 0;
    }
 
    // return the standard entry
    return true;
  }
 
  return false;
}
 
template <class SI_CHAR, class SI_STRLESS, class SI_CONVERTER>
bool CSimpleIniTempl<SI_CHAR, SI_STRLESS, SI_CONVERTER>::IsMultiLineTag(
    const SI_CHAR *a_pVal) const {
  // check for the "<<<" prefix for a multi-line entry
  if (*a_pVal++ != '<')
    return false;
  if (*a_pVal++ != '<')
    return false;
  if (*a_pVal++ != '<')
    return false;
  return true;
}
 
template <class SI_CHAR, class SI_STRLESS, class SI_CONVERTER>
bool CSimpleIniTempl<SI_CHAR, SI_STRLESS, SI_CONVERTER>::IsMultiLineData(
    const SI_CHAR *a_pData) const {
  // data is multi-line if it has any of the following features:
  //  * whitespace prefix
  //  * embedded newlines
  //  * whitespace suffix
 
  // empty string
  if (!*a_pData) {
    return false;
  }
 
  // check for prefix
  if (IsSpace(*a_pData)) {
    return true;
  }
 
  // embedded newlines
  const SI_CHAR *pStart = a_pData;
  while (*a_pData) {
    if (IsNewLineChar(*a_pData)) {
      return true;
    }
    ++a_pData;
  }
 
  // check for suffix (ensure we don't go before start of string)
  if (a_pData > pStart && IsSpace(*(a_pData - 1))) {
    return true;
  }
 
  return false;
}
 
template <class SI_CHAR, class SI_STRLESS, class SI_CONVERTER>
bool CSimpleIniTempl<SI_CHAR, SI_STRLESS, SI_CONVERTER>::
    IsSingleLineQuotedValue(const SI_CHAR *a_pData) const {
  // data needs quoting if it starts or ends with whitespace
  // and doesn't have embedded newlines
 
  // empty string
  if (!*a_pData) {
    return false;
  }
 
  // check for prefix
  if (IsSpace(*a_pData)) {
    return true;
  }
 
  // embedded newlines
  const SI_CHAR *pStart = a_pData;
  while (*a_pData) {
    if (IsNewLineChar(*a_pData)) {
      return false;
    }
    ++a_pData;
  }
 
  // check for suffix (ensure we don't go before start of string)
  if (a_pData > pStart && IsSpace(*(a_pData - 1))) {
    return true;
  }
 
  return false;
}
 
template <class SI_CHAR, class SI_STRLESS, class SI_CONVERTER>
bool CSimpleIniTempl<SI_CHAR, SI_STRLESS, SI_CONVERTER>::IsNewLineChar(
    SI_CHAR a_c) const {
  return (a_c == '\n' || a_c == '\r');
}
 
template <class SI_CHAR, class SI_STRLESS, class SI_CONVERTER>
bool CSimpleIniTempl<SI_CHAR, SI_STRLESS, SI_CONVERTER>::LoadMultiLineText(
    SI_CHAR *&a_pData, const SI_CHAR *&a_pVal, const SI_CHAR *a_pTagName,
    bool a_bAllowBlankLinesInComment) const {
  // we modify this data to strip all newlines down to a single '\n'
  // character. This means that on Windows we need to strip out some
  // characters which will make the data shorter.
  // i.e.  LINE1-LINE1\r\nLINE2-LINE2\0 will become
  //       LINE1-LINE1\nLINE2-LINE2\0
  // The pDataLine entry is the pointer to the location in memory that
  // the current line needs to start to run following the existing one.
  // This may be the same as pCurrLine in which case no move is needed.
  SI_CHAR *pDataLine = a_pData;
  SI_CHAR *pCurrLine;
 
  // value starts at the current line
  a_pVal = a_pData;
 
  // find the end tag. This tag must start in column 1 and be
  // followed by a newline. We ignore any whitespace after the end
  // tag but not whitespace before it.
  SI_CHAR cEndOfLineChar = *a_pData;
  for (;;) {
    // if we are loading comments then we need a comment character as
    // the first character on every line
    if (!a_pTagName && !IsComment(*a_pData)) {
      // if we aren't allowing blank lines then we're done
      if (!a_bAllowBlankLinesInComment) {
        break;
      }
 
      // if we are allowing blank lines then we only include them
      // in this comment if another comment follows, so read ahead
      // to find out.
      SI_CHAR *pCurr = a_pData;
      int nNewLines = 0;
      while (IsSpace(*pCurr)) {
        if (IsNewLineChar(*pCurr)) {
          ++nNewLines;
          SkipNewLine(pCurr);
        } else {
          ++pCurr;
        }
      }
 
      // we have a comment, add the blank lines to the output
      // and continue processing from here
      if (IsComment(*pCurr)) {
        for (; nNewLines > 0; --nNewLines)
          *pDataLine++ = '\n';
        a_pData = pCurr;
        continue;
      }
 
      // the comment ends here
      break;
    }
 
    // find the end of this line
    pCurrLine = a_pData;
    while (*a_pData && !IsNewLineChar(*a_pData))
      ++a_pData;
 
    // move this line down to the location that it should be if necessary
    if (pDataLine < pCurrLine) {
      size_t nLen = (size_t)(a_pData - pCurrLine);
      memmove(pDataLine, pCurrLine, nLen * sizeof(SI_CHAR));
      pDataLine[nLen] = '\0';
    }
 
    // end the line with a NULL
    cEndOfLineChar = *a_pData;
    *a_pData = 0;
 
    // if are looking for a tag then do the check now. This is done before
    // checking for end of the data, so that if we have the tag at the end
    // of the data then the tag is removed correctly.
    if (a_pTagName) {
      // strip whitespace from the end of this tag
      SI_CHAR *pc = a_pData - 1;
      while (pc > pDataLine && IsSpace(*pc))
        --pc;
      SI_CHAR ch = *++pc;
      *pc = 0;
 
      if (!IsLess(pDataLine, a_pTagName) && !IsLess(a_pTagName, pDataLine)) {
        break;
      }
 
      *pc = ch;
    }
 
    // if we are at the end of the data then we just automatically end
    // this entry and return the current data.
    if (!cEndOfLineChar) {
      return true;
    }
 
    // otherwise we need to process this newline to ensure that it consists
    // of just a single \n character.
    pDataLine += (a_pData - pCurrLine);
    *a_pData = cEndOfLineChar;
    SkipNewLine(a_pData);
    *pDataLine++ = '\n';
  }
 
  // if we didn't find a comment at all then return false
  if (a_pVal == a_pData) {
    a_pVal = NULL;
    return false;
  }
 
  // the data (which ends at the end of the last line) needs to be
  // null-terminated BEFORE before the newline character(s). If the
  // user wants a new line in the multi-line data then they need to
  // add an empty line before the tag.
  *--pDataLine = '\0';
 
  // if looking for a tag and if we aren't at the end of the data,
  // then move a_pData to the start of the next line.
  if (a_pTagName && cEndOfLineChar) {
    SI_ASSERT(IsNewLineChar(cEndOfLineChar));
    *a_pData = cEndOfLineChar;
    SkipNewLine(a_pData);
  }
 
  return true;
}
 
template <class SI_CHAR, class SI_STRLESS, class SI_CONVERTER>
SI_Error CSimpleIniTempl<SI_CHAR, SI_STRLESS, SI_CONVERTER>::CopyString(
    const SI_CHAR *&a_pString) {
  size_t uLen = 0;
  if (sizeof(SI_CHAR) == sizeof(char)) {
    uLen = strlen((const char *)a_pString);
  } else if (sizeof(SI_CHAR) == sizeof(wchar_t)) {
    uLen = wcslen((const wchar_t *)a_pString);
  } else {
    for (; a_pString[uLen]; ++uLen) /*loop*/
      ;
  }
  if (uLen >= (SI_MAX_FILE_SIZE / sizeof(SI_CHAR))) {
    return SI_NOMEM;
  }
  ++uLen; // NULL character
  SI_CHAR *pCopy = new (std::nothrow) SI_CHAR[uLen];
  if (!pCopy) {
    return SI_NOMEM;
  }
  memcpy(pCopy, a_pString, sizeof(SI_CHAR) * uLen);
  m_strings.push_back(pCopy);
  a_pString = pCopy;
  return SI_OK;
}
 
template <class SI_CHAR, class SI_STRLESS, class SI_CONVERTER>
void CSimpleIniTempl<SI_CHAR, SI_STRLESS, SI_CONVERTER>::
    UndoIncrementalLoadData(const TNamesDepend &a_oAddedSections,
                            const TNamesDepend &a_oAddedKeys) {
  typename TNamesDepend::const_iterator iAddedKey = a_oAddedKeys.begin();
  for (; iAddedKey != a_oAddedKeys.end(); ++iAddedKey) {
    Delete(iAddedKey->pComment, iAddedKey->pItem, false);
  }
 
  typename TNamesDepend::const_iterator iAddedSection =
      a_oAddedSections.begin();
  for (; iAddedSection != a_oAddedSections.end(); ++iAddedSection) {
    Delete(iAddedSection->pItem, NULL, false);
  }
}
 
template <class SI_CHAR, class SI_STRLESS, class SI_CONVERTER>
SI_Error CSimpleIniTempl<SI_CHAR, SI_STRLESS, SI_CONVERTER>::AddEntry(
    const SI_CHAR *a_pSection, const SI_CHAR *a_pKey, const SI_CHAR *a_pValue,
    const SI_CHAR *a_pComment, bool a_bForceReplace, bool a_bCopyStrings) {
  SI_Error rc;
  bool bInserted = false;
 
  SI_ASSERT(!a_pComment || IsComment(*a_pComment));
 
  // if we are copying strings then make a copy of the comment now
  // because we will need it when we add the entry.
  if (a_bCopyStrings && a_pComment) {
    rc = CopyString(a_pComment);
    if (rc < 0)
      return rc;
  }
 
  // create the section entry if necessary
  typename TSection::iterator iSection = m_data.find(a_pSection);
  if (iSection == m_data.end()) {
    // if the section doesn't exist then we need a copy as the
    // string needs to last beyond the end of this function
    if (a_bCopyStrings) {
      rc = CopyString(a_pSection);
      if (rc < 0)
        return rc;
    }
 
    // only set the comment if this is a section only entry
    Entry oSection(a_pSection, ++m_nOrder);
    if (a_pComment && !a_pKey) {
      oSection.pComment = a_pComment;
    }
 
    typename TSection::value_type oEntry(oSection, TKeyVal());
    typedef typename TSection::iterator SectionIterator;
    std::pair<SectionIterator, bool> i = m_data.insert(oEntry);
    iSection = i.first;
    bInserted = true;
  }
  if (!a_pKey) {
    // section only entries are specified with pItem as NULL
    return bInserted ? SI_INSERTED : SI_UPDATED;
  }
 
  // check for existence of the key
  TKeyVal &keyval = iSection->second;
  typename TKeyVal::iterator iKey = keyval.find(a_pKey);
  bInserted = iKey == keyval.end();
 
  // remove all existing entries but save the load order and
  // comment of the first entry
  int nLoadOrder = ++m_nOrder;
  if (iKey != keyval.end() && m_bAllowMultiKey && a_bForceReplace) {
    const SI_CHAR *pComment = NULL;
    while (iKey != keyval.end() && !IsLess(a_pKey, iKey->first.pItem)) {
      if (iKey->first.nOrder < nLoadOrder) {
        nLoadOrder = iKey->first.nOrder;
        pComment = iKey->first.pComment;
      }
      ++iKey;
    }
    if (pComment) {
      DeleteString(a_pComment);
      a_pComment = pComment;
      rc = CopyString(a_pComment);
      if (rc < 0)
        return rc;
    }
    Delete(a_pSection, a_pKey);
    iKey = keyval.end();
  }
 
  // values need to be a valid string, even if they are an empty string
  if (!a_pValue) {
    a_pValue = &m_cEmptyString;
  }
 
  // make string copies if necessary
  bool bForceCreateNewKey = m_bAllowMultiKey && !a_bForceReplace;
  if (a_bCopyStrings) {
    if (bForceCreateNewKey || iKey == keyval.end()) {
      // if the key doesn't exist then we need a copy as the
      // string needs to last beyond the end of this function
      // because we will be inserting the key next
      rc = CopyString(a_pKey);
      if (rc < 0)
        return rc;
    }
 
    // we always need a copy of the value
    rc = CopyString(a_pValue);
    if (rc < 0)
      return rc;
  }
 
  // create the key entry
  if (iKey == keyval.end() || bForceCreateNewKey) {
    Entry oKey(a_pKey, nLoadOrder);
    if (a_pComment) {
      oKey.pComment = a_pComment;
    }
    typename TKeyVal::value_type oEntry(oKey,
                                        static_cast<const SI_CHAR *>(NULL));
    iKey = keyval.insert(oEntry);
  } else {
    DeleteString(iKey->second);
  }
 
  iKey->second = a_pValue;
  return bInserted ? SI_INSERTED : SI_UPDATED;
}
 
template <class SI_CHAR, class SI_STRLESS, class SI_CONVERTER>
const SI_CHAR *CSimpleIniTempl<SI_CHAR, SI_STRLESS, SI_CONVERTER>::GetValue(
    const SI_CHAR *a_pSection, const SI_CHAR *a_pKey, const SI_CHAR *a_pDefault,
    bool *a_pHasMultiple) const {
  if (a_pHasMultiple) {
    *a_pHasMultiple = false;
  }
  if (!a_pSection || !a_pKey) {
    return a_pDefault;
  }
  typename TSection::const_iterator iSection = m_data.find(a_pSection);
  if (iSection == m_data.end()) {
    return a_pDefault;
  }
  typename TKeyVal::const_iterator iKeyVal = iSection->second.find(a_pKey);
  if (iKeyVal == iSection->second.end()) {
    return a_pDefault;
  }
 
  // check for multiple entries with the same key
  if (m_bAllowMultiKey && a_pHasMultiple) {
    typename TKeyVal::const_iterator iTemp = iKeyVal;
    if (++iTemp != iSection->second.end()) {
      if (!IsLess(a_pKey, iTemp->first.pItem)) {
        *a_pHasMultiple = true;
      }
    }
  }
 
  return iKeyVal->second;
}
 
template <class SI_CHAR, class SI_STRLESS, class SI_CONVERTER>
long CSimpleIniTempl<SI_CHAR, SI_STRLESS, SI_CONVERTER>::GetLongValue(
    const SI_CHAR *a_pSection, const SI_CHAR *a_pKey, long a_nDefault,
    bool *a_pHasMultiple) const {
  // return the default if we don't have a value
  const SI_CHAR *pszValue = GetValue(a_pSection, a_pKey, NULL, a_pHasMultiple);
  if (!pszValue || !*pszValue)
    return a_nDefault;
 
  // convert to UTF-8/MBCS which for a numeric value will be the same as ASCII
  char szValue[64] = {0};
  SI_CONVERTER c(m_bStoreIsUtf8);
  if (!c.ConvertToStore(pszValue, szValue, sizeof(szValue))) {
    return a_nDefault;
  }
 
  // handle the value as hex if prefaced with "0x"
  long nValue = a_nDefault;
  char *pszSuffix = szValue;
  if (szValue[0] == '0' && (szValue[1] == 'x' || szValue[1] == 'X')) {
    if (!szValue[2])
      return a_nDefault;
    nValue = strtol(&szValue[2], &pszSuffix, 16);
  } else {
    nValue = strtol(szValue, &pszSuffix, 10);
  }
 
  // any invalid strings will return the default value
  if (*pszSuffix) {
    return a_nDefault;
  }
 
  return nValue;
}
 
template <class SI_CHAR, class SI_STRLESS, class SI_CONVERTER>
SI_Error CSimpleIniTempl<SI_CHAR, SI_STRLESS, SI_CONVERTER>::SetLongValue(
    const SI_CHAR *a_pSection, const SI_CHAR *a_pKey, long a_nValue,
    const SI_CHAR *a_pComment, bool a_bUseHex, bool a_bForceReplace) {
  // use SetValue to create sections
  if (!a_pSection || !a_pKey)
    return SI_FAIL;
 
  // convert to an ASCII string
  char szInput[64];
#if __STDC_WANT_SECURE_LIB__ && !_WIN32_WCE
  sprintf_s(szInput, a_bUseHex ? "0x%lx" : "%ld", a_nValue);
#else  // !__STDC_WANT_SECURE_LIB__
  snprintf(szInput, sizeof(szInput), a_bUseHex ? "0x%lx" : "%ld", a_nValue);
#endif // __STDC_WANT_SECURE_LIB__
 
  // convert to output text
  SI_CHAR szOutput[64];
  SI_CONVERTER c(m_bStoreIsUtf8);
  if (!c.ConvertFromStore(szInput, strlen(szInput) + 1, szOutput,
                          sizeof(szOutput) / sizeof(SI_CHAR))) {
    return SI_FAIL;
  }
 
  // actually add it
  return AddEntry(a_pSection, a_pKey, szOutput, a_pComment, a_bForceReplace,
                  true);
}
 
template <class SI_CHAR, class SI_STRLESS, class SI_CONVERTER>
double CSimpleIniTempl<SI_CHAR, SI_STRLESS, SI_CONVERTER>::GetDoubleValue(
    const SI_CHAR *a_pSection, const SI_CHAR *a_pKey, double a_nDefault,
    bool *a_pHasMultiple) const {
  // return the default if we don't have a value
  const SI_CHAR *pszValue = GetValue(a_pSection, a_pKey, NULL, a_pHasMultiple);
  if (!pszValue || !*pszValue)
    return a_nDefault;
 
  // convert to UTF-8/MBCS which for a numeric value will be the same as ASCII
  char szValue[64] = {0};
  SI_CONVERTER c(m_bStoreIsUtf8);
  if (!c.ConvertToStore(pszValue, szValue, sizeof(szValue))) {
    return a_nDefault;
  }
 
  char *pszSuffix = szValue;
  double nValue = strtod(szValue, &pszSuffix);
 
  // any invalid strings will return the default value
  // check if no conversion was performed or if there are trailing characters
  if (pszSuffix == szValue || *pszSuffix) {
    return a_nDefault;
  }
 
  return nValue;
}
 
template <class SI_CHAR, class SI_STRLESS, class SI_CONVERTER>
SI_Error CSimpleIniTempl<SI_CHAR, SI_STRLESS, SI_CONVERTER>::SetDoubleValue(
    const SI_CHAR *a_pSection, const SI_CHAR *a_pKey, double a_nValue,
    const SI_CHAR *a_pComment, bool a_bForceReplace) {
  // use SetValue to create sections
  if (!a_pSection || !a_pKey)
    return SI_FAIL;
 
  // convert to an ASCII string
  char szInput[64];
#if __STDC_WANT_SECURE_LIB__ && !_WIN32_WCE
  sprintf_s(szInput, "%f", a_nValue);
#else  // !__STDC_WANT_SECURE_LIB__
  snprintf(szInput, sizeof(szInput), "%f", a_nValue);
#endif // __STDC_WANT_SECURE_LIB__
 
  // convert to output text
  SI_CHAR szOutput[64];
  SI_CONVERTER c(m_bStoreIsUtf8);
  if (!c.ConvertFromStore(szInput, strlen(szInput) + 1, szOutput,
                          sizeof(szOutput) / sizeof(SI_CHAR))) {
    return SI_FAIL;
  }
 
  // actually add it
  return AddEntry(a_pSection, a_pKey, szOutput, a_pComment, a_bForceReplace,
                  true);
}
 
template <class SI_CHAR, class SI_STRLESS, class SI_CONVERTER>
bool CSimpleIniTempl<SI_CHAR, SI_STRLESS, SI_CONVERTER>::GetBoolValue(
    const SI_CHAR *a_pSection, const SI_CHAR *a_pKey, bool a_bDefault,
    bool *a_pHasMultiple) const {
  // return the default if we don't have a value
  const SI_CHAR *pszValue = GetValue(a_pSection, a_pKey, NULL, a_pHasMultiple);
  if (!pszValue || !*pszValue)
    return a_bDefault;
 
  // we only look at the minimum number of characters
  switch (pszValue[0]) {
  case 't':
  case 'T': // true
  case 'y':
  case 'Y': // yes
  case '1': // 1 (one)
    return true;
 
  case 'f':
  case 'F': // false
  case 'n':
  case 'N': // no
  case '0': // 0 (zero)
    return false;
 
  case 'o':
  case 'O':
    if (pszValue[1] == 'n' || pszValue[1] == 'N')
      return true; // on
    if (pszValue[1] == 'f' || pszValue[1] == 'F')
      return false; // off
    break;
  }
 
  // no recognized value, return the default
  return a_bDefault;
}
 
template <class SI_CHAR, class SI_STRLESS, class SI_CONVERTER>
SI_Error CSimpleIniTempl<SI_CHAR, SI_STRLESS, SI_CONVERTER>::SetBoolValue(
    const SI_CHAR *a_pSection, const SI_CHAR *a_pKey, bool a_bValue,
    const SI_CHAR *a_pComment, bool a_bForceReplace) {
  // use SetValue to create sections
  if (!a_pSection || !a_pKey)
    return SI_FAIL;
 
  // convert to an ASCII string
  const char *pszInput = a_bValue ? "true" : "false";
 
  // convert to output text
  SI_CHAR szOutput[64];
  SI_CONVERTER c(m_bStoreIsUtf8);
  if (!c.ConvertFromStore(pszInput, strlen(pszInput) + 1, szOutput,
                          sizeof(szOutput) / sizeof(SI_CHAR))) {
    return SI_FAIL;
  }
 
  // actually add it
  return AddEntry(a_pSection, a_pKey, szOutput, a_pComment, a_bForceReplace,
                  true);
}
 
template <class SI_CHAR, class SI_STRLESS, class SI_CONVERTER>
bool CSimpleIniTempl<SI_CHAR, SI_STRLESS, SI_CONVERTER>::GetAllValues(
    const SI_CHAR *a_pSection, const SI_CHAR *a_pKey,
    TNamesDepend &a_values) const {
  a_values.clear();
 
  if (!a_pSection || !a_pKey) {
    return false;
  }
  typename TSection::const_iterator iSection = m_data.find(a_pSection);
  if (iSection == m_data.end()) {
    return false;
  }
  typename TKeyVal::const_iterator iKeyVal = iSection->second.find(a_pKey);
  if (iKeyVal == iSection->second.end()) {
    return false;
  }
 
  // insert all values for this key
  a_values.push_back(
      Entry(iKeyVal->second, iKeyVal->first.pComment, iKeyVal->first.nOrder));
  if (m_bAllowMultiKey) {
    ++iKeyVal;
    while (iKeyVal != iSection->second.end() &&
           !IsLess(a_pKey, iKeyVal->first.pItem)) {
      a_values.push_back(Entry(iKeyVal->second, iKeyVal->first.pComment,
                               iKeyVal->first.nOrder));
      ++iKeyVal;
    }
  }
 
  return true;
}
 
template <class SI_CHAR, class SI_STRLESS, class SI_CONVERTER>
int CSimpleIniTempl<SI_CHAR, SI_STRLESS, SI_CONVERTER>::GetSectionSize(
    const SI_CHAR *a_pSection) const {
  if (!a_pSection) {
    return -1;
  }
 
  typename TSection::const_iterator iSection = m_data.find(a_pSection);
  if (iSection == m_data.end()) {
    return -1;
  }
  const TKeyVal &section = iSection->second;
 
  // if multi-key isn't permitted then the section size is
  // the number of keys that we have.
  if (!m_bAllowMultiKey || section.empty()) {
    return (int)section.size();
  }
 
  // otherwise we need to count them
  int nCount = 0;
  const SI_CHAR *pLastKey = NULL;
  typename TKeyVal::const_iterator iKeyVal = section.begin();
  for (; iKeyVal != section.end(); ++iKeyVal) {
    if (!pLastKey || IsLess(pLastKey, iKeyVal->first.pItem)) {
      ++nCount;
      pLastKey = iKeyVal->first.pItem;
    }
  }
  return nCount;
}
 
template <class SI_CHAR, class SI_STRLESS, class SI_CONVERTER>
const typename CSimpleIniTempl<SI_CHAR, SI_STRLESS, SI_CONVERTER>::TKeyVal *
CSimpleIniTempl<SI_CHAR, SI_STRLESS, SI_CONVERTER>::GetSection(
    const SI_CHAR *a_pSection) const {
  if (a_pSection) {
    typename TSection::const_iterator i = m_data.find(a_pSection);
    if (i != m_data.end()) {
      return &(i->second);
    }
  }
  return 0;
}
 
template <class SI_CHAR, class SI_STRLESS, class SI_CONVERTER>
void CSimpleIniTempl<SI_CHAR, SI_STRLESS, SI_CONVERTER>::GetAllSections(
    TNamesDepend &a_names) const {
  a_names.clear();
  typename TSection::const_iterator i = m_data.begin();
  for (; i != m_data.end(); ++i) {
    a_names.push_back(i->first);
  }
}
 
template <class SI_CHAR, class SI_STRLESS, class SI_CONVERTER>
bool CSimpleIniTempl<SI_CHAR, SI_STRLESS, SI_CONVERTER>::GetAllKeys(
    const SI_CHAR *a_pSection, TNamesDepend &a_names) const {
  a_names.clear();
 
  if (!a_pSection) {
    return false;
  }
 
  typename TSection::const_iterator iSection = m_data.find(a_pSection);
  if (iSection == m_data.end()) {
    return false;
  }
 
  const TKeyVal &section = iSection->second;
  const SI_CHAR *pLastKey = NULL;
  typename TKeyVal::const_iterator iKeyVal = section.begin();
  for (; iKeyVal != section.end(); ++iKeyVal) {
    if (!pLastKey || IsLess(pLastKey, iKeyVal->first.pItem)) {
      a_names.push_back(iKeyVal->first);
      pLastKey = iKeyVal->first.pItem;
    }
  }
 
  return true;
}
 
template <class SI_CHAR, class SI_STRLESS, class SI_CONVERTER>
SI_Error CSimpleIniTempl<SI_CHAR, SI_STRLESS, SI_CONVERTER>::SaveFile(
    const char *a_pszFile, bool a_bAddSignature) const {
  FILE *fp = NULL;
#if __STDC_WANT_SECURE_LIB__ && !_WIN32_WCE
  fopen_s(&fp, a_pszFile, "wb");
#else  // !__STDC_WANT_SECURE_LIB__
  fp = fopen(a_pszFile, "wb");
#endif // __STDC_WANT_SECURE_LIB__
  if (!fp)
    return SI_FILE;
  SI_Error rc = SaveFile(fp, a_bAddSignature);
  fclose(fp);
  return rc;
}
 
#ifdef SI_HAS_WIDE_FILE
template <class SI_CHAR, class SI_STRLESS, class SI_CONVERTER>
SI_Error CSimpleIniTempl<SI_CHAR, SI_STRLESS, SI_CONVERTER>::SaveFile(
    const SI_WCHAR_T *a_pwszFile, bool a_bAddSignature) const {
#ifdef _WIN32
  FILE *fp = NULL;
#if __STDC_WANT_SECURE_LIB__ && !_WIN32_WCE
  _wfopen_s(&fp, a_pwszFile, L"wb");
#else  // !__STDC_WANT_SECURE_LIB__
  fp = _wfopen(a_pwszFile, L"wb");
#endif // __STDC_WANT_SECURE_LIB__
  if (!fp)
    return SI_FILE;
  SI_Error rc = SaveFile(fp, a_bAddSignature);
  fclose(fp);
  return rc;
#else  // !_WIN32 (therefore SI_CONVERT_ICU)
  char *szFile = NULL;
  SI_Error rcPath = SI_Internal::UCharPathToUtf8(a_pwszFile, szFile);
  if (rcPath < 0) {
    return rcPath;
  }
  SI_Error rc = SaveFile(szFile, a_bAddSignature);
  delete[] szFile;
  return rc;
#endif // _WIN32
}
#endif // SI_HAS_WIDE_FILE
 
template <class SI_CHAR, class SI_STRLESS, class SI_CONVERTER>
SI_Error CSimpleIniTempl<SI_CHAR, SI_STRLESS, SI_CONVERTER>::SaveFile(
    FILE *a_pFile, bool a_bAddSignature) const {
  FileWriter writer(a_pFile);
  return Save(writer, a_bAddSignature);
}
 
template <class SI_CHAR, class SI_STRLESS, class SI_CONVERTER>
SI_Error CSimpleIniTempl<SI_CHAR, SI_STRLESS, SI_CONVERTER>::Save(
    OutputWriter &a_oOutput, bool a_bAddSignature) const {
  Converter convert(m_bStoreIsUtf8);
 
  // add the UTF-8 signature if it is desired
  if (m_bStoreIsUtf8 && a_bAddSignature) {
    a_oOutput.Write(SI_UTF8_SIGNATURE);
  }
 
  // get all of the sections sorted in load order
  TNamesDepend oSections;
  GetAllSections(oSections);
#if defined(_MSC_VER) && _MSC_VER <= 1200
  oSections.sort();
#elif defined(__BORLANDC__)
  oSections.sort(Entry::LoadOrder());
#else
  oSections.sort(typename Entry::LoadOrder());
#endif
 
  // if there is an empty section name, then it must be written out first
  // regardless of the load order
  typename TNamesDepend::iterator is = oSections.begin();
  for (; is != oSections.end(); ++is) {
    if (!*is->pItem) {
      // move the empty section name to the front of the section list
      if (is != oSections.begin()) {
        oSections.splice(oSections.begin(), oSections, is, std::next(is));
      }
      break;
    }
  }
 
  // write the file comment if we have one
  bool bNeedNewLine = false;
  if (m_pFileComment) {
    if (!OutputMultiLineText(a_oOutput, convert, m_pFileComment)) {
      return SI_FAIL;
    }
    bNeedNewLine = true;
  }
 
  // iterate through our sections and output the data
  typename TNamesDepend::const_iterator iSection = oSections.begin();
  for (; iSection != oSections.end(); ++iSection) {
    // write out the comment if there is one
    if (iSection->pComment) {
      if (bNeedNewLine) {
        a_oOutput.Write(SI_NEWLINE_A);
        a_oOutput.Write(SI_NEWLINE_A);
      }
      if (!OutputMultiLineText(a_oOutput, convert, iSection->pComment)) {
        return SI_FAIL;
      }
      bNeedNewLine = false;
    }
 
    if (bNeedNewLine) {
      a_oOutput.Write(SI_NEWLINE_A);
      a_oOutput.Write(SI_NEWLINE_A);
      bNeedNewLine = false;
    }
 
    // write the section (unless there is no section name)
    if (*iSection->pItem) {
      if (!convert.ConvertToStore(iSection->pItem)) {
        return SI_FAIL;
      }
      a_oOutput.Write("[");
      a_oOutput.Write(convert.Data());
      a_oOutput.Write("]");
      a_oOutput.Write(SI_NEWLINE_A);
    }
 
    // get all of the keys sorted in load order
    TNamesDepend oKeys;
    GetAllKeys(iSection->pItem, oKeys);
#if defined(_MSC_VER) && _MSC_VER <= 1200
    oKeys.sort();
#elif defined(__BORLANDC__)
    oKeys.sort(Entry::LoadOrder());
#else
    oKeys.sort(typename Entry::LoadOrder());
#endif
 
    // write all keys and values
    typename TNamesDepend::const_iterator iKey = oKeys.begin();
    for (; iKey != oKeys.end(); ++iKey) {
      // get all values for this key
      TNamesDepend oValues;
      GetAllValues(iSection->pItem, iKey->pItem, oValues);
 
      typename TNamesDepend::const_iterator iValue = oValues.begin();
      for (; iValue != oValues.end(); ++iValue) {
        // write out the comment if there is one
        if (iValue->pComment) {
          a_oOutput.Write(SI_NEWLINE_A);
          if (!OutputMultiLineText(a_oOutput, convert, iValue->pComment)) {
            return SI_FAIL;
          }
        }
 
        // write the key
        if (!convert.ConvertToStore(iKey->pItem)) {
          return SI_FAIL;
        }
        a_oOutput.Write(convert.Data());
 
        // write the value as long
        if (*iValue->pItem || !m_bAllowKeyOnly) {
          if (!convert.ConvertToStore(iValue->pItem)) {
            return SI_FAIL;
          }
          a_oOutput.Write(m_bSpaces ? " = " : "=");
          if (m_bParseQuotes && IsSingleLineQuotedValue(iValue->pItem)) {
            // the only way to preserve external whitespace on a value (i.e. before or after)
            // is to quote it. This is simple quoting, we don't escape quotes within the data.
            a_oOutput.Write("\"");
            a_oOutput.Write(convert.Data());
            a_oOutput.Write("\"");
          } else if (m_bAllowMultiLine && IsMultiLineData(iValue->pItem)) {
            // multi-line data needs to be processed specially to ensure
            // that we use the correct newline format for the current system
            a_oOutput.Write("<<<END_OF_TEXT" SI_NEWLINE_A);
            if (!OutputMultiLineText(a_oOutput, convert, iValue->pItem)) {
              return SI_FAIL;
            }
            a_oOutput.Write("END_OF_TEXT");
          } else {
            a_oOutput.Write(convert.Data());
          }
        }
        a_oOutput.Write(SI_NEWLINE_A);
      }
    }
 
    bNeedNewLine = true;
  }
 
  return SI_OK;
}
 
template <class SI_CHAR, class SI_STRLESS, class SI_CONVERTER>
bool CSimpleIniTempl<SI_CHAR, SI_STRLESS, SI_CONVERTER>::OutputMultiLineText(
    OutputWriter &a_oOutput, Converter &a_oConverter,
    const SI_CHAR *a_pText) const {
  const SI_CHAR *pEndOfLine;
  SI_CHAR cEndOfLineChar = *a_pText;
  while (cEndOfLineChar) {
    // find the end of this line
    pEndOfLine = a_pText;
    for (; *pEndOfLine && *pEndOfLine != '\n'; ++pEndOfLine) /*loop*/
      ;
    cEndOfLineChar = *pEndOfLine;
 
    const std::basic_string<SI_CHAR> line(
        a_pText, static_cast<size_t>(pEndOfLine - a_pText));
    if (!a_oConverter.ConvertToStore(line.c_str())) {
      return false;
    }
    a_pText += (pEndOfLine - a_pText) + 1;
    a_oOutput.Write(a_oConverter.Data());
    a_oOutput.Write(SI_NEWLINE_A);
  }
  return true;
}
 
template <class SI_CHAR, class SI_STRLESS, class SI_CONVERTER>
bool CSimpleIniTempl<SI_CHAR, SI_STRLESS, SI_CONVERTER>::Delete(
    const SI_CHAR *a_pSection, const SI_CHAR *a_pKey, bool a_bRemoveEmpty) {
  return DeleteValue(a_pSection, a_pKey, NULL, a_bRemoveEmpty);
}
 
template <class SI_CHAR, class SI_STRLESS, class SI_CONVERTER>
bool CSimpleIniTempl<SI_CHAR, SI_STRLESS, SI_CONVERTER>::DeleteValue(
    const SI_CHAR *a_pSection, const SI_CHAR *a_pKey, const SI_CHAR *a_pValue,
    bool a_bRemoveEmpty) {
  if (!a_pSection) {
    return false;
  }
 
  typename TSection::iterator iSection = m_data.find(a_pSection);
  if (iSection == m_data.end()) {
    return false;
  }
 
  // remove a single key if we have a keyname
  if (a_pKey) {
    typename TKeyVal::iterator iKeyVal = iSection->second.find(a_pKey);
    if (iKeyVal == iSection->second.end()) {
      return false;
    }
 
    const static SI_STRLESS isLess = SI_STRLESS();
 
    // remove any copied strings and then the key
    typename TKeyVal::iterator iDelete;
    bool bDeleted = false;
    do {
      iDelete = iKeyVal++;
 
      if (a_pValue == NULL || (isLess(a_pValue, iDelete->second) == false &&
                               isLess(iDelete->second, a_pValue) == false)) {
        DeleteString(iDelete->first.pItem);
        DeleteString(iDelete->first.pComment);
        DeleteString(iDelete->second);
        iSection->second.erase(iDelete);
        bDeleted = true;
      }
    } while (iKeyVal != iSection->second.end() &&
             !IsLess(a_pKey, iKeyVal->first.pItem));
 
    if (!bDeleted) {
      return false;
    }
 
    // done now if the section is not empty or we are not pruning away
    // the empty sections. Otherwise let it fall through into the section
    // deletion code
    if (!a_bRemoveEmpty || !iSection->second.empty()) {
      return true;
    }
  } else {
    // delete all copied strings from this section. The actual
    // entries will be removed when the section is removed.
    typename TKeyVal::iterator iKeyVal = iSection->second.begin();
    for (; iKeyVal != iSection->second.end(); ++iKeyVal) {
      DeleteString(iKeyVal->first.pItem);
      DeleteString(iKeyVal->first.pComment);
      DeleteString(iKeyVal->second);
    }
  }
 
  // delete the section itself
  DeleteString(iSection->first.pItem);
  DeleteString(iSection->first.pComment);
  m_data.erase(iSection);
 
  return true;
}
 
template <class SI_CHAR, class SI_STRLESS, class SI_CONVERTER>
void CSimpleIniTempl<SI_CHAR, SI_STRLESS, SI_CONVERTER>::DeleteString(
    const SI_CHAR *a_pString) {
  if (!a_pString) {
    return;
  }
  // strings may exist either inside the data block, or they will be
  // individually allocated and stored in m_strings. We only physically
  // delete those stored in m_strings.
  if (!m_pData || a_pString < m_pData || a_pString >= m_pData + m_uDataLen) {
    typename TNamesDepend::iterator i = m_strings.begin();
    for (; i != m_strings.end(); ++i) {
      if (a_pString == i->pItem) {
        delete[] const_cast<SI_CHAR *>(i->pItem);
        m_strings.erase(i);
        break;
      }
    }
  }
}
 
// ---------------------------------------------------------------------------
//                              CONVERSION FUNCTIONS
// ---------------------------------------------------------------------------
 
// Defines the conversion classes for different libraries. Before including
// SimpleIni.h, set the converter that you wish you use by defining one of the
// following symbols.
//
//  SI_NO_CONVERSION        Do not make the "W" wide character version of the
//                          library available. Only CSimpleIniA etc is defined.
//                          Default on Linux/MacOS/etc.
//  SI_CONVERT_WIN32        Use the Win32 API functions for conversion.
//                          Default on Windows.
//  SI_CONVERT_GENERIC      Use built-in locale-independent UTF-8 conversion
//                          (no additional source files required)
//  SI_CONVERT_ICU          Use the IBM ICU conversion library. Requires
//                          ICU headers on include path and icuuc.lib
 
#if !defined(SI_NO_CONVERSION) && !defined(SI_CONVERT_GENERIC) &&              \
    !defined(SI_CONVERT_WIN32) && !defined(SI_CONVERT_ICU)
#ifdef _WIN32
#define SI_CONVERT_WIN32
#else
#define SI_NO_CONVERSION
#endif
#endif
 
template <class SI_CHAR> struct SI_GenericCase {
  bool operator()(const SI_CHAR *pLeft, const SI_CHAR *pRight) const {
    long cmp;
    for (; *pLeft && *pRight; ++pLeft, ++pRight) {
      cmp = (long)*pLeft - (long)*pRight;
      if (cmp != 0) {
        return cmp < 0;
      }
    }
    return *pRight != 0;
  }
};
 
template <class SI_CHAR> struct SI_GenericNoCase {
  inline SI_CHAR locase(SI_CHAR ch) const {
    return (ch < 'A' || ch > 'Z') ? ch : (ch - 'A' + 'a');
  }
  bool operator()(const SI_CHAR *pLeft, const SI_CHAR *pRight) const {
    long cmp;
    for (; *pLeft && *pRight; ++pLeft, ++pRight) {
      cmp = (long)locase(*pLeft) - (long)locase(*pRight);
      if (cmp != 0) {
        return cmp < 0;
      }
    }
    return *pRight != 0;
  }
};
 
template <class SI_CHAR> class SI_ConvertA {
  bool m_bStoreIsUtf8;
 
protected:
  SI_ConvertA() {}
 
public:
  SI_ConvertA(bool a_bStoreIsUtf8) : m_bStoreIsUtf8(a_bStoreIsUtf8) {}
 
  /* copy and assignment */
  SI_ConvertA(const SI_ConvertA &rhs) { operator=(rhs); }
  SI_ConvertA &operator=(const SI_ConvertA &rhs) {
    m_bStoreIsUtf8 = rhs.m_bStoreIsUtf8;
    return *this;
  }
 
  size_t SizeFromStore(const char *a_pInputData, size_t a_uInputDataLen) {
    (void)a_pInputData;
    SI_ASSERT(a_uInputDataLen != (size_t)-1);
 
    // ASCII/MBCS/UTF-8 needs no conversion
    return a_uInputDataLen;
  }
 
  bool ConvertFromStore(const char *a_pInputData, size_t a_uInputDataLen,
                        SI_CHAR *a_pOutputData, size_t a_uOutputDataSize) {
    // ASCII/MBCS/UTF-8 needs no conversion
    if (a_uInputDataLen > a_uOutputDataSize) {
      return false;
    }
    memcpy(a_pOutputData, a_pInputData, a_uInputDataLen);
    return true;
  }
 
  size_t SizeToStore(const SI_CHAR *a_pInputData) {
    // ASCII/MBCS/UTF-8 needs no conversion
    return strlen((const char *)a_pInputData) + 1;
  }
 
  bool ConvertToStore(const SI_CHAR *a_pInputData, char *a_pOutputData,
                      size_t a_uOutputDataSize) {
    // calc input string length (SI_CHAR type and size independent)
    size_t uInputLen = strlen((const char *)a_pInputData) + 1;
    if (uInputLen > a_uOutputDataSize) {
      return false;
    }
 
    // ascii/UTF-8 needs no conversion
    memcpy(a_pOutputData, a_pInputData, uInputLen);
    return true;
  }
};
 
// ---------------------------------------------------------------------------
//                              SI_CONVERT_GENERIC
// ---------------------------------------------------------------------------
#ifdef SI_CONVERT_GENERIC
 
#define SI_Case SI_GenericCase
#define SI_NoCase SI_GenericNoCase
 
#include <wchar.h>
 
namespace SI_UTF8 {
 
constexpr char32_t REPLACEMENT = 0xFFFD;
 
inline bool Decode(const char *&a_src, const char *a_end, char32_t &a_cp) {
  if (a_src >= a_end) {
    return false;
  }
  const unsigned char c0 = (unsigned char)*a_src++;
  if (c0 < 0x80) {
    a_cp = c0;
    return true;
  }
  if (c0 < 0xC2) {
    return false;
  }
 
  int extra = 0;
  char32_t ch = 0;
  if (c0 < 0xE0) {
    extra = 1;
    ch = c0 & 0x1F;
  } else if (c0 < 0xF0) {
    extra = 2;
    ch = c0 & 0x0F;
  } else if (c0 < 0xF5) {
    extra = 3;
    ch = c0 & 0x07;
  } else {
    return false;
  }
  if (a_src + extra > a_end) {
    a_src -= 1;
    return false;
  }
 
  for (int i = 0; i < extra; ++i) {
    const unsigned char cx = (unsigned char)*a_src++;
    if ((cx & 0xC0) != 0x80) {
      a_src -= (i + 2);
      return false;
    }
    ch = (ch << 6) | (cx & 0x3F);
  }
 
  if ((extra == 1 && ch < 0x80) || (extra == 2 && ch < 0x800) ||
      (extra == 3 && ch < 0x10000) || ch > 0x10FFFF ||
      (ch >= 0xD800 && ch <= 0xDFFF)) {
    a_src -= (extra + 1);
    return false;
  }
 
  a_cp = ch;
  return true;
}
 
inline int Encode(char32_t a_cp, char *a_dst, size_t a_cap) {
  if (a_cp >= 0x110000 || (a_cp >= 0xD800 && a_cp <= 0xDFFF)) {
    a_cp = REPLACEMENT;
  }
 
  if (a_cp < 0x80) {
    if (a_cap < 1)
      return -1;
    a_dst[0] = (char)a_cp;
    return 1;
  }
  if (a_cp < 0x800) {
    if (a_cap < 2)
      return -1;
    a_dst[0] = (char)(0xC0 | (a_cp >> 6));
    a_dst[1] = (char)(0x80 | (a_cp & 0x3F));
    return 2;
  }
  if (a_cp < 0x10000) {
    if (a_cap < 3)
      return -1;
    a_dst[0] = (char)(0xE0 | (a_cp >> 12));
    a_dst[1] = (char)(0x80 | ((a_cp >> 6) & 0x3F));
    a_dst[2] = (char)(0x80 | (a_cp & 0x3F));
    return 3;
  }
  if (a_cap < 4)
    return -1;
  a_dst[0] = (char)(0xF0 | (a_cp >> 18));
  a_dst[1] = (char)(0x80 | ((a_cp >> 12) & 0x3F));
  a_dst[2] = (char)(0x80 | ((a_cp >> 6) & 0x3F));
  a_dst[3] = (char)(0x80 | (a_cp & 0x3F));
  return 4;
}
 
template <class SI_CHAR>
inline bool AppendCodePoint(char32_t a_cp, SI_CHAR *&a_dst, SI_CHAR *a_dstEnd) {
  if (sizeof(SI_CHAR) >= sizeof(char32_t)) {
    if (a_dst >= a_dstEnd)
      return false;
    *a_dst++ = (SI_CHAR)a_cp;
    return true;
  }
  if (sizeof(SI_CHAR) == 2) {
    if (a_cp < 0x10000) {
      if (a_dst >= a_dstEnd)
        return false;
      *a_dst++ = (SI_CHAR)a_cp;
      return true;
    }
    if (a_dst + 1 >= a_dstEnd)
      return false;
    a_cp -= 0x10000;
    *a_dst++ = (SI_CHAR)(0xD800 + (a_cp >> 10));
    *a_dst++ = (SI_CHAR)(0xDC00 + (a_cp & 0x3FF));
    return true;
  }
  return false;
}
 
template <class SI_CHAR>
inline bool ReadCodePoint(const SI_CHAR *&a_src, char32_t &a_cp) {
  if (sizeof(SI_CHAR) >= sizeof(char32_t)) {
    a_cp = (char32_t)*a_src++;
    return true;
  }
  if (sizeof(SI_CHAR) == 2) {
    const char32_t w = (char32_t)*a_src++;
    if (w >= 0xD800 && w <= 0xDBFF) {
      if (*a_src >= 0xDC00 && *a_src <= 0xDFFF) {
        a_cp = 0x10000 + ((w - 0xD800) << 10) + ((char32_t)*a_src++ - 0xDC00);
        return true;
      }
    }
    a_cp = w;
    return true;
  }
  return false;
}
 
} // namespace SI_UTF8
 
template <class SI_CHAR> class SI_ConvertW {
  bool m_bStoreIsUtf8;
 
protected:
  SI_ConvertW() {}
 
public:
  SI_ConvertW(bool a_bStoreIsUtf8) : m_bStoreIsUtf8(a_bStoreIsUtf8) {}
 
  /* copy and assignment */
  SI_ConvertW(const SI_ConvertW &rhs) { operator=(rhs); }
  SI_ConvertW &operator=(const SI_ConvertW &rhs) {
    m_bStoreIsUtf8 = rhs.m_bStoreIsUtf8;
    return *this;
  }
 
  size_t SizeFromStore(const char *a_pInputData, size_t a_uInputDataLen) {
    SI_ASSERT(a_uInputDataLen != (size_t)-1);
 
    if (m_bStoreIsUtf8) {
      // worst case scenario for UTF-8 to wchar_t is 1 char -> 1 wchar_t
      // so we just return the same number of characters required as for
      // the source text.
      return a_uInputDataLen;
    }
 
    // get the required buffer size
#if defined(_MSC_VER)
    size_t uBufSiz;
    errno_t e = mbstowcs_s(&uBufSiz, NULL, 0, a_pInputData, a_uInputDataLen);
    return (e == 0) ? uBufSiz : (size_t)-1;
#elif !defined(SI_NO_MBSTOWCS_NULL)
    return mbstowcs(NULL, a_pInputData, a_uInputDataLen);
#else
    // fall back processing for platforms that don't support a NULL dest to mbstowcs
    // worst case scenario is 1:1, this will be a sufficient buffer size
    (void)a_pInputData;
    return a_uInputDataLen;
#endif
  }
 
  bool ConvertFromStore(const char *a_pInputData, size_t a_uInputDataLen,
                        SI_CHAR *a_pOutputData, size_t a_uOutputDataSize) {
    if (m_bStoreIsUtf8) {
      const char *src = a_pInputData;
      const char *srcEnd = a_pInputData + a_uInputDataLen;
      SI_CHAR *dst = a_pOutputData;
      SI_CHAR *dstEnd = a_pOutputData + a_uOutputDataSize;
      if (sizeof(SI_CHAR) != 2 && sizeof(SI_CHAR) < sizeof(char32_t)) {
        return false;
      }
      while (src < srcEnd) {
        char32_t cp;
        if (!SI_UTF8::Decode(src, srcEnd, cp)) {
          return false;
        }
        if (!SI_UTF8::AppendCodePoint(cp, dst, dstEnd)) {
          return false;
        }
      }
      return true;
    }
 
    // convert to wchar_t
#if defined(_MSC_VER)
    size_t uBufSiz;
    errno_t e = mbstowcs_s(&uBufSiz, a_pOutputData, a_uOutputDataSize,
                           a_pInputData, a_uInputDataLen);
    (void)uBufSiz;
    return (e == 0);
#else
    size_t retval = mbstowcs(a_pOutputData, a_pInputData, a_uOutputDataSize);
    return retval != (size_t)(-1);
#endif
  }
 
  size_t SizeToStore(const SI_CHAR *a_pInputData) {
    if (m_bStoreIsUtf8) {
      // worst case scenario for wchar_t to UTF-8 is 1 wchar_t -> 6 char
      size_t uLen = 0;
      while (a_pInputData[uLen]) {
        ++uLen;
      }
      return (6 * uLen) + 1;
    } else {
#if defined(_MSC_VER)
      size_t uLen = 0;
      errno_t e = wcstombs_s(&uLen, NULL, 0, a_pInputData, 0);
      if (e != 0) {
        return (size_t)-1;
      }
      return uLen + 1; // include NULL terminator
#else
      size_t uLen = wcstombs(NULL, a_pInputData, 0);
      if (uLen == (size_t)(-1)) {
        return uLen;
      }
      return uLen + 1; // include NULL terminator
#endif
    }
  }
 
  bool ConvertToStore(const SI_CHAR *a_pInputData, char *a_pOutputData,
                      size_t a_uOutputDataSize) {
    if (m_bStoreIsUtf8) {
      const SI_CHAR *src = a_pInputData;
      char *dst = a_pOutputData;
      char *dstEnd = a_pOutputData + a_uOutputDataSize;
      if (sizeof(SI_CHAR) != 2 && sizeof(SI_CHAR) < sizeof(char32_t)) {
        return false;
      }
      while (*src) {
        char32_t cp;
        if (!SI_UTF8::ReadCodePoint(src, cp)) {
          return false;
        }
        char buf[4];
        const int n = SI_UTF8::Encode(cp, buf, sizeof(buf));
        if (n < 0 || (size_t)(dstEnd - dst) < (size_t)n) {
          return false;
        }
        memcpy(dst, buf, (size_t)n);
        dst += n;
      }
      if (dst >= dstEnd) {
        return false;
      }
      *dst = '\0';
      return true;
    } else {
#if defined(_MSC_VER)
      size_t converted = 0;
      errno_t e = wcstombs_s(&converted, a_pOutputData, a_uOutputDataSize,
                             a_pInputData, 0);
      return (e == 0);
#else
      size_t retval = wcstombs(a_pOutputData, a_pInputData, a_uOutputDataSize);
      return retval != (size_t)-1;
#endif
    }
  }
};
 
#endif // SI_CONVERT_GENERIC
 
// ---------------------------------------------------------------------------
//                              SI_CONVERT_ICU
// ---------------------------------------------------------------------------
#ifdef SI_CONVERT_ICU
 
#define SI_Case SI_GenericCase
#define SI_NoCase SI_GenericNoCase
 
#include <unicode/ucnv.h>
 
template <class SI_CHAR> class SI_ConvertW {
  const char *m_pEncoding;
  UConverter *m_pConverter;
 
protected:
  SI_ConvertW() : m_pEncoding(NULL), m_pConverter(NULL) {}
 
public:
  SI_ConvertW(bool a_bStoreIsUtf8) : m_pConverter(NULL) {
    m_pEncoding = a_bStoreIsUtf8 ? "UTF-8" : NULL;
  }
 
  /* copy and assignment */
  SI_ConvertW(const SI_ConvertW &rhs) { operator=(rhs); }
  SI_ConvertW &operator=(const SI_ConvertW &rhs) {
    m_pEncoding = rhs.m_pEncoding;
    m_pConverter = NULL;
    return *this;
  }
  ~SI_ConvertW() {
    if (m_pConverter)
      ucnv_close(m_pConverter);
  }
 
  size_t SizeFromStore(const char *a_pInputData, size_t a_uInputDataLen) {
    SI_ASSERT(a_uInputDataLen != (size_t)-1);
 
    UErrorCode nError;
 
    if (!m_pConverter) {
      nError = U_ZERO_ERROR;
      m_pConverter = ucnv_open(m_pEncoding, &nError);
      if (U_FAILURE(nError)) {
        return (size_t)-1;
      }
    }
 
    nError = U_ZERO_ERROR;
    int32_t nLen = ucnv_toUChars(m_pConverter, NULL, 0, a_pInputData,
                                 (int32_t)a_uInputDataLen, &nError);
    if (U_FAILURE(nError) && nError != U_BUFFER_OVERFLOW_ERROR) {
      return (size_t)-1;
    }
 
    return (size_t)nLen;
  }
 
  bool ConvertFromStore(const char *a_pInputData, size_t a_uInputDataLen,
                        UChar *a_pOutputData, size_t a_uOutputDataSize) {
    UErrorCode nError;
 
    if (!m_pConverter) {
      nError = U_ZERO_ERROR;
      m_pConverter = ucnv_open(m_pEncoding, &nError);
      if (U_FAILURE(nError)) {
        return false;
      }
    }
 
    nError = U_ZERO_ERROR;
    ucnv_toUChars(m_pConverter, a_pOutputData, (int32_t)a_uOutputDataSize,
                  a_pInputData, (int32_t)a_uInputDataLen, &nError);
    if (U_FAILURE(nError)) {
      return false;
    }
 
    return true;
  }
 
  size_t SizeToStore(const UChar *a_pInputData) {
    UErrorCode nError;
 
    if (!m_pConverter) {
      nError = U_ZERO_ERROR;
      m_pConverter = ucnv_open(m_pEncoding, &nError);
      if (U_FAILURE(nError)) {
        return (size_t)-1;
      }
    }
 
    nError = U_ZERO_ERROR;
    int32_t nLen =
        ucnv_fromUChars(m_pConverter, NULL, 0, a_pInputData, -1, &nError);
    if (U_FAILURE(nError) && nError != U_BUFFER_OVERFLOW_ERROR) {
      return (size_t)-1;
    }
 
    return (size_t)nLen + 1;
  }
 
  bool ConvertToStore(const UChar *a_pInputData, char *a_pOutputData,
                      size_t a_uOutputDataSize) {
    UErrorCode nError;
 
    if (!m_pConverter) {
      nError = U_ZERO_ERROR;
      m_pConverter = ucnv_open(m_pEncoding, &nError);
      if (U_FAILURE(nError)) {
        return false;
      }
    }
 
    nError = U_ZERO_ERROR;
    ucnv_fromUChars(m_pConverter, a_pOutputData, (int32_t)a_uOutputDataSize,
                    a_pInputData, -1, &nError);
    if (U_FAILURE(nError)) {
      return false;
    }
 
    return true;
  }
};
 
#endif // SI_CONVERT_ICU
 
// ---------------------------------------------------------------------------
//                              SI_CONVERT_WIN32
// ---------------------------------------------------------------------------
#ifdef SI_CONVERT_WIN32
 
#define SI_Case SI_GenericCase
 
// Windows CE doesn't have errno or MBCS libraries
#ifdef _WIN32_WCE
#ifndef SI_NO_MBCS
#define SI_NO_MBCS
#endif
#endif
 
#include <windows.h>
#ifdef SI_NO_MBCS
#define SI_NoCase SI_GenericNoCase
#else // !SI_NO_MBCS
#include <mbstring.h>
template <class SI_CHAR> struct SI_NoCase {
  bool operator()(const SI_CHAR *pLeft, const SI_CHAR *pRight) const {
    if (sizeof(SI_CHAR) == sizeof(char)) {
      return _mbsicmp((const unsigned char *)pLeft,
                      (const unsigned char *)pRight) < 0;
    }
    if (sizeof(SI_CHAR) == sizeof(wchar_t)) {
      return _wcsicmp((const wchar_t *)pLeft, (const wchar_t *)pRight) < 0;
    }
    return SI_GenericNoCase<SI_CHAR>()(pLeft, pRight);
  }
};
#endif // SI_NO_MBCS
 
template <class SI_CHAR> class SI_ConvertW {
  UINT m_uCodePage;
 
protected:
  SI_ConvertW() {}
 
public:
  SI_ConvertW(bool a_bStoreIsUtf8) {
    m_uCodePage = a_bStoreIsUtf8 ? CP_UTF8 : CP_ACP;
  }
 
  /* copy and assignment */
  SI_ConvertW(const SI_ConvertW &rhs) { operator=(rhs); }
  SI_ConvertW &operator=(const SI_ConvertW &rhs) {
    m_uCodePage = rhs.m_uCodePage;
    return *this;
  }
 
  size_t SizeFromStore(const char *a_pInputData, size_t a_uInputDataLen) {
    SI_ASSERT(a_uInputDataLen != (size_t)-1);
 
    int retval = MultiByteToWideChar(m_uCodePage, 0, a_pInputData,
                                     (int)a_uInputDataLen, 0, 0);
    return (size_t)(retval > 0 ? retval : -1);
  }
 
  bool ConvertFromStore(const char *a_pInputData, size_t a_uInputDataLen,
                        SI_CHAR *a_pOutputData, size_t a_uOutputDataSize) {
    int nSize =
        MultiByteToWideChar(m_uCodePage, 0, a_pInputData, (int)a_uInputDataLen,
                            (wchar_t *)a_pOutputData, (int)a_uOutputDataSize);
    return (nSize > 0);
  }
 
  size_t SizeToStore(const SI_CHAR *a_pInputData) {
    int retval = WideCharToMultiByte(
        m_uCodePage, 0, (const wchar_t *)a_pInputData, -1, 0, 0, 0, 0);
    return (size_t)(retval > 0 ? retval : -1);
  }
 
  bool ConvertToStore(const SI_CHAR *a_pInputData, char *a_pOutputData,
                      size_t a_uOutputDataSize) {
    int retval =
        WideCharToMultiByte(m_uCodePage, 0, (const wchar_t *)a_pInputData, -1,
                            a_pOutputData, (int)a_uOutputDataSize, 0, 0);
    return retval > 0;
  }
};
 
#endif // SI_CONVERT_WIN32
 
// ---------------------------------------------------------------------------
//                              SI_NO_CONVERSION
// ---------------------------------------------------------------------------
#ifdef SI_NO_CONVERSION
 
#define SI_Case SI_GenericCase
#define SI_NoCase SI_GenericNoCase
 
#endif // SI_NO_CONVERSION
 
// ---------------------------------------------------------------------------
//                                  TYPE DEFINITIONS
// ---------------------------------------------------------------------------
 
typedef CSimpleIniTempl<char, SI_NoCase<char>, SI_ConvertA<char>> CSimpleIniA;
typedef CSimpleIniTempl<char, SI_Case<char>, SI_ConvertA<char>> CSimpleIniCaseA;
 
#if defined(SI_NO_CONVERSION)
// if there is no wide char conversion then we don't need to define the
// widechar "W" versions of CSimpleIni
#define CSimpleIni CSimpleIniA
#define CSimpleIniCase CSimpleIniCaseA
#define SI_NEWLINE SI_NEWLINE_A
#else
#if defined(SI_CONVERT_ICU)
typedef CSimpleIniTempl<UChar, SI_NoCase<UChar>, SI_ConvertW<UChar>>
    CSimpleIniW;
typedef CSimpleIniTempl<UChar, SI_Case<UChar>, SI_ConvertW<UChar>>
    CSimpleIniCaseW;
#else
typedef CSimpleIniTempl<wchar_t, SI_NoCase<wchar_t>, SI_ConvertW<wchar_t>>
    CSimpleIniW;
typedef CSimpleIniTempl<wchar_t, SI_Case<wchar_t>, SI_ConvertW<wchar_t>>
    CSimpleIniCaseW;
#endif
 
#ifdef _UNICODE
#define CSimpleIni CSimpleIniW
#define CSimpleIniCase CSimpleIniCaseW
#define SI_NEWLINE SI_NEWLINE_W
#else // !_UNICODE
#define CSimpleIni CSimpleIniA
#define CSimpleIniCase CSimpleIniCaseA
#define SI_NEWLINE SI_NEWLINE_A
#endif // _UNICODE
#endif
 
#ifdef _MSC_VER
#pragma warning(pop)
#endif
 
#endif // INCLUDED_SimpleIni_h