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(3alleg4), set_config_string(3alleg4), get_config_argv(3alleg4), get_config_float(3alleg4), get_config_hex(3alleg4), get_config_int(3alleg4), get_config_id(3alleg4), get_config_text(3alleg4), exconfig(3alleg4)