/usr/share/doc/allegro5-doc/refman/config.html

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
  <meta http-equiv="Content-Style-Type" content="text/css" />
  <meta name="generator" content="pandoc" />
  <title>Configuration files</title>
  <style type="text/css">code{white-space: pre;}</style>
  <style type="text/css">
div.sourceCode { overflow-x: auto; }
table.sourceCode, tr.sourceCode, td.lineNumbers, td.sourceCode {
  margin: 0; padding: 0; vertical-align: baseline; border: none; }
table.sourceCode { width: 100%; line-height: 100%; }
td.lineNumbers { text-align: right; padding-right: 4px; padding-left: 4px; color: #aaaaaa; border-right: 1px solid #aaaaaa; }
td.sourceCode { padding-left: 5px; }
code > span.kw { color: #007020; font-weight: bold; } /* Keyword */
code > span.dt { color: #902000; } /* DataType */
code > span.dv { color: #40a070; } /* DecVal */
code > span.bn { color: #40a070; } /* BaseN */
code > span.fl { color: #40a070; } /* Float */
code > span.ch { color: #4070a0; } /* Char */
code > span.st { color: #4070a0; } /* String */
code > span.co { color: #60a0b0; font-style: italic; } /* Comment */
code > span.ot { color: #007020; } /* Other */
code > span.al { color: #ff0000; font-weight: bold; } /* Alert */
code > span.fu { color: #06287e; } /* Function */
code > span.er { color: #ff0000; font-weight: bold; } /* Error */
code > span.wa { color: #60a0b0; font-weight: bold; font-style: italic; } /* Warning */
code > span.cn { color: #880000; } /* Constant */
code > span.sc { color: #4070a0; } /* SpecialChar */
code > span.vs { color: #4070a0; } /* VerbatimString */
code > span.ss { color: #bb6688; } /* SpecialString */
code > span.im { } /* Import */
code > span.va { color: #19177c; } /* Variable */
code > span.cf { color: #007020; font-weight: bold; } /* ControlFlow */
code > span.op { color: #666666; } /* Operator */
code > span.bu { } /* BuiltIn */
code > span.ex { } /* Extension */
code > span.pp { color: #bc7a00; } /* Preprocessor */
code > span.at { color: #7d9029; } /* Attribute */
code > span.do { color: #ba2121; font-style: italic; } /* Documentation */
code > span.an { color: #60a0b0; font-weight: bold; font-style: italic; } /* Annotation */
code > span.cv { color: #60a0b0; font-weight: bold; font-style: italic; } /* CommentVar */
code > span.in { color: #60a0b0; font-weight: bold; font-style: italic; } /* Information */
  </style>
  <link rel="stylesheet" href="pandoc.css" type="text/css" />
  <script type="text/javascript" src="autosuggest.js"></script>
  <script type="text/javascript" src="search_index.js"></script>
</head>
<body>
<div class="sidebar">
<div>
<ul>
<li><a href="index.html"><strong>Contents</strong></a></li>
<li><a href="config.html">Configuration files</a></li>
<li><a href="display.html">Display</a></li>
<li><a href="events.html">Events</a></li>
<li><a href="file.html">File I/O</a></li>
<li><a href="fshook.html">Filesystem</a></li>
<li><a href="fixed.html">Fixed point math</a></li>
<li><a href="fullscreen_mode.html">Fullscreen modes</a></li>
<li><a href="graphics.html">Graphics</a></li>
<li><a href="haptic.html">Haptic</a></li>
<li><a href="joystick.html">Joystick</a></li>
<li><a href="keyboard.html">Keyboard</a></li>
<li><a href="memory.html">Memory</a></li>
<li><a href="monitor.html">Monitor</a></li>
<li><a href="mouse.html">Mouse</a></li>
<li><a href="path.html">Path</a></li>
<li><a href="shader.html">Shader</a></li>
<li><a href="state.html">State</a></li>
<li><a href="system.html">System</a></li>
<li><a href="threads.html">Threads</a></li>
<li><a href="time.html">Time</a></li>
<li><a href="timer.html">Timer</a></li>
<li><a href="touch.html">Touch input</a></li>
<li><a href="transformations.html">Transformations</a></li>
<li><a href="utf8.html">UTF-8</a></li>
<li><a href="misc.html">Miscellaneous</a></li>
<li><a href="platform.html">Platform-specific</a></li>
<li><a href="direct3d.html">Direct3D</a></li>
<li><a href="opengl.html">OpenGL</a></li>
</ul>
<!-- The preceding blank line forces pandoc to terminate the list -->
</div>
<div>
<ul>
<li><a href="index.html#addons"><strong>Addons</strong></a></li>
<li><a href="audio.html">Audio addon</a></li>
<li><a href="acodec.html">Audio codecs</a></li>
<li><a href="color.html">Color addon</a></li>
<li><a href="font.html">Font addons</a></li>
<li><a href="image.html">Image I/O addon</a></li>
<li><a href="main.html">Main addon</a></li>
<li><a href="memfile.html">Memfile addon</a></li>
<li><a href="native_dialog.html">Native dialogs addon</a></li>
<li><a href="physfs.html">PhysicsFS addon</a></li>
<li><a href="primitives.html">Primitives addon</a></li>
<li><a href="video.html">Video streaming addon</a></li>
</ul>
<!-- The preceding blank line forces pandoc to terminate the list -->
</div>
<div>
<ul>
<li><a href="index_all.html"><strong>Index</strong></a></li>
</ul>
<!-- The preceding blank line forces pandoc to terminate the list -->
</div>
<div class="searchbox">
<script type="text/javascript">
function on_search(index, control) {
    // Note to self: the less-than sign must NOT converted to an entity!
    // SCRIPT elements are special.  The HTML validator gives bad advice.
    for (i = 0; i < search_index.length; i++) {
        if (search_index[i] == control.keywords[index]) {
            break;
        }
    }
    location.href = search_urls[i];
}
</script>
Search<br/> <input type="text" name="q" id="q" size="15" autocomplete="off"/><br/>
<script type="text/javascript"> new autosuggest("q", search_index, null, on_search); </script>
</div>
</div>
<div class="content">
<div id="header">
<h1 class="title">Configuration files</h1>
</div>
<div id="TOC">
<ul>
<li><a href="#allegro_config">ALLEGRO_CONFIG</a></li>
<li><a href="#allegro_config_section">ALLEGRO_CONFIG_SECTION</a></li>
<li><a href="#allegro_config_entry">ALLEGRO_CONFIG_ENTRY</a></li>
<li><a href="#al_create_config">al_create_config</a></li>
<li><a href="#al_destroy_config">al_destroy_config</a></li>
<li><a href="#al_load_config_file">al_load_config_file</a></li>
<li><a href="#al_load_config_file_f">al_load_config_file_f</a></li>
<li><a href="#al_save_config_file">al_save_config_file</a></li>
<li><a href="#al_save_config_file_f">al_save_config_file_f</a></li>
<li><a href="#al_add_config_section">al_add_config_section</a></li>
<li><a href="#al_remove_config_section">al_remove_config_section</a></li>
<li><a href="#al_add_config_comment">al_add_config_comment</a></li>
<li><a href="#al_get_config_value">al_get_config_value</a></li>
<li><a href="#al_set_config_value">al_set_config_value</a></li>
<li><a href="#al_remove_config_key">al_remove_config_key</a></li>
<li><a href="#al_get_first_config_section">al_get_first_config_section</a></li>
<li><a href="#al_get_next_config_section">al_get_next_config_section</a></li>
<li><a href="#al_get_first_config_entry">al_get_first_config_entry</a></li>
<li><a href="#al_get_next_config_entry">al_get_next_config_entry</a></li>
<li><a href="#al_merge_config">al_merge_config</a></li>
<li><a href="#al_merge_config_into">al_merge_config_into</a></li>
</ul>
</div>
<p>These functions are declared in the main Allegro header file:</p>
<div class="sourceCode"><pre class="sourceCode c"><code class="sourceCode c"> <span class="pp">#include </span><span class="im">&lt;allegro5/allegro.h&gt;</span></code></pre></div>
<p>Allegro supports reading and writing of configuration files with a simple, INI file-like format.</p>
<p>A configuration file consists of key-value pairs separated by newlines. Keys are separated from values by an equals sign (<code>=</code>). All whitespace before the key, after the value and immediately adjacent to the equals sign is ignored. Keys and values may have whitespace characters within them. Keys do not need to be unique, but all but the last one are ignored.</p>
<p>The hash (<code>#</code>) character is used a comment when it is the first non-whitespace character on the line. All characters following that character are ignored to the end of the line. The hash character anywhere else on the line has no special significance.</p>
<p>Key-value pairs can be optionally grouped into sections, which are declared by surrounding a section name with square brackets (<code>[</code> and <code>]</code>) on a single line. Whitespace before the opening bracket is ignored. All characters after the trailing bracket are also ignored.</p>
<p>All key-value pairs that follow a section declaration belong to the last declared section. Key-value pairs that don't follow any section declarations belong to the global section. Sections do not nest.</p>
<p>Here is an example configuration file:</p>
<div class="sourceCode"><pre class="sourceCode ini"><code class="sourceCode ini"><span class="co">#  Monster description</span>
<span class="dt">monster name </span><span class="ot">=</span><span class="st"> Allegro Developer</span>

<span class="kw">[weapon 0]</span>
<span class="dt">damage </span><span class="ot">=</span><span class="st"> </span><span class="dv">443</span>

<span class="kw">[weapon 1]</span>
<span class="dt">damage </span><span class="ot">=</span><span class="st"> </span><span class="dv">503</span></code></pre></div>
<p>It can then be accessed like this (make sure to check for errors in an actual program):</p>
<div class="sourceCode"><pre class="sourceCode c"><code class="sourceCode c">ALLEGRO_CONFIG* cfg = al_load_config_file(<span class="st">&quot;test.cfg&quot;</span>);
printf(<span class="st">&quot;%s</span><span class="sc">\n</span><span class="st">&quot;</span>, al_get_config_value(cfg, <span class="st">&quot;&quot;</span>, <span class="st">&quot;monster name&quot;</span>)); <span class="co">/* Prints: Allegro Developer */</span>
printf(<span class="st">&quot;%s</span><span class="sc">\n</span><span class="st">&quot;</span>, al_get_config_value(cfg, <span class="st">&quot;weapon 0&quot;</span>, <span class="st">&quot;damage&quot;</span>)); <span class="co">/* Prints: 443 */</span>
printf(<span class="st">&quot;%s</span><span class="sc">\n</span><span class="st">&quot;</span>, al_get_config_value(cfg, <span class="st">&quot;weapon 1&quot;</span>, <span class="st">&quot;damage&quot;</span>)); <span class="co">/* Prints: 503 */</span>
al_destroy_config(cfg);</code></pre></div>
<h1 id="allegro_config">ALLEGRO_CONFIG</h1>
<div class="sourceCode"><pre class="sourceCode c"><code class="sourceCode c"><span class="kw">typedef</span> <span class="kw">struct</span> ALLEGRO_CONFIG ALLEGRO_CONFIG;</code></pre></div>
<p><a href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/config.h#L12">Source Code</a></p>
<p>An abstract configuration structure.</p>
<h1 id="allegro_config_section">ALLEGRO_CONFIG_SECTION</h1>
<div class="sourceCode"><pre class="sourceCode c"><code class="sourceCode c"><span class="kw">typedef</span> <span class="kw">struct</span> ALLEGRO_CONFIG_SECTION ALLEGRO_CONFIG_SECTION;</code></pre></div>
<p><a href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/config.h#L16">Source Code</a></p>
<p>An opaque structure used for iterating across sections in a configuration structure.</p>
<p>See also: <a href="config.html#al_get_first_config_section">al_get_first_config_section</a>, <a href="config.html#al_get_next_config_section">al_get_next_config_section</a></p>
<h1 id="allegro_config_entry">ALLEGRO_CONFIG_ENTRY</h1>
<div class="sourceCode"><pre class="sourceCode c"><code class="sourceCode c"><span class="kw">typedef</span> <span class="kw">struct</span> ALLEGRO_CONFIG_ENTRY ALLEGRO_CONFIG_ENTRY;</code></pre></div>
<p><a href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/config.h#L20">Source Code</a></p>
<p>An opaque structure used for iterating across entries in a configuration section.</p>
<p>See also: <a href="config.html#al_get_first_config_entry">al_get_first_config_entry</a>, <a href="config.html#al_get_next_config_entry">al_get_next_config_entry</a></p>
<h1 id="al_create_config">al_create_config</h1>
<div class="sourceCode"><pre class="sourceCode c"><code class="sourceCode c">ALLEGRO_CONFIG *al_create_config(<span class="dt">void</span>)</code></pre></div>
<p><a href="https://github.com/liballeg/allegro5/blob/master/src/config.c#L37">Source Code</a></p>
<p>Create an empty configuration structure.</p>
<p>See also: <a href="config.html#al_load_config_file">al_load_config_file</a>, <a href="config.html#al_destroy_config">al_destroy_config</a></p>
<h1 id="al_destroy_config">al_destroy_config</h1>
<div class="sourceCode"><pre class="sourceCode c"><code class="sourceCode c"><span class="dt">void</span> al_destroy_config(ALLEGRO_CONFIG *config)</code></pre></div>
<p><a href="https://github.com/liballeg/allegro5/blob/master/src/config.c#L566">Source Code</a></p>
<p>Free the resources used by a configuration structure. Does nothing if passed NULL.</p>
<p>See also: <a href="config.html#al_create_config">al_create_config</a>, <a href="config.html#al_load_config_file">al_load_config_file</a></p>
<h1 id="al_load_config_file">al_load_config_file</h1>
<div class="sourceCode"><pre class="sourceCode c"><code class="sourceCode c">ALLEGRO_CONFIG *al_load_config_file(<span class="dt">const</span> <span class="dt">char</span> *filename)</code></pre></div>
<p><a href="https://github.com/liballeg/allegro5/blob/master/src/config.c#L311">Source Code</a></p>
<p>Read a configuration file from disk. Returns NULL on error. The configuration structure should be destroyed with <a href="config.html#al_destroy_config">al_destroy_config</a>.</p>
<p>See also: <a href="config.html#al_load_config_file_f">al_load_config_file_f</a>, <a href="config.html#al_save_config_file">al_save_config_file</a></p>
<h1 id="al_load_config_file_f">al_load_config_file_f</h1>
<div class="sourceCode"><pre class="sourceCode c"><code class="sourceCode c">ALLEGRO_CONFIG *al_load_config_file_f(ALLEGRO_FILE *file)</code></pre></div>
<p><a href="https://github.com/liballeg/allegro5/blob/master/src/config.c#L328">Source Code</a></p>
<p>Read a configuration file from an already open file.</p>
<p>Returns NULL on error. The configuration structure should be destroyed with <a href="config.html#al_destroy_config">al_destroy_config</a>. The file remains open afterwards.</p>
<p>See also: <a href="config.html#al_load_config_file">al_load_config_file</a></p>
<h1 id="al_save_config_file">al_save_config_file</h1>
<div class="sourceCode"><pre class="sourceCode c"><code class="sourceCode c">bool al_save_config_file(<span class="dt">const</span> <span class="dt">char</span> *filename, <span class="dt">const</span> ALLEGRO_CONFIG *config)</code></pre></div>
<p><a href="https://github.com/liballeg/allegro5/blob/master/src/config.c#L435">Source Code</a></p>
<p>Write out a configuration file to disk. Returns true on success, false on error.</p>
<p>See also: <a href="config.html#al_save_config_file_f">al_save_config_file_f</a>, <a href="config.html#al_load_config_file">al_load_config_file</a></p>
<h1 id="al_save_config_file_f">al_save_config_file_f</h1>
<div class="sourceCode"><pre class="sourceCode c"><code class="sourceCode c">bool al_save_config_file_f(ALLEGRO_FILE *file, <span class="dt">const</span> ALLEGRO_CONFIG *config)</code></pre></div>
<p><a href="https://github.com/liballeg/allegro5/blob/master/src/config.c#L452">Source Code</a></p>
<p>Write out a configuration file to an already open file.</p>
<p>Returns true on success, false on error. The file remains open afterwards.</p>
<p>See also: <a href="config.html#al_save_config_file">al_save_config_file</a></p>
<h1 id="al_add_config_section">al_add_config_section</h1>
<div class="sourceCode"><pre class="sourceCode c"><code class="sourceCode c"><span class="dt">void</span> al_add_config_section(ALLEGRO_CONFIG *config, <span class="dt">const</span> <span class="dt">char</span> *name)</code></pre></div>
<p><a href="https://github.com/liballeg/allegro5/blob/master/src/config.c#L110">Source Code</a></p>
<p>Add a section to a configuration structure with the given name. If the section already exists then nothing happens.</p>
<h1 id="al_remove_config_section">al_remove_config_section</h1>
<div class="sourceCode"><pre class="sourceCode c"><code class="sourceCode c">bool al_remove_config_section(ALLEGRO_CONFIG *config, <span class="dt">char</span> <span class="dt">const</span> *section)</code></pre></div>
<p><a href="https://github.com/liballeg/allegro5/blob/master/src/config.c#L665">Source Code</a></p>
<p>Remove a section of a configuration.</p>
<p>Returns true if the section was removed, or false if the section did not exist.</p>
<p>Since: 5.1.5</p>
<h1 id="al_add_config_comment">al_add_config_comment</h1>
<div class="sourceCode"><pre class="sourceCode c"><code class="sourceCode c"><span class="dt">void</span> al_add_config_comment(ALLEGRO_CONFIG *config,
   <span class="dt">const</span> <span class="dt">char</span> *section, <span class="dt">const</span> <span class="dt">char</span> *comment)</code></pre></div>
<p><a href="https://github.com/liballeg/allegro5/blob/master/src/config.c#L225">Source Code</a></p>
<p>Add a comment in a section of a configuration. If the section doesn't yet exist, it will be created. The section can be NULL or &quot;&quot; for the global section.</p>
<p>The comment may or may not begin with a hash character. Any newlines in the comment string will be replaced by space characters.</p>
<p>See also: <a href="config.html#al_add_config_section">al_add_config_section</a></p>
<h1 id="al_get_config_value">al_get_config_value</h1>
<div class="sourceCode"><pre class="sourceCode c"><code class="sourceCode c"><span class="dt">const</span> <span class="dt">char</span> *al_get_config_value(<span class="dt">const</span> ALLEGRO_CONFIG *config,
   <span class="dt">const</span> <span class="dt">char</span> *section, <span class="dt">const</span> <span class="dt">char</span> *key)</code></pre></div>
<p><a href="https://github.com/liballeg/allegro5/blob/master/src/config.c#L268">Source Code</a></p>
<p>Gets a pointer to an internal character buffer that will only remain valid as long as the ALLEGRO_CONFIG structure is not destroyed. Copy the value if you need a copy. The section can be NULL or &quot;&quot; for the global section. Returns NULL if the section or key do not exist.</p>
<p>See also: <a href="config.html#al_set_config_value">al_set_config_value</a></p>
<h1 id="al_set_config_value">al_set_config_value</h1>
<div class="sourceCode"><pre class="sourceCode c"><code class="sourceCode c"><span class="dt">void</span> al_set_config_value(ALLEGRO_CONFIG *config,
   <span class="dt">const</span> <span class="dt">char</span> *section, <span class="dt">const</span> <span class="dt">char</span> *key, <span class="dt">const</span> <span class="dt">char</span> *value)</code></pre></div>
<p><a href="https://github.com/liballeg/allegro5/blob/master/src/config.c#L164">Source Code</a></p>
<p>Set a value in a section of a configuration. If the section doesn't yet exist, it will be created. If a value already existed for the given key, it will be overwritten. The section can be NULL or &quot;&quot; for the global section.</p>
<p>For consistency with the on-disk format of config files, any leading and trailing whitespace will be stripped from the value. If you have significant whitespace you wish to preserve, you should add your own quote characters and remove them when reading the values back in.</p>
<p>See also: <a href="config.html#al_get_config_value">al_get_config_value</a></p>
<h1 id="al_remove_config_key">al_remove_config_key</h1>
<div class="sourceCode"><pre class="sourceCode c"><code class="sourceCode c">bool al_remove_config_key(ALLEGRO_CONFIG *config, <span class="dt">char</span> <span class="dt">const</span> *section,
   <span class="dt">char</span> <span class="dt">const</span> *key)</code></pre></div>
<p><a href="https://github.com/liballeg/allegro5/blob/master/src/config.c#L702">Source Code</a></p>
<p>Remove a key and its associated value in a section of a configuration.</p>
<p>Returns true if the entry was removed, or false if the entry did not exist.</p>
<p>Since: 5.1.5</p>
<h1 id="al_get_first_config_section">al_get_first_config_section</h1>
<div class="sourceCode"><pre class="sourceCode c"><code class="sourceCode c"><span class="dt">char</span> <span class="dt">const</span> *al_get_first_config_section(ALLEGRO_CONFIG <span class="dt">const</span> *config,
   ALLEGRO_CONFIG_SECTION **iterator)</code></pre></div>
<p><a href="https://github.com/liballeg/allegro5/blob/master/src/config.c#L588">Source Code</a></p>
<p>Returns the name of the first section in the given config file. Usually this will return an empty string for the global section, even it contains no values. The <code>iterator</code> parameter will receive an opaque iterator which is used by <a href="config.html#al_get_next_config_section">al_get_next_config_section</a> to iterate over the remaining sections.</p>
<p>The returned string and the iterator are only valid as long as no change is made to the passed ALLEGRO_CONFIG.</p>
<p>See also: <a href="config.html#al_get_next_config_section">al_get_next_config_section</a></p>
<h1 id="al_get_next_config_section">al_get_next_config_section</h1>
<div class="sourceCode"><pre class="sourceCode c"><code class="sourceCode c"><span class="dt">char</span> <span class="dt">const</span> *al_get_next_config_section(ALLEGRO_CONFIG_SECTION **iterator)</code></pre></div>
<p><a href="https://github.com/liballeg/allegro5/blob/master/src/config.c#L603">Source Code</a></p>
<p>Returns the name of the next section in the given config file or NULL if there are no more sections. The <code>iterator</code> must have been obtained with <a href="config.html#al_get_first_config_section">al_get_first_config_section</a> first.</p>
<p>See also: <a href="config.html#al_get_first_config_section">al_get_first_config_section</a></p>
<h1 id="al_get_first_config_entry">al_get_first_config_entry</h1>
<div class="sourceCode"><pre class="sourceCode c"><code class="sourceCode c"><span class="dt">char</span> <span class="dt">const</span> *al_get_first_config_entry(ALLEGRO_CONFIG <span class="dt">const</span> *config,
   <span class="dt">char</span> <span class="dt">const</span> *section, ALLEGRO_CONFIG_ENTRY **iterator)</code></pre></div>
<p><a href="https://github.com/liballeg/allegro5/blob/master/src/config.c#L619">Source Code</a></p>
<p>Returns the name of the first key in the given section in the given config or NULL if the section is empty. The <code>iterator</code> works like the one for <a href="config.html#al_get_first_config_section">al_get_first_config_section</a>.</p>
<p>The returned string and the iterator are only valid as long as no change is made to the passed <a href="config.html#allegro_config">ALLEGRO_CONFIG</a>.</p>
<p>See also: <a href="config.html#al_get_next_config_entry">al_get_next_config_entry</a></p>
<h1 id="al_get_next_config_entry">al_get_next_config_entry</h1>
<div class="sourceCode"><pre class="sourceCode c"><code class="sourceCode c"><span class="dt">char</span> <span class="dt">const</span> *al_get_next_config_entry(ALLEGRO_CONFIG_ENTRY **iterator)</code></pre></div>
<p><a href="https://github.com/liballeg/allegro5/blob/master/src/config.c#L647">Source Code</a></p>
<p>Returns the next key for the iterator obtained by <a href="config.html#al_get_first_config_entry">al_get_first_config_entry</a>. The <code>iterator</code> works like the one for <a href="config.html#al_get_next_config_section">al_get_next_config_section</a>.</p>
<h1 id="al_merge_config">al_merge_config</h1>
<div class="sourceCode"><pre class="sourceCode c"><code class="sourceCode c">ALLEGRO_CONFIG *al_merge_config(<span class="dt">const</span> ALLEGRO_CONFIG *cfg1,
    <span class="dt">const</span> ALLEGRO_CONFIG *cfg2)</code></pre></div>
<p><a href="https://github.com/liballeg/allegro5/blob/master/src/config.c#L530">Source Code</a></p>
<p>Merge two configuration structures, and return the result as a new configuration. Values in configuration 'cfg2' override those in 'cfg1'. Neither of the input configuration structures are modified. Comments from 'cfg2' are not retained.</p>
<p>See also: <a href="config.html#al_merge_config_into">al_merge_config_into</a></p>
<h1 id="al_merge_config_into">al_merge_config_into</h1>
<div class="sourceCode"><pre class="sourceCode c"><code class="sourceCode c"><span class="dt">void</span> al_merge_config_into(ALLEGRO_CONFIG *master, <span class="dt">const</span> ALLEGRO_CONFIG *add)</code></pre></div>
<p><a href="https://github.com/liballeg/allegro5/blob/master/src/config.c#L522">Source Code</a></p>
<p>Merge one configuration structure into another. Values in configuration 'add' override those in 'master'. 'master' is modified. Comments from 'add' are not retained.</p>
<p>See also: <a href="config.html#al_merge_config">al_merge_config</a></p>
<p class="timestamp">
Allegro version 5.2.2
 - Last updated: 2017-01-02 15:17:30 UTC
</p>
</div>
</body>
</html>
allegro5-doc 2:5.2.2-1 / usr / share / doc / allegro5-doc / refman / config.html
