qlabinifile.h

/*
* Linux Advanced Business Enterprise Management System
*
*
* File name....... : qlabinifile.h
* File version.... : 1.2.8
* Revision Date... : Mon Feb 09 2004
*
* File Description : Generic INI file manager
*
* Author.......... : DJ Anubis
* Copyright....... : (C) 2001-2004 by DJ Anubis
* Email .......... : labproject@free.fr
*
* License :
*   Please read the license file in doc directory.
*   1. Lab Public License.
*      You should have received a copy of the Lab Public License with this package.
*      If this is not the case, you can read it or download it at:
*      http://labproject.free.fr
*   2. Q Public License.
*      Conformant to Trolltech QPL license.
*   3. GNU General Public License.
*      Reserved for free projects.
*   4. Commercial license.
*      Recommanded if your code is not distributed under one of the 3 models above.
*
*   Read the license FAQ in doc directory.
*
* Comments:
* Documentation has been revamped.
*/

#ifndef QLABINIFILE_H
#define QLABINIFILE_H


#include <qobject.h>
#include <qmap.h>

class QVariant ;
class QStringList ;


class Q_EXPORT QlabIniFile : public QObject
{
        Q_OBJECT

        Q_ENUMS( FileScope )
        Q_ENUMS( AccessModes )

        Q_PROPERTY( FileScope scope READ scope WRITE setScope
                                DESIGNABLE true SCRIPTABLE true STORED true )
        Q_PROPERTY( AccessModes accessMode READ accessMode WRITE setAccessMode
                                DESIGNABLE true SCRIPTABLE true STORED true )

public :
        enum FileScope { System, Global, Module, Local, Private } ;
        enum AccessModes { Create, ReadOnly, ReadWrite, Append, Override } ;

        QlabIniFile( QObject * parent = 0, char * name = 0 ) ;
        ~QlabIniFile() ;

        uint groupCount() ;
        QStringList groups() ;
        bool groupExists( const QString & groupName ) ;

public slots :
        FileScope scope() const ;
        void setScope( const FileScope scope ) ;

        AccessModes accessMode() const ;
        void setAccessMode( const AccessModes mode ) ;

        QVariant readVar( const QString & section, const QString & varName ) ;
        void setVar( const QString & section, const QString & varName, const QVariant & varValue ) ;
        QMap<QString, QVariant> readGroup( const QString & groupName ) ;
        bool removeGroup( const QString & groupName ) ;
        bool varExists( const QString & groupName, const QString & varName ) ;
        QStringList readList( const QString & groupName, const QString & varName, const QString & separator = ";" ) ;

private :
        QSqlCursor * iniFile ;
        QString newFilter ;
        FileScope iniScope ;
        AccessModes iniMode ;

} ;


#endif // QLABINIFILE_H