GuiTextTranslator.h

/****************************************************************************
 * libgui
 * Daryl Borth 2026
 * GuiTextTranslator.h
 ***************************************************************************/
#pragma once
 
#include <cstdint>
#include <cstddef>

class GuiTextTranslator
{
    public:
        constexpr GuiTextTranslator() : magic(MAGIC), head(nullptr) {}
        ~GuiTextTranslator();

        bool loadLanguage(const uint8_t* buffer, size_t size);

        const char* getText(const char* msgid) const;

        void clear();
 
    private:
        static constexpr uint32_t MAGIC = 0x47545254; // "GTRT": a live, intact translator
 
        struct MSG
        {
            uint32_t id = 0;
            char* msgstr = nullptr;
            MSG* next = nullptr;
        };
 
        uint32_t magic; // MAGIC while alive; checked on lookup so a stomped object is caught early
        MSG* head;

        static uint32_t hashString(const char* str);
        static char* expandEscape(const char* str);

        const char* memFGets(char* dst, int maxlen, const char* src, const char* eof) const;

        [[noreturn]] static void fatalCorruption(const GuiTextTranslator* self, const void* bad,
                const void* from, uint32_t magicSeen);
        void checkIntegrity(const MSG* node, const MSG* prev) const;
 
        MSG* findMessage(uint32_t id) const;
        MSG* setMessage(const char* msgid, const char* msgstr);
};