StelTranslator Class Reference

Class used to translate strings to any language. More...

#include <StelTranslator.hpp>

List of all members.

Public Member Functions
	StelTranslator (const QString &adomain, const QString &amoDirectory, const QString &alangName)
	Create a translator from a language name.
QString	qtranslate (const QString &s, const QString &c=QString())
	Translate input message and return it as a QString.
const QString &	getTrueLocaleName (void) const
	Get true translator locale name.
QStringList	getAvailableLanguagesNamesNative (const QString &localeDir="") const
	Get available language name in native language from passed locales directory.
Static Public Member Functions
static QString	iso639_1CodeToNativeName (const QString &languageCode)
	Convert from ISO639-1 langage code to native language name.
static QString	nativeNameToIso639_1Code (const QString &languageName)
	Convert from native language name to ISO639-1 2 letters langage code.
static void	init (const QString &fileName)
	Initialize Translation.
Static Public Attributes
static StelTranslator	globalTranslator
	Used as a global translator by the whole app.

---

Detailed Description

Class used to translate strings to any language.

Implements a nice interface to gettext which is UTF-8 compliant and is somewhat multiplateform All its operations do not modify the global locale. The purpose of this class is to remove all non-OO C locale functions from stellarium.

Author:

Fabien Chereau

---

Constructor & Destructor Documentation

StelTranslator::StelTranslator	(	const QString &	adomain,
		const QString &	amoDirectory,
		const QString &	alangName
	)			[inline]

Create a translator from a language name.

If the passed locale name cannot be handled by the system, default value will be used. The passed language name is a language code string like "fr" or "fr_FR". This class wrap gettext to simulate an object oriented multiplateform gettext UTF8 translator

Parameters:

	adomain	The name of the domain to use for translation
	amoDirectory	The directory where to look for the domain.mo translation files.
	alangName	The C locale name or language name like "fr" or "fr_FR". If string is "" or "system" it will use the system locale.

---

Member Function Documentation

QStringList StelTranslator::getAvailableLanguagesNamesNative

(

const QString &

localeDir = ""

)

const

Get available language name in native language from passed locales directory.

const QString& StelTranslator::getTrueLocaleName

(

void

)

const [inline]

Get true translator locale name.

Actual locale, never "system".

Returns:

Locale name e.g "fr_FR"

static void StelTranslator::init

(

const QString &

fileName

)

[static]

Initialize Translation.

Parameters:

fileName

file containing the list of language codes

static QString StelTranslator::iso639_1CodeToNativeName

(

const QString &

languageCode

)

[static]

Convert from ISO639-1 langage code to native language name.

Parameters:

languageCode

the code to look up

static QString StelTranslator::nativeNameToIso639_1Code

(

const QString &

languageName

)

[static]

Convert from native language name to ISO639-1 2 letters langage code.

QString StelTranslator::qtranslate	(	const QString &	s,
		const QString &	c = QString()
	)			[inline]

Translate input message and return it as a QString.

Parameters:

	s	input string in english.
	c	disambiguation string (gettext "context" string).

Returns:

The translated QString

---

Member Data Documentation

StelTranslator StelTranslator::globalTranslator [static]

Used as a global translator by the whole app.