NAME
get_config_text - Returns a string translated to the current language.
Allegro game programming library.
SYNOPSIS
#include <allegro.h>
const char *get_config_text(const char *msg);
DESCRIPTION
This function is primarily intended for use by internal library code,
but it may perhaps be helpful to application programmers as well. It
uses the `language.dat' or `XXtext.cfg' files (where XX is a language
code) to look up a translated version of the parameter in the currently
selected language.
This is basically the same thing as calling get_config_string() with
`[language]' as the section, `msg' as the variable name, and `msg' as
the default value, but it contains some special code to handle Unicode
format conversions. The `msg' parameter is always given in ASCII
format, but the returned string will be converted into the current text
encoding, with memory being allocated as required, so you can assume
that this pointer will persist without having to manually allocate
storage space for each string.
Note that if you are planning on distributing your game on the Unix
platform there is a special issue with how to deal with the
`language.dat' file. Read section "Files shared by Allegro" of the
chapter "Unix specifics" to learn more about this.
RETURN VALUE
Returns a suitable translation if one can be found or a copy of the
parameter if nothing else is available.
SEE ALSO
get_config_string(3alleg), reload_config_texts(3alleg)