Man Linux: Main Page and Category List

NAME

       get_config_string  -  Retrieves  a  string from the configuration file.
       Allegro game programming library.

SYNOPSIS

       #include <allegro.h>

       const char *get_config_string(const char *section,  const  char  *name,
       const char *def);

DESCRIPTION

       Retrieves  a  string variable from the current config file. The section
       name may be set to NULL to read variables from the root of the file, or
       used to control which set of parameters (eg. sound or joystick) you are
       interested in reading. Example:

          const char *lang = get_config_string("system", "language", "EN");

RETURN VALUE

       Returns a pointer to the constant string  found  in  the  configuration
       file.   If  the  named  variable  cannot  be found, or its entry in the
       config file is empty, the value of `def' is returned.

SEE ALSO

       set_config_file(3alleg),                     set_config_string(3alleg),
       get_config_argv(3alleg),                      get_config_float(3alleg),
       get_config_hex(3alleg), get_config_int(3alleg),  get_config_id(3alleg),
       get_config_text(3alleg), exconfig(3alleg)