/**********************************************************************

  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__