New library lib-strings for Identifier and internationalization

libraries/lib-strings/Languages.h

@@ -0,0 +1,60 @@
+/**********************************************************************
+
+  Audacity: A Digital Audio Editor
+
+  Languages.h
+
+  Dominic Mazzoni
+
+**********************************************************************/
+
+#ifndef __AUDACITY_LANGUAGES__
+#define __AUDACITY_LANGUAGES__
+
+class wxArrayString;
+class wxString;
+
+#include "Identifier.h"
+#include "Internat.h"
+
+namespace Languages {
+
+/*!
+ @param pathList paths to search for .mo files, grouped into subdirectories for the different
+    languages
+ @param[out] langCodes two-letter language abbreviations (like "fr") or language and country
+    (like "pt_BR")
+ @param[out] langNames corresponding autonyms of those languages (like "Português")
+ */
+STRINGS_API
+void GetLanguages( FilePaths pathList,
+   wxArrayString &langCodes, TranslatableStrings &langNames);
+
+/*!
+ @param pathList paths to search for .mo files, grouped into subdirectories for the different languages
+ */
+STRINGS_API
+wxString GetSystemLanguageCode(const FilePaths &pathList);
+
+/*!
+ @param audacityPathList paths to search for .mo files, grouped into subdirectories for the different languages
+ @param lang a language code; or if empty or "System", then default to system language.
+ @return the language code actually used which is not lang if lang cannot be found. */
+STRINGS_API
+wxString SetLang( const FilePaths &audacityPathList, const wxString & lang );
+
+/*! @return the last language code that was set */
+STRINGS_API
+wxString GetLang();
+
+/*! @return the last language code that was set (minus country code) */
+STRINGS_API
+wxString GetLangShort();
+
+/*! @return a string as from setlocale() */
+STRINGS_API
+wxString GetLocaleName();
+
+}
+
+#endif // __AUDACITY_LANGUAGES__