Returns a string translated to the current language.
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
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
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.
Returns a suitable translation if one can be found or a copy of the
parameter if nothing else is available.
The following threads each have code containing this keyword:
Note: You can click on the numbers to jump directly to the posts that reference this page.
The following projects include source code containing this keyword: