This singleton is designed to deal with multi-language text translation in TerraLib. More...

#include <Translator.h>

Public Member Functions
void	addTextDomain (const std::string &textDomain, const std::string &dir)
	It adds a new text domain (text catalog). More...

bool	exist (const std::string &textDomain)
	It returns true if the text domain (text catalog) exists and false otherwise. More...

void	loadAllTranslations (const std::string &translationsDir)
	It loads all translations on the translation share folder. More...

void	setLocale (const std::string &locale)
	It sets the locale for the Translator. More...

std::string	translate (const std::string &message)
	It tries to translate the specified text string. More...

std::string	translate (const char *message)
	It tries to translate the specified text string. More...

std::string	translate (const std::string &msg1, const std::string &msg2, unsigned int n)
	It tries to translate the specified text string accounting for plural forms. More...

std::string	translate (const char msg1, const char msg2, unsigned int n)
	It tries to translate the specified text string accounting for plural forms. More...

Static Public Member Functions
static Translator &	instance ()

Private Member Functions
Translator &	operator= (Translator const &)
	Singleton copy assignment operator must be private or protected. More...

	Translator ()
	Singleton constructor must be private or protected. More...

	Translator (Translator const &)
	Singleton copy constructor must be private or protected. More...

void	updateTranslationFiles ()
	Initializes the translation files, loading it into memory. It will overwrite the pior loaded list. More...

	~Translator ()
	Singleton destructor must be private or protected. More...

Private Attributes
bool	m_loadTranslationFiles

std::string	m_locale
	If not empty, it is the current locale. More...

boost::locale::generator *	m_localeGenerator

std::map< std::string, std::vector< std::string > >	m_textDomainMap
	A vector from text domains to base directory for the message catalog. More...

std::locale	m_translationLocale

Detailed Description

This singleton is designed to deal with multi-language text translation in TerraLib.

The Translator job is to manage "Internationalization" of the TerraLib messages. This class is all about Native Language Support. For each string you want to have a translation, you have to use the special macro TR_TR("string") or TE_TR_PLURAL("string1","string2", int). This macro does nothing with your code; its job is just to mark the code fragment that you want to translate and it does all the job of calling the translation for you. The translations are created with the GNU Gettext Utilities.

We provide a cmake module that searchs for all the necessary GNU Gettext tools, and adds a macro that creates the files for your translations. This macro searchs in a given directory for all ".cpp" files and for the given keywords inside the found files, then automatically generates the ".po", ".pot" and ".mo" files when you build your project. The macro implementation can be found in the file build/cmake/modules/FindGettext.cmake.

#include <terralib/core/translator/Translator.h>
...
TE_ADD_TEXT_DOMAIN("terralib_mod_core");
...
std::string msg = TE_TR("My Message");
...
or
...
std::cout << TE_TR_PLURAL("One message", "Two messages", 1);
...

Note that all marked messages will be part of a .pot file from where you can create several po documents, one for each idiom. These .po files can be used to generate a .mo binary file with the translation.

Warning: It is supposed that PO files are UTF-8 encoded.

Definition at line 94 of file Translator.h.

Constructor & Destructor Documentation

◆ Translator() [1/2]

te::core::Translator::Translator ( )

private

Singleton constructor must be private or protected.

◆ ~Translator()

te::core::Translator::~Translator ( )

private

Singleton destructor must be private or protected.

◆ Translator() [2/2]

te::core::Translator::Translator ( Translator const & )

private

Singleton copy constructor must be private or protected.

Member Function Documentation

◆ addTextDomain()

void te::core::Translator::addTextDomain	(	const std::string &	textDomain,
		const std::string &	dir
	)

It adds a new text domain (text catalog).

Parameters

textDomain	A given message domain (just a name). A text domain is the name of the catalog used to translate the message.
dir	Where the text domain is located.

Exceptions

Exception If the text domain already exists it raises an exception. If you are not sure about the existence of a text domain, use the exist() method.

◆ exist()

bool te::core::Translator::exist ( const std::string & textDomain )

It returns true if the text domain (text catalog) exists and false otherwise.

Parameters

textDomain A given message domain (just a name).

◆ instance()

static Translator& te::core::Translator::instance ( )

static

◆ loadAllTranslations()

void te::core::Translator::loadAllTranslations ( const std::string & translationsDir )

It loads all translations on the translation share folder.

◆ operator=()

Translator& te::core::Translator::operator= ( Translator const & )

private

Singleton copy assignment operator must be private or protected.

◆ setLocale()

void te::core::Translator::setLocale ( const std::string & locale )

It sets the locale for the Translator.

Parameters

locale A string of the new locale.

◆ translate() [1/4]

std::string te::core::Translator::translate ( const std::string & message )

It tries to translate the specified text string.

If no translation is available it will return the original message (always in English).

Parameters

message The text to be translated.

Returns: A string of the translated message. You must not delete the memory pointed by the returned pointer.

Note: The returned message is UTF-8 encoded.

◆ translate() [2/4]

std::string te::core::Translator::translate ( const char * message )

It tries to translate the specified text string.

If no translation is available it will return the original message (always in English).

Parameters

message The text to be translated.

Returns: A string of the translated message. You must not delete the memory pointed by the returned pointer.

Note: The returned message is UTF-8 encoded.

◆ translate() [3/4]

std::string te::core::Translator::translate	(	const std::string &	msg1,
		const std::string &	msg2,
		unsigned int	n
	)

It tries to translate the specified text string accounting for plural forms.

If no translation is available it will return the original message (always in English).

Parameters

msg1	The singular form of the text to be translated.
msg2	The plural form of the text to be translated.
n	This parameter is used to determine the plural form.

Returns: A string of the translated message. You must not delete the memory pointed by the returned pointer.

Note: The returned message is UTF-8 encoded.

◆ translate() [4/4]

std::string te::core::Translator::translate	(	const char *	msg1,
		const char *	msg2,
		unsigned int	n
	)

It tries to translate the specified text string accounting for plural forms.

If no translation is available it will return the original message (always in English).

Parameters

msg1	The singular form of the text to be translated.
msg2	The plural form of the text to be translated.
n	This parameter is used to determine the plural form.

Returns: A string of the translated message. You must not delete the memory pointed by the returned pointer.

Note: The returned message is UTF-8 encoded.

◆ updateTranslationFiles()

void te::core::Translator::updateTranslationFiles ( )

private

Initializes the translation files, loading it into memory. It will overwrite the pior loaded list.

Member Data Documentation

◆ m_loadTranslationFiles

bool te::core::Translator::m_loadTranslationFiles

private

Definition at line 219 of file Translator.h.

◆ m_locale

std::string te::core::Translator::m_locale

private

If not empty, it is the current locale.

Definition at line 217 of file Translator.h.

◆ m_localeGenerator

boost::locale::generator* te::core::Translator::m_localeGenerator

private

Definition at line 220 of file Translator.h.

◆ m_textDomainMap

std::map<std::string, std::vector<std::string> > te::core::Translator::m_textDomainMap

private

A vector from text domains to base directory for the message catalog.

Definition at line 218 of file Translator.h.

◆ m_translationLocale

std::locale te::core::Translator::m_translationLocale

private

Definition at line 221 of file Translator.h.

The documentation for this class was generated from the following file:

/home/castejon/castejon_files/develop/terralib5/git_release/src/terralib/core/translator/Translator.h

Public Member Functions

Static Public Member Functions

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ Translator() [1/2]

◆ ~Translator()

◆ Translator() [2/2]

Member Function Documentation

◆ addTextDomain()

◆ exist()

◆ instance()

◆ loadAllTranslations()

◆ operator=()

◆ setLocale()

◆ translate() [1/4]

◆ translate() [2/4]

◆ translate() [3/4]

◆ translate() [4/4]

◆ updateTranslationFiles()

Member Data Documentation

◆ m_loadTranslationFiles

◆ m_locale

◆ m_localeGenerator

◆ m_textDomainMap

◆ m_translationLocale