IniSection.hpp

/* IniSection.hpp */
/* $Id: IniSection.hpp,v 1.5 2005/10/27 07:00:46 vlad Exp $ */
#ifndef __IniSection_hpp
#define __IniSection_hpp

#include <mix/misc.h>
#include <mix/Exceptions.h>


class IniSection
{
public:

  IniSection (const char* szSectionType,
          const char* szSectionName);

  IniSection (const char* szTextBlock);

  IniSection (const IniSection& ini_sect);


  virtual ~IniSection ();

  const char*   get_section_type () const;

  const char*   get_section_name () const;

  void      set_section_name (const char* name);

  virtual char*     make_text () const;

  virtual void      parse_text (const char* text,
                    int** err_lines = NULL);

  /*
   * Methods of accessing (NAME, VALUE) pairs
   */

  /* Iteration through all pairs */

  virtual int       count () const;

  virtual const OptionItem* get (int i) const;

  const OptionItem& operator() (int i) const;

  virtual OptionItem*   fetch (int i);

  OptionItem&       operator[] (int i);


  virtual int       n2i (const char* name,
                 int start_index = 0) const;

  virtual void      remove (int i);


  /* Associative search by name.  The last encountered name is
     referred! */

  virtual const char*   get_value (const char* name) const;

  int           get_int_value (const char* name,
                       int def_value = 0) const;

#ifdef CompilerIs64bitReady

  long long     get_int8_value (const char* name,
                       long long def_value = 0LL) const;
#endif /* CompilerIs64bitReady */

  double        get_double_value (const char* name,
                      double def_value = 0.0) const;

  const char*       operator() (const char* name) const;

  virtual char*     fetch_value (const char* name);

  char*         operator[] (const char* name);


  /* Fetching multiple entries which names started with the same root
     word (matching word*) */

  virtual OptionItem**  match (const char* word);


  /*
   * Adding more pairs (NAME, VALUE)
   */

  virtual void      add (const char* name, const char* value);

  void          add (const char* name, int v);

#ifdef CompilerIs64bitReady

  void          add (const char* name, long long v);
#endif /* CompilerIs64bitReady */

  void          add (const char* name, double v);


  virtual void      put (const char* name, const char* value);

  void          put (const char* name, int v);

#ifdef CompilerIs64bitReady

  void          put (const char* name, long long v);
#endif /* CompilerIs64bitReady */

  void          put (const char* name, double v);


  enum MergeMode {
    AppendAll,  
    AppendNew,  
    Overwrite,  
    Replace 
  };

  void          merge (const IniSection& ini_sect,
                   MergeMode mode = AppendAll);

protected:

  OptionBase        ob;

  char          *section_type;

  char          *section_name;

};


inline const OptionItem&
IniSection::operator() (int i) const
{
  const OptionItem  *oi = get(i);
  if(NULL == oi)
    Throw(ERROR__OUT_OF_RANGE);
  return *oi;
}

inline const char*
IniSection::operator() (const char* name) const
{
  return get_value(name);
}

inline OptionItem&
IniSection::operator[] (int i)
{
  OptionItem    *oi = fetch(i);
  if(NULL == oi)
    Throw(ERROR__OUT_OF_RANGE);
  return *oi;
}

inline char*
IniSection::operator[] (const char* name)
{
  return fetch_value(name);
}


#endif /* IniSection.hpp */