qgssettings.h

Go to the documentation of this file.

/***************************************************************************
  qgssettings.h
  --------------------------------------
  Date                 : January 2017
  Copyright            : (C) 2017 by Alessandro Pasotti
  Email                : apasotti at boundlessgeo dot com
 ***************************************************************************
 *                                                                         *
 *   This program is free software; you can redistribute it and/or modify  *
 *   it under the terms of the GNU General Public License as published by  *
 *   the Free Software Foundation; either version 2 of the License, or     *
 *   (at your option) any later version.                                   *
 *                                                                         *
 ***************************************************************************/


#ifndef QGSSETTINGS_H
#define QGSSETTINGS_H

#include <QSettings>
#include <QMetaEnum>

#include "qgis_core.h"
#include "qgis.h"

class CORE_EXPORT QgsSettings : public QObject
{
    Q_OBJECT
  public:

    enum Section
    {
      NoSection,
      Core,
      Gui,
      Server,
      Plugins,
      Auth,
      App,
      Providers,
      Misc
    };

    explicit QgsSettings( const QString &organization,
                          const QString &application = QString(), QObject *parent = nullptr );

    QgsSettings( QSettings::Scope scope, const QString &organization,
                 const QString &application = QString(), QObject *parent = nullptr );

    QgsSettings( QSettings::Format format, QSettings::Scope scope, const QString &organization,
                 const QString &application = QString(), QObject *parent = nullptr );

    QgsSettings( const QString &fileName, QSettings::Format format, QObject *parent = nullptr );

    explicit QgsSettings( QObject *parent = nullptr );
    ~QgsSettings() override;

    void beginGroup( const QString &prefix, const QgsSettings::Section section = QgsSettings::NoSection );
    void endGroup();
    QStringList allKeys() const;
    QStringList childKeys() const;
    QStringList childGroups() const;
    QStringList globalChildGroups() const;
    static QString globalSettingsPath() { return sGlobalSettingsPath; }
    static bool setGlobalSettingsPath( const QString &path );
    int beginReadArray( const QString &prefix );

    void beginWriteArray( const QString &prefix, int size = -1 );
    void endArray();

    void setArrayIndex( int i );

    void setValue( const QString &key, const QVariant &value, const QgsSettings::Section section = QgsSettings::NoSection );

#ifndef SIP_RUN
    QVariant value( const QString &key, const QVariant &defaultValue = QVariant(),
                    const Section section = NoSection ) const;
#else
    SIP_PYOBJECT value( const QString &key, const QVariant &defaultValue = QVariant(),
                        SIP_PYOBJECT type = 0,
                        QgsSettings::Section section = QgsSettings::NoSection ) const / ReleaseGIL /;
    % MethodCode
    typedef PyObject *( *pyqt5_from_qvariant_by_type )( QVariant &value, PyObject *type );
    QVariant value;

    // QSettings has an internal mutex so release the GIL to avoid the possibility of deadlocks.
    Py_BEGIN_ALLOW_THREADS
    value = sipCpp->value( *a0, *a1, a3 );
    Py_END_ALLOW_THREADS

    pyqt5_from_qvariant_by_type f = ( pyqt5_from_qvariant_by_type ) sipImportSymbol( "pyqt5_from_qvariant_by_type" );
    sipRes = f( value, a2 );

    sipIsErr = !sipRes;
    % End
#endif

#ifndef SIP_RUN

    template <class T>
    T enumValue( const QString &key, const T &defaultValue,
                 const Section section = NoSection, bool flag = false ) const
    {
      T v;
      if ( !flag )
        v = static_cast<T>( value( key, static_cast<int>( defaultValue ), section ).toInt() );
      else
        v = T( value( key, static_cast<int>( defaultValue ), section ).toInt() );

      QMetaEnum metaEnum = QMetaEnum::fromType<T>();
      if ( metaEnum.isValid() )
      {
        if ( !flag && !metaEnum.valueToKey( static_cast<int>( v ) ) )
        {
          v = defaultValue;
        }
        else if ( flag && !metaEnum.valueToKeys( static_cast<int>( v ) ).size() )
        {
          v = defaultValue;
        }
      }
      return v;
    }
#endif

    bool contains( const QString &key, const QgsSettings::Section section = QgsSettings::NoSection ) const;
    QString fileName() const;

    void sync();
    void remove( const QString &key, const QgsSettings::Section section = QgsSettings::NoSection );
    QString prefixedKey( const QString &key, const QgsSettings::Section section ) const;
    void clear();

  private:

    static QString sGlobalSettingsPath;
    void init();
    QString sanitizeKey( const QString &key ) const;
    QSettings *mUserSettings = nullptr;
    QSettings *mGlobalSettings = nullptr;
    bool mUsingGlobalArray = false;
    Q_DISABLE_COPY( QgsSettings )

};

#endif // QGSSETTINGS_H