1get_config_text(3)              Allegro manual              get_config_text(3)
2
3
4

NAME

6       get_config_text  - Returns a string translated to the current language.
7       Allegro game programming library.
8

SYNOPSIS

10       #include <allegro.h>
11
12
13       const char *get_config_text(const char *msg);
14

DESCRIPTION

16       This function is primarily intended for use by internal  library  code,
17       but  it  may  perhaps be helpful to application programmers as well. It
18       uses the `language.dat' or `XXtext.cfg' files (where XX is  a  language
19       code) to look up a translated version of the parameter in the currently
20       selected language.
21
22       This is basically the same thing as  calling  get_config_string()  with
23       `[language]'  as  the section, `msg' as the variable name, and `msg' as
24       the default value, but it contains some special code to handle  Unicode
25       format  conversions.  The `msg' parameter is always given in ASCII for‐
26       mat, but the returned string will be converted into  the  current  text
27       encoding,  with  memory  being allocated as required, so you can assume
28       that this pointer will persist  without  having  to  manually  allocate
29       storage space for each string.
30
31       Note  that  if  you  are planning on distributing your game on the Unix
32       platform there is a special issue with  how  to  deal  with  the  `lan‐
33       guage.dat'  file. Read section "Files shared by Allegro" of the chapter
34       "Unix specifics" to learn more about this.
35

RETURN VALUE

37       Returns a suitable translation if one can be found or  a  copy  of  the
38       parameter if nothing else is available.
39
40

SEE ALSO

42       get_config_string(3), reload_config_texts(3)
43
44
45
46Allegro                          version 4.2.2              get_config_text(3)
Impressum