get_config_text man page

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

Referenced By

get_config_string(3), reload_config_texts(3).

version 4.4.2 Allegro manual