Man Linux: Main Page and Category List

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(3alleg),                     get_config_string(3alleg),
       set_config_float(3alleg),                       set_config_hex(3alleg),
       set_config_int(3alleg), set_config_id(3alleg)