configfile.h

/*
        ConfigFile - Klasse
        Diese Klasse dient zum Verwalten von Konfigurationsfiles ähnlich den ".ini" Files unter Windows.
        Die Files sind im Grunde folgendermaßen aufgebaut:

        ;*******************************************************************************
        ; Dies ist ein Kommentar (beim Erzeugen des ConfigFile-Objektes kann
        ; das Kommentarzeichen angegeben werden. Standardmäßig ist dieses das Semikolon.

        [Abschnitt_1]
          Bezeichner1 = Wert
                Bezeichner2 = Wert
        ...

        [Abschnitt_2]
          Bezeichner1=Wert
          Bezeichner2=Wert

        ...

        ;*******************************************************************************

        Lehrzeichen und Tabulatoren können eigentlich überall auftauchen, nur nicht in den
        Bezeichnern und den Werten. Sie können aber auch zwischen den Bezeichnern dem "="
        und den Werten fehlen.
        In den Abschnittsnamen, Bezeichnern und Werten sind alle Zeichen bis auf das Kommentarzeichen
        sowie die Zeichen "[" und "]" erlaubt. Fehlt ein Wert, so wird er als Null (bei Numerischen Werten)
        bzw. als "" (für Strings) angenommen.

        Hinweis: Zwei Abschnitte mit dem selben Namen macht keinen Sinn.
                 Bezeichner mit gleichen Namen in unterschiedlichen Abschnitten sind kein Problem.
*/


#ifndef CONFIGFILE_H
#define CONFIGFILE_H

#include <fstream>
#include <iostream>
typedef int ERROR;

class ConfigFile {

public:
  /*
    Erzeugt ein ConfigFile-Objekt.
    Es muss der Dateiname und optional ein Kommentarzeichen angegeben werden.
    Existiert die Datei nicht, so wird sie angelegt.
  */
  ConfigFile(const char filename[], const char comment = ';');
  ~ConfigFile();

  /*
    Die read-Funktionen lesen den gewünschten Wert des Bezeichners "ident"
    aus dem Abschnitt "section".
    Sie werden in der Variablen "value" gespeichert.
    Parms:    section - gesuchter Abschnitt
    ident   - gesuchter Bezeichner
    value   - Variable von gewünschtem Typ für das Ergebnis
    Returns:  errorcode - 0 wenn Wert gefunden wurde
  */
  ERROR read(const char section[], const char ident[], double* value);
  ERROR read(const char section[], const char ident[], char* value);
  ERROR read(const char section[], const char ident[], int* value);

  /*
    Die store-Funktionen speichern einen in einem Abschnitt einen Bezeichner
    mit zugehörigem Wert. Ist der Bezeichner bereits vorhanden, so wird sein
    Wert aktualisiert. Ist er nicht vorhanden so wird er neu eingefügt.
    Parms:    section - gewünschter Abschnitt
    ident   - gewünschter Bezeichner
    value   - Wert der gesetzt werden soll
    Returns:  errorcode - 0 wenn Wert korrekt gesetzt werden konnte
  */
  ERROR store(const char section[], const char ident[], const double value);
  ERROR store(const char section[], const char ident[], const char value[]);
  ERROR store (const char section[], const char ident[], const int value);
  ERROR isConsistent();

  static const ERROR CFG_SUCCESS               =  0;
  static const ERROR CFG_FILE_NOT_EXISTS       = -1;
  static const ERROR CFG_INCORRECT_SYNTAX      = -2;
  static const ERROR CFG_SECTION_NOT_FOUND     = -3;
  static const ERROR CFG_IDENTIFIER_NOT_FOUND  = -4;

  char getStatus() const;

 private:
  ERROR getValue(const char section[], const char ident[]);
  ERROR storeValue(const char section[], const char ident[], const char value[]);
  void ignoreLine();
  ERROR open_w();
  ERROR open_r();
  void close();
  char _comment;
  char* _value;
  char* _filename;
  std::fstream* _file;
  //+++++tbaier 20040305
  char _openStatus; //status of file c = closed; r = read open, w = write open, e = file error
};

#endif

---

Tim Baier bhandlib v0.25

Generated Wed Aug 16 14:57:09 2006 by 1.4.7