set_config_string - Man Page

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

Referenced By

get_config_string(3), remove_keyboard(3), set_config_data(3), set_config_file(3), set_config_float(3), set_config_hex(3), set_config_id(3), set_config_int(3).

version 4.4.3 Allegro manual