NAME

       set_config_string - Writes a string in the configuration file. Allegro game programming library.

SYNOPSIS

       #include <allegro.h>

       void set_config_string(const char *section, const char *name, const char *val);

DESCRIPTION

       Writes a string variable to the current config file, replacing any existing value it may have, or removes
       the variable if `val' is NULL. The section name may be set to NULL to write the variable to the  root  of
       the file, or used to control which section the variable is inserted into. The altered file will be cached
       in memory, and not actually written to disk until you call allegro_exit(). Note that you can  only  write
       to files in this way, so the function will have no effect if the current config source was specified with
       set_config_data() rather than set_config_file().

       As a special case, variable or section names that begin with a '#' character are  treated  specially  and
       will  not be read from or written to the disk. Addon packages can use this to store version info or other
       status information into the config module, from  where  it  can  be  read  with  the  get_config_string()
       function.

SEE ALSO

       set_config_file(3alleg4), get_config_string(3alleg4), set_config_float(3alleg4), set_config_hex(3alleg4),
       set_config_int(3alleg4), set_config_id(3alleg4)