TranslationResource.hxx

Go to the documentation of this file.

// SPDX-FileCopyrightText: 2025 Florent Rougon
// SPDX-License-Identifier: GPL-2.0-or-later

 
#pragma once
 
#include <cstddef>
#include <map>
#include <memory>
#include <string>
#include <utility>
#include <vector>
 
#include "LanguageInfo.hxx"
#include "TranslationUnit.hxx"

 
class TranslationResource
{
public:
    using intType = flightgear::LanguageInfo::intType;
 
    TranslationResource() = delete;
    explicit TranslationResource(std::string name) noexcept;
    void addTranslationUnit(std::string name, int index, std::string sourceText,
                            bool hasPlural = false);
    void setFirstTargetText(std::string name, int index,
                            std::string targetText);
    void setTargetTexts(std::string name, int index,
                        std::vector<std::string> targetTexts);

    std::shared_ptr<TranslationUnit>
    translationUnit(const std::string& name, int index = 0) const;

    std::string get(const std::string& basicId, int index = 0) const;
    std::string getPlural(intType cardinalNumber, const std::string& basicId,
                          int index = 0) const;
    std::string getWithDefault(const std::string& basicId,
                               const std::string& defaultValue,
                               int index = 0) const;
    std::string getPluralWithDefault(intType cardinalNumber,
                                     const std::string& basicId,
                                     const std::string& defaultValue,
                                     int index = 0) const;
    std::vector<std::string> getAll(const std::string& name) const;
    std::size_t getCount(const std::string& name) const;

    static void setupGhost();
 
private:
    std::string _name;
    // In the default translation files, this corresponds to a node name and
    // its index.
    using KeyType = std::pair<std::string, int>;
    using TranslationUnitRef = std::shared_ptr<TranslationUnit>;
    std::map<KeyType, TranslationUnitRef> _map;
};