I18n.h

浏览该文件的文档.

#pragma once
#include "common/Export.h"
 
 
#include "common/Module.h"
#include "common/Result.h"
 
#include <cstdint>
#include <string>
#include <unordered_map>
#include <vector>
 
namespace eve::i18n {
 
class EVENGINE_API_PLATFORM I18n : public Module {
public:
    Module_REG(I18n);
    I18n()           = default;
    ~I18n() override = default;
 
    [[nodiscard]] eve::Result<void> replaceLocaleFromJson(const std::string& lang, const std::string& json);
    [[nodiscard]] eve::Result<void> replaceLocaleFromFile(const std::string& lang, const std::string& path);
    bool loadFromJson(const std::string& lang, const std::string& json);
    bool loadFromFile(const std::string& lang, const std::string& path);
    [[nodiscard]] eve::Result<int> replaceBundleFromJson(const std::string& json);
    void unload(const std::string& lang);
    void clear();
 
    [[nodiscard]] eve::Result<void> selectLanguage(const std::string& lang);
    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 hasInLanguage(const std::string& lang, const std::string& key) const;
    [[nodiscard]] eve::Result<int> validateKeyCoverage(const std::string& key) const;
    int getKeyCount(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