/xbmc/guilib/LocalizeStrings.cpp
http://github.com/xbmc/xbmc · C++ · 246 lines · 177 code · 32 blank · 37 comment · 43 complexity · 3b55628d0d303c9bc44015242e310a43 MD5 · raw file
- /*
- * Copyright (C) 2005-2018 Team Kodi
- * This file is part of Kodi - https://kodi.tv
- *
- * SPDX-License-Identifier: GPL-2.0-or-later
- * See LICENSES/README.md for more information.
- */
- #include "LocalizeStrings.h"
- #include "addons/LanguageResource.h"
- #include "filesystem/Directory.h"
- #include "filesystem/SpecialProtocol.h"
- #include "threads/SharedSection.h"
- #include "utils/CharsetConverter.h"
- #include "utils/POUtils.h"
- #include "utils/StringUtils.h"
- #include "utils/URIUtils.h"
- #include "utils/log.h"
- /*! \brief Tries to load ids and strings from a strings.po file to the `strings` map.
- * It should only be called from the LoadStr2Mem function to have a fallback.
- \param pathname The directory name, where we look for the strings file.
- \param strings [out] The resulting strings map.
- \param encoding Encoding of the strings. For PO files we only use utf-8.
- \param offset An offset value to place strings from the id value.
- \param bSourceLanguage If we are loading the source English strings.po.
- \return false if no strings.po file was loaded.
- */
- static bool LoadPO(const std::string &filename, std::map<uint32_t, LocStr>& strings,
- std::string &encoding, uint32_t offset = 0 , bool bSourceLanguage = false)
- {
- CPODocument PODoc;
- if (!PODoc.LoadFile(filename))
- return false;
- int counter = 0;
- while ((PODoc.GetNextEntry()))
- {
- uint32_t id;
- if (PODoc.GetEntryType() == ID_FOUND)
- {
- bool bStrInMem = strings.find((id = PODoc.GetEntryID()) + offset) != strings.end();
- PODoc.ParseEntry(bSourceLanguage);
- if (bSourceLanguage && !PODoc.GetMsgid().empty())
- {
- if (bStrInMem && (strings[id + offset].strOriginal.empty() ||
- PODoc.GetMsgid() == strings[id + offset].strOriginal))
- continue;
- else if (bStrInMem)
- CLog::Log(LOGDEBUG,
- "POParser: id:%i was recently re-used in the English string file, which is not yet "
- "changed in the translated file. Using the English string instead", id);
- strings[id + offset].strTranslated = PODoc.GetMsgid();
- counter++;
- }
- else if (!bSourceLanguage && !bStrInMem && !PODoc.GetMsgstr().empty())
- {
- strings[id + offset].strTranslated = PODoc.GetMsgstr();
- strings[id + offset].strOriginal = PODoc.GetMsgid();
- counter++;
- }
- }
- else if (PODoc.GetEntryType() == MSGID_FOUND)
- {
- //! @todo implement reading of non-id based string entries from the PO files.
- //! These entries would go into a separate memory map, using hash codes for fast look-up.
- //! With this memory map we can implement using gettext(), ngettext(), pgettext() calls,
- //! so that we don't have to use new IDs for new strings. Even we can start converting
- //! the ID based calls to normal gettext calls.
- }
- else if (PODoc.GetEntryType() == MSGID_PLURAL_FOUND)
- {
- //! @todo implement reading of non-id based pluralized string entries from the PO files.
- //! We can store the pluralforms for each language, in the langinfo.xml files.
- }
- }
- CLog::Log(LOGDEBUG, "LocalizeStrings: loaded %i strings from file %s", counter, filename.c_str());
- return true;
- }
- /*! \brief Loads language ids and strings to memory map `strings`.
- \param pathname The directory name, where we look for the strings file.
- \param language We load the strings for this language. Fallback language is always English.
- \param strings [out] The resulting strings map.
- \param encoding Encoding of the strings. For PO files we only use utf-8.
- \param offset An offset value to place strings from the id value.
- \return false if no strings.po file was loaded.
- */
- static bool LoadStr2Mem(const std::string &pathname_in, const std::string &language,
- std::map<uint32_t, LocStr>& strings, std::string &encoding, uint32_t offset = 0 )
- {
- std::string pathname = CSpecialProtocol::TranslatePathConvertCase(pathname_in + language);
- if (!XFILE::CDirectory::Exists(pathname))
- {
- bool exists = false;
- std::string lang;
- // check if there's a language addon using the old language naming convention
- if (ADDON::CLanguageResource::FindLegacyLanguage(language, lang))
- {
- pathname = CSpecialProtocol::TranslatePathConvertCase(pathname_in + lang);
- exists = XFILE::CDirectory::Exists(pathname);
- }
- if (!exists)
- return false;
- }
- bool useSourceLang = StringUtils::EqualsNoCase(language, LANGUAGE_DEFAULT) || StringUtils::EqualsNoCase(language, LANGUAGE_OLD_DEFAULT);
- return LoadPO(URIUtils::AddFileToFolder(pathname, "strings.po"), strings, encoding, offset, useSourceLang);
- }
- static bool LoadWithFallback(const std::string& path, const std::string& language, std::map<uint32_t, LocStr>& strings)
- {
- std::string encoding;
- if (!LoadStr2Mem(path, language, strings, encoding))
- {
- if (StringUtils::EqualsNoCase(language, LANGUAGE_DEFAULT)) // no fallback, nothing to do
- return false;
- }
- // load the fallback
- if (!StringUtils::EqualsNoCase(language, LANGUAGE_DEFAULT))
- LoadStr2Mem(path, LANGUAGE_DEFAULT, strings, encoding);
- return true;
- }
- CLocalizeStrings::CLocalizeStrings(void) = default;
- CLocalizeStrings::~CLocalizeStrings(void) = default;
- void CLocalizeStrings::ClearSkinStrings()
- {
- // clear the skin strings
- CExclusiveLock lock(m_stringsMutex);
- Clear(31000, 31999);
- }
- bool CLocalizeStrings::LoadSkinStrings(const std::string& path, const std::string& language)
- {
- //! @todo shouldn't hold lock while loading file
- CExclusiveLock lock(m_stringsMutex);
- ClearSkinStrings();
- // load the skin strings in.
- return LoadWithFallback(path, language, m_strings);
- }
- bool CLocalizeStrings::Load(const std::string& strPathName, const std::string& strLanguage)
- {
- std::map<uint32_t, LocStr> strings;
- if (!LoadWithFallback(strPathName, strLanguage, strings))
- return false;
- // fill in the constant strings
- strings[20022].strTranslated = "";
- strings[20027].strTranslated = "°F";
- strings[20028].strTranslated = "K";
- strings[20029].strTranslated = "°C";
- strings[20030].strTranslated = "°Ré";
- strings[20031].strTranslated = "°Ra";
- strings[20032].strTranslated = "°Rø";
- strings[20033].strTranslated = "°De";
- strings[20034].strTranslated = "°N";
- strings[20200].strTranslated = "km/h";
- strings[20201].strTranslated = "m/min";
- strings[20202].strTranslated = "m/s";
- strings[20203].strTranslated = "ft/h";
- strings[20204].strTranslated = "ft/min";
- strings[20205].strTranslated = "ft/s";
- strings[20206].strTranslated = "mph";
- strings[20207].strTranslated = "kts";
- strings[20208].strTranslated = "Beaufort";
- strings[20209].strTranslated = "inch/s";
- strings[20210].strTranslated = "yard/s";
- strings[20211].strTranslated = "Furlong/Fortnight";
- CExclusiveLock lock(m_stringsMutex);
- Clear();
- m_strings = std::move(strings);
- return true;
- }
- const std::string& CLocalizeStrings::Get(uint32_t dwCode) const
- {
- CSharedLock lock(m_stringsMutex);
- ciStrings i = m_strings.find(dwCode);
- if (i == m_strings.end())
- {
- return StringUtils::Empty;
- }
- return i->second.strTranslated;
- }
- void CLocalizeStrings::Clear()
- {
- CExclusiveLock lock(m_stringsMutex);
- m_strings.clear();
- }
- void CLocalizeStrings::Clear(uint32_t start, uint32_t end)
- {
- CExclusiveLock lock(m_stringsMutex);
- iStrings it = m_strings.begin();
- while (it != m_strings.end())
- {
- if (it->first >= start && it->first <= end)
- m_strings.erase(it++);
- else
- ++it;
- }
- }
- bool CLocalizeStrings::LoadAddonStrings(const std::string& path, const std::string& language, const std::string& addonId)
- {
- std::map<uint32_t, LocStr> strings;
- if (!LoadWithFallback(path, language, strings))
- return false;
- CExclusiveLock lock(m_addonStringsMutex);
- auto it = m_addonStrings.find(addonId);
- if (it != m_addonStrings.end())
- m_addonStrings.erase(it);
- return m_addonStrings.emplace(std::string(addonId), std::move(strings)).second;
- }
- std::string CLocalizeStrings::GetAddonString(const std::string& addonId, uint32_t code)
- {
- CSharedLock lock(m_addonStringsMutex);
- auto i = m_addonStrings.find(addonId);
- if (i == m_addonStrings.end())
- return StringUtils::Empty;
- auto j = i->second.find(code);
- if (j == i->second.end())
- return StringUtils::Empty;
- return j->second.strTranslated;
- }