locales.h

Go to the documentation of this file.

/*
 * Copyright (C) 2018-2026 QuasarApp.
 * Distributed under the lgplv3 software license, see the accompanying
 * Everyone is permitted to copy and distribute verbatim copies
 * of this license document, but changing it is not allowed.
*/
 
 
#ifndef LOCALES_H
#define LOCALES_H
 
#include "quasarapp_global.h"
 
#include <QLocale>
#include <QSet>
#include <QString>
#include <QDir>
 
class QCoreApplication;
class QTranslator;
 
namespace QuasarAppUtils {

class QUASARAPPSHARED_EXPORT Locales : public QObject
{
    Q_OBJECT
public:

    static bool setLocale(const QLocale &locale, bool force = false);

    static bool init(const QList<QLocale> & locales,
                     const QSet<QString> & location = {});

    static bool init(const QLocale &locale = QLocale::system(),
                     const QSet<QString> & location = {});

    static void addLocation(const QString& location);

    static Locales *instance();

    static const QLocale &currentLocate();

    static QString tr(const char *source, const QLocale& locale);
 
signals:
    void sigTranslationChanged();
 
private:
    Locales() = default;
    ~Locales();

    bool setLocalePrivate(const QLocale &locale = QLocale::system(), bool force = false, bool install = true);
    bool initPrivate(const QLocale &locale = QLocale::system(),
                     const QSet<QString> &location = {});

    bool initPrivate(const QList<QLocale> &locales,
                     const QSet<QString> &location = {});

    void clearCache(const QLocale& locale);
    void clearCache();

    void removeOldTranslation(const QLocale& locale);

    void addLocationPrivate(const QString& location);

    const QLocale &currentLocatePrivate() const;

    bool findQm(QString localePrefix,
                QList<QTranslator *> &result);
    bool findQmPrivate(const QString &prefix,
                       QList<QTranslator *> &qmFiles);
    void installTranslations(QList<QTranslator *> &qmFiles);
    QString translatePrivate(const char *source, const QLocale& locale);

    QLocale _currentLocate;

    QSet<QString> _locations;

    QHash<QLocale, QList<QTranslator *>> _translations;
 
};
}
 
 
#endif // LOCALES_H