1set_config_string(3) Allegro manual set_config_string(3)
2
3
4
6 set_config_string - Writes a string in the configuration file. Allegro
7 game programming library.
8
10 #include <allegro.h>
11
12
13 void set_config_string(const char *section, const char *name, const
14 char *val);
15
17 Writes a string variable to the current config file, replacing any
18 existing value it may have, or removes the variable if `val' is NULL.
19 The section name may be set to NULL to write the variable to the root
20 of the file, or used to control which section the variable is inserted
21 into. The altered file will be cached in memory, and not actually writ‐
22 ten to disk until you call allegro_exit(). Note that you can only write
23 to files in this way, so the function will have no effect if the cur‐
24 rent config source was specified with set_config_data() rather than
25 set_config_file().
26
27 As a special case, variable or section names that begin with a '#'
28 character are treated specially and will not be read from or written to
29 the disk. Addon packages can use this to store version info or other
30 status information into the config module, from where it can be read
31 with the get_config_string() function.
32
33
35 set_config_file(3), get_config_string(3), set_config_float(3), set_con‐
36 fig_hex(3), set_config_int(3), set_config_id(3)
37
38
39
40Allegro version 4.4.3 set_config_string(3)