Provided by: allegro4-doc_4.4.3.1-3_all bug

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(3alleg4), reload_config_texts(3alleg4)