I18n.h

浏览该文件的文档.

#pragma once
 
#include "common/Module.h"
 
#include <cstdint>
#include <string>
#include <unordered_map>
#include <vector>
 
namespace eve::i18n {
 
class I18n : public Module {
public:
    Module_REG(I18n);
    I18n() = default;
    ~I18n() override = default;
 
    bool loadFromJson(const std::string &lang, const std::string &json);
    bool loadFromFile(const std::string &lang, const std::string &path);
    void unload(const std::string &lang);
    void clear();
 
    bool setLanguage(const std::string &lang);
    std::string getLanguage() const { return language_; }
    void setDefaultLanguage(const std::string &lang) { defaultLanguage_ = lang; }
    std::string getDefaultLanguage() const { return defaultLanguage_; }
    int getLanguageCount() const { return int(locales_.size()); }
    std::string getLanguageAt(int index) const;
    bool hasLanguage(const std::string &lang) const;
 
    bool has(const std::string &key) const;
    std::string get(const std::string &key) const;
    std::string getWithParams(const std::string &key,
                              const std::unordered_map<std::string, std::string> &params) const;
    std::string getPlural(const std::string &key, int n) const;
    std::string getPluralWithParams(const std::string &key, int n,
                                    const std::unordered_map<std::string, std::string> &params) const;
 
    // ---- hot reload (poll from the game loop) ----
    void setAutoReload(bool enable) { autoReload_ = enable; }
    bool isAutoReload() const { return autoReload_; }
    int update(float dt);
 
private:
    struct Locale {
        std::unordered_map<std::string, std::string> strings;    // flat key -> value
        std::unordered_map<std::string, std::unordered_map<std::string, std::string>>
            plurals;                                            // key -> {form -> value}
        std::string path;                                       // empty if loaded from raw json
        int64_t     modtime = -1;
    };
 
    Locale *      findLocale(const std::string &lang);
    const Locale *findLocale(const std::string &lang) const;
 
    std::string formatString(const std::string &tpl,
                             const std::unordered_map<std::string, std::string> &params) const;
    std::string pluralForm(const std::string &lang, int n) const;
 
    std::unordered_map<std::string, Locale> locales_;
    std::string language_        = "en";
    std::string defaultLanguage_ = "en";
    bool        autoReload_      = true;
};
 
}  // namespace eve::i18n