i18n.hpp

Go to the documentation of this file.

#pragma once
 
// Internationalization — string translation and locale management.
// Supports .strings and .po file formats, positional argument substitution.
 
#include <string>
#include <string_view>
#include <map>
#include <optional>
#include <vector>
 
namespace pulp::runtime {

class LocalisedStrings {
public:
    LocalisedStrings() = default;

    bool load_strings_file(std::string_view path);

    bool load_po_file(std::string_view path);

    bool load_json_file(std::string_view path);

    void add(std::string_view key, std::string_view value);

    std::string translate(std::string_view key) const;

    std::string translate(std::string_view key, const std::vector<std::string>& args) const;

    std::string t(std::string_view key) const { return translate(key); }

    bool has(std::string_view key) const;

    int count() const { return static_cast<int>(strings_.size()); }

    void clear() { strings_.clear(); }

    const std::string& locale() const { return locale_; }
    void set_locale(std::string_view loc) { locale_ = std::string(loc); }
 
    // ── Global instance ─────────────────────────────────────────────────

    static LocalisedStrings& instance();

    static std::string system_locale();
 
private:
    std::map<std::string, std::string, std::less<>> strings_;
    std::string locale_ = "en";
};

inline std::string tr(std::string_view key) {
    return LocalisedStrings::instance().translate(key);
}

inline std::string tr(std::string_view key, const std::vector<std::string>& args) {
    return LocalisedStrings::instance().translate(key, args);
}
 
}  // namespace pulp::runtime