language.h

Go to the documentation of this file.

/*
 * This file is part of OpenTTD.
 * OpenTTD is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, version 2.
 * OpenTTD is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
 * See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with OpenTTD. If not, see <http://www.gnu.org/licenses/>.
 */
 
#ifndef LANGUAGE_H
#define LANGUAGE_H
 
#ifdef WITH_ICU_I18N
#include <unicode/coll.h>
#endif /* WITH_ICU_I18N */
#include "strings_type.h"
#include <filesystem>
 
static const uint8_t CASE_GENDER_LEN = 16; 
static const uint8_t MAX_NUM_GENDERS =  8; 
static const uint8_t MAX_NUM_CASES   = 16; 
 
struct LanguagePackHeader {
  static const uint32_t IDENT = 0x474E414C; 
 
  uint32_t ident;       
  uint32_t version;     
  char name[32];      
  char own_name[32];  
  char isocode[16];   
  uint16_t offsets[TEXT_TAB_END]; 
 
  char number_format[64];
  char number_abbreviations[256];
  char digit_decimal_separator[8];
  uint16_t missing;     
  byte plural_form;   
  byte text_dir;      
 
  uint16_t winlangid;   
  uint8_t newgrflangid; 
  uint8_t num_genders;  
  uint8_t num_cases;    
  byte pad[3];        
 
  char genders[MAX_NUM_GENDERS][CASE_GENDER_LEN]; 
  char cases[MAX_NUM_CASES][CASE_GENDER_LEN];     
 
  bool IsValid() const;
  bool IsReasonablyFinished() const;
 
  uint8_t GetGenderIndex(const char *gender_str) const
  {
    for (uint8_t i = 0; i < MAX_NUM_GENDERS; i++) {
      if (strcmp(gender_str, this->genders[i]) == 0) return i;
    }
    return MAX_NUM_GENDERS;
  }
 
  uint8_t GetCaseIndex(const char *case_str) const
  {
    for (uint8_t i = 0; i < MAX_NUM_CASES; i++) {
      if (strcmp(case_str, this->cases[i]) == 0) return i;
    }
    return MAX_NUM_CASES;
  }
};
static_assert(sizeof(LanguagePackHeader) % 4 == 0);
 
struct LanguageMetadata : public LanguagePackHeader {
  std::filesystem::path file; 
};
 
typedef std::vector<LanguageMetadata> LanguageList;
 
extern LanguageList _languages;
 
extern const LanguageMetadata *_current_language;
 
#ifdef WITH_ICU_I18N
extern std::unique_ptr<icu::Collator> _current_collator;
#endif /* WITH_ICU_I18N */
 
constexpr int DIGITS_IN_UINT64_T = 20;
using NumberFormatSeparators = std::array<std::string, DIGITS_IN_UINT64_T>;
struct NumberAbbreviation {
  NumberAbbreviation(int64_t threshold, NumberFormatSeparators &format) : threshold(threshold), format(format) {}
  int64_t threshold; 
  NumberFormatSeparators format; 
};
using NumberAbbreviations = std::vector<NumberAbbreviation>;
 
bool ReadLanguagePack(const LanguageMetadata *lang);
const LanguageMetadata *GetLanguage(byte newgrflangid);
 
std::optional<std::string> ParseNumberFormatSeparators(NumberFormatSeparators &separators, std::string_view format, size_t length = DIGITS_IN_UINT64_T);
std::optional<std::string> ParseNumberAbbreviations(NumberAbbreviations &abbreviations, std::string_view input);
 
#endif /* LANGUAGE_H */