Functions
wxString	GetSystemLanguageCode (const FilePaths &pathList)

void	GetLanguages (FilePaths pathList, wxArrayString &langCodes, TranslatableStrings &langNames)

wxString	SetLang (const FilePaths &pathList, const wxString &lang)

wxString	GetLocaleName ()

wxString	GetLang ()

wxString	GetLangShort ()

Variables
static std::unique_ptr< wxLocale >	sLocale

static wxString	sLocaleName

Function Documentation

◆ GetLang()

STRINGS_API wxString Languages::GetLang ( )

Returns: the last language code that was set

Definition at line 395 of file Languages.cpp.

{
   if (sLocale)
      return sLocale->GetSysName();
   else
      return {};
}

References sLocale.

Referenced by audacity::cloud::audiocom::ServiceConfig::GetAcceptLanguageValue().

Here is the caller graph for this function:

◆ GetLangShort()

STRINGS_API wxString Languages::GetLangShort ( )

Returns: the last language code that was set (minus country code)

Definition at line 403 of file Languages.cpp.

{
   if (sLocale)
      return sLocale->GetName();
   else
      return {};
}

References sLocale.

◆ GetLanguages()

STRINGS_API void Languages::GetLanguages	(	FilePaths	pathList,
		wxArrayString &	langCodes,
		TranslatableStrings &	langNames
	)

Parameters

	pathList	paths to search for .mo files, grouped into subdirectories for the different languages
[out]	langCodes	two-letter language abbreviations (like "fr") or language and country (like "pt_BR")
[out]	langNames	corresponding autonyms of those languages (like "Português")

Definition at line 140 of file Languages.cpp.

{
   static const char *const utf8Names[] = {
"af Afrikaans",
"ar \330\247\331\204\330\271\330\261\330\250\331\212\330\251",
"be \320\221\320\265\320\273\320\260\321\200\321\203\321\201\320\272\320\260\321\217",
"bg \320\221\321\212\320\273\320\263\320\260\321\200\321\201\320\272\320\270",
"bn \340\246\254\340\246\276\340\246\202\340\246\262\340\246\276",
"bs Bosanski",
"ca Catal\303\240",
"ca_ES@valencia Valenci\303\240",
"co Corsu",
"cs \304\214e\305\241tina",
"cy Cymraeg",
"da Dansk",
"de Deutsch",
"el \316\225\316\273\316\273\316\267\316\275\316\271\316\272\316\254",
"en English",
"es Espa\303\261ol",
"eu Euskara",
"eu_ES Euskara (Espainiako)",
"fa \331\201\330\247\330\261\330\263\333\214",
"fi Suomi",
"fr Fran\303\247ais",
"ga Gaeilge",
"gl Galego",
"he \327\242\327\221\327\250\327\231\327\252",
"hi \340\244\271\340\244\277\340\244\250\340\245\215\340\244\246\340\245\200",
"hr Hrvatski",
"hu Magyar",
"hy \325\200\325\241\325\265\325\245\326\200\325\245\325\266",
"id Bahasa Indonesia",
"it Italiano",
"ja \346\227\245\346\234\254\350\252\236",
"ka \341\203\245\341\203\220\341\203\240\341\203\227\341\203\243\341\203\232\341\203\230",
"km \341\236\201\341\237\201\341\236\230\341\236\232\341\236\227\341\236\266\341\236\237\341\236\266",
"ko \355\225\234\352\265\255\354\226\264",
"lt Lietuvi\305\263",
"mk \320\234\320\260\320\272\320\265\320\264\320\276\320\275\321\201\320\272\320\270",
"mr \340\244\256\340\244\260\340\244\276\340\244\240\340\245\200",
"my \341\200\231\341\200\274\341\200\224\341\200\272\341\200\231\341\200\254\341\200\205\341\200\254",
"nb Norsk",
"nl Nederlands",
"oc Occitan",
"pl Polski",
"pt Portugu\303\252s",
"pt_BR Portugu\303\252s (Brasil)",
"ro Rom\303\242n\304\203",
"ru \320\240\321\203\321\201\321\201\320\272\320\270\320\271",
"sk Sloven\304\215ina",
"sl Sloven\305\241\304\215ina",
"sr_RS \320\241\321\200\320\277\321\201\320\272\320\270",
"sr_RS@latin Srpski",
"sv Svenska",
"ta \340\256\244\340\256\256\340\256\277\340\256\264\340\257\215",
"tg \320\242\320\276\322\267\320\270\320\272\323\243",
"tr T\303\274rk\303\247e",
"uk \320\243\320\272\321\200\320\260\321\227\320\275\321\201\321\214\320\272\320\260",
"vi Ti\341\272\277ng Vi\341\273\207t",
"zh_CN \344\270\255\346\226\207\357\274\210\347\256\200\344\275\223\357\274\211",
"zh_TW \344\270\255\346\226\207\357\274\210\347\271\201\351\253\224\357\274\211",
   };
 
   TranslatableStrings tempNames;
   wxArrayString tempCodes;
   ReverseLangHash reverseHash;
   LangHash tempHash;
 
   const LangHash localLanguageName = []{
      LangHash localLanguageName;
      for ( auto utf8Name : utf8Names )
      {
         auto str = wxString::FromUTF8(utf8Name);
         auto code = str.BeforeFirst(' ');
         auto name = str.AfterFirst(' ');
         localLanguageName[code] = Verbatim( name );
      }
      return localLanguageName;
   }();
 
#if defined(__WXGTK__)
   {
      wxFileName pathNorm{ wxStandardPaths::Get().GetInstallPrefix() + L"/share/locale" };
      pathNorm.Normalize();
      const wxString newPath{ pathNorm.GetFullPath() };
      if (pathList.end() ==
          std::find(pathList.begin(), pathList.end(), newPath))
         pathList.push_back(newPath);
   }
#endif
 
   // For each language in our list we look for a corresponding entry in
   // wxLocale.
   for ( auto end = localLanguageName.end(), i = localLanguageName.begin();
      i != end; ++i )
   {
      const wxLanguageInfo *info = wxLocale::FindLanguageInfo(i->first);
 
      if (!info) {
         wxASSERT(info != NULL);
         continue;
      }
 
      wxString fullCode = info->CanonicalName;
      wxString code = fullCode.Left(2);
      auto name = Verbatim( info->Description );
 
      // Logic: Languages codes are sometimes hierarchical, with a
      // general language code and then a subheading.  For example,
      // zh_TW for Traditional Chinese and zh_CN for Simplified
      // Chinese - but just zh for Chinese in general.  First we look
      // for the full code, like zh_TW.  If that doesn't exist, we
      // look for a code corresponding to the first two letters.
      // Note that if the language for a fullCode exists but we only
      // have a name for the short code, we will use the short code's
      // name but associate it with the full code.  This allows someone
      // to drop in a NEW language and still get reasonable behavior.
 
      if (fullCode.length() < 2)
         continue;
 
      auto found = localLanguageName.find( code );
      if ( found != end ) {
         name = found->second;
      }
      found = localLanguageName.find( fullCode );
      if ( found != end ) {
         name = found->second;
      }
 
      if (TranslationExists(pathList, fullCode)) {
         code = fullCode;
      }
 
      if (!tempHash[code].empty())
         continue;
 
      if (TranslationExists(pathList, code) || code==wxT("en")) {
         tempCodes.push_back(code);
         tempNames.push_back(name);
         tempHash[code] = name;
 
/*         wxLogDebug(wxT("code=%s name=%s fullCode=%s name=%s -> %s"),
                      code, localLanguageName[code],
                      fullCode, localLanguageName[fullCode],
                      name);*/
      }
   }
 
   // JKC: Adding language for simplified audacity.
   {
      wxString code;
      code = wxT("en-simple");
      auto name = XO("Simplified");
      if (TranslationExists(pathList, code) ) {
         tempCodes.push_back(code);
         tempNames.push_back(name);
         tempHash[code] = name;
      }
   }
 
 
   // Sort
   unsigned int j;
   for(j=0; j<tempNames.size(); j++){
      reverseHash[tempNames[j]] = tempCodes[j];
   }
 
   std::sort(tempNames.begin(), tempNames.end(), TranslationLess);
 
   // Add system language
   langNames.push_back(XO("System"));
   langCodes.push_back(wxT("System"));
 
   for(j=0; j<tempNames.size(); j++) {
      langNames.push_back(tempNames[j]);
      langCodes.push_back(reverseHash[tempNames[j]]);
   }
}

References details::end(), BasicUI::Get(), name, str, TranslationExists(), TranslationLess(), Verbatim(), wxT(), and XO().

Referenced by GetSystemLanguageCode(), LangChoiceDialog::LangChoiceDialog(), and GUIPrefs::Populate().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetLocaleName()

STRINGS_API wxString Languages::GetLocaleName ( )

Returns: a string as from setlocale()

Definition at line 390 of file Languages.cpp.

{
   return sLocaleName;
}

References sLocaleName.

Referenced by AudacityApp::InitPart2().

Here is the caller graph for this function:

◆ GetSystemLanguageCode()

STRINGS_API wxString Languages::GetSystemLanguageCode ( const FilePaths & pathList )

Parameters

pathList paths to search for .mo files, grouped into subdirectories for the different languages

Definition at line 83 of file Languages.cpp.

{
   wxArrayString langCodes;
   TranslatableStrings langNames;
 
   GetLanguages(pathList, langCodes, langNames);
 
   const wxLanguageInfo *info;
 
#ifdef __WXMAC__
   // https://github.com/audacity/audacity/issues/2493
   // It was observed, that macOS can have multiple `system default` languages,
   // depending on the application rather than the user preferences.
   // As a workaround, let's query the locale preferences for the application.
   const wxCFStringRef appleLocale((CFStringRef)CFPreferencesCopyAppValue(CFSTR("AppleLocale"),
                             kCFPreferencesCurrentApplication));
 
   const auto localeString = appleLocale.AsString();
   // AppleLocale has `Apple` locale format, but let us try our luck
   // and pass it FindLanguageInfo, so we can get the best possible match.
   info = wxLocale::FindLanguageInfo(localeString);
 
   if (info == nullptr)
   {
      // Full match has failed, lets match the language code only.
      // wxLocale expects a two symbol code
      wxString langCode = localeString.Left(2);
      info = wxLocale::FindLanguageInfo(langCode);
   }
#else
   {
 
      const auto sysLang = wxLocale::GetSystemLanguage();
      info = wxLocale::GetLanguageInfo(sysLang);
   }
#endif
 
   if (info) {
      wxString fullCode = info->CanonicalName;
      if (fullCode.length() < 2)
         return wxT("en");
 
      wxString code = fullCode.Left(2);
      unsigned int i;
 
      for(i=0; i<langCodes.size(); i++) {
         if (langCodes[i] == fullCode)
            return fullCode;
 
         if (langCodes[i] == code)
            return code;
      }
   }
 
   return wxT("en");
}

References GetLanguages(), and wxT().

Referenced by LangChoiceDialog::LangChoiceDialog(), LangChoiceDialog::OnOk(), anonymous_namespace{AudacityApp.cpp}::PopulatePreferences(), NyquistEffect::Process(), and SetLang().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ SetLang()

STRINGS_API wxString Languages::SetLang	(	const FilePaths &	audacityPathList,
		const wxString &	lang
	)

Parameters

audacityPathList	paths to search for .mo files, grouped into subdirectories for the different languages
lang	a language code; or if empty or "System", then default to system language.

Returns: the language code actually used which is not lang if lang cannot be found.

Definition at line 324 of file Languages.cpp.

{
   wxString result = lang;
 
   sLocale.reset();
 
#if defined(__WXMAC__)
   // This should be reviewed again during the wx3 conversion.
 
   // On OSX, if the LANG environment variable isn't set when
   // using a language like Japanese, an assertion will trigger
   // because conversion to Japanese from "?" doesn't return a
   // valid length, so make OSX happy by defining/overriding
   // the LANG environment variable with U.S. English for now.
   wxSetEnv(wxT("LANG"), wxT("en_US.UTF-8"));
#endif
 
   const wxLanguageInfo *info = NULL;
   if (!lang.empty() && lang != wxT("System")) {
      // Try to find the given language
      info = wxLocale::FindLanguageInfo(lang);
   }
   if (!info)
   {
      // Not given a language or can't find it; substitute the system language
      result = Languages::GetSystemLanguageCode(pathList);
      info = wxLocale::FindLanguageInfo(result);
      if (!info)
         // Return the substituted system language, but we can't complete setup
         // Should we try to do something better?
         return result;
   }
   sLocale = std::make_unique<wxLocale>(info->Language);
 
   for( const auto &path : pathList )
      sLocale->AddCatalogLookupPathPrefix( path );
 
   // LL:  Must add the wxWidgets catalog manually since the search
   //      paths were not set up when mLocale was created.  The
   //      catalogs are search in LIFO order, so add wxstd first.
   sLocale->AddCatalog(wxT("wxstd"));
 
   // Must match TranslationExists() in Languages.cpp
   sLocale->AddCatalog("audacity");
 
   // Initialize internationalisation (number formats etc.)
   //
   // This must go _after_ creating the wxLocale instance because
   // creating the wxLocale instance sets the application-wide locale.
 
   Internat::Init();
 
   using future1 = decltype(
      // The file of unused strings is part of the source tree scanned by
      // xgettext when compiling the catalog template audacity.pot.
      // Including it here doesn't change that but does make the C++ compiler
      // check for correct syntax, but also generate no object code for them.
#include "FutureStrings.h"
      0
   );
 
   sLocaleName = wxSetlocale(LC_ALL, NULL);
 
   return result;
}

References GetSystemLanguageCode(), Internat::Init(), sLocale, sLocaleName, and wxT().

Referenced by GUISettings::SetLang().

Here is the call graph for this function:

Here is the caller graph for this function:

Variable Documentation

◆ sLocale

std::unique_ptr<wxLocale> Languages::sLocale

static

Definition at line 321 of file Languages.cpp.

Referenced by GetLang(), GetLangShort(), and SetLang().

◆ sLocaleName

wxString Languages::sLocaleName

static

Definition at line 322 of file Languages.cpp.

Referenced by GetLocaleName(), and SetLang().

Functions

Variables

Function Documentation

◆ GetLang()

◆ GetLangShort()

◆ GetLanguages()

◆ GetLocaleName()

◆ GetSystemLanguageCode()

◆ SetLang()

Variable Documentation

◆ sLocale

◆ sLocaleName