</code></pre></div></div> <p>Loads a given INI file and returns a permanent array (map) where keys are section names and values are permanent sub-arrays (maps) where keys and values are strings.</p> <ul> <li>Searches the file in the regular file system, like with all other ini-related functions.</li> <li>Subsequent calls for the same file will return the same array, unless it was disposed using <code class="language-plaintext highlighter-rouge">free_array</code>.</li> </ul><hr /> <h3 class="d-inline-block" id="get_ini_config_db"> <a href="#get_ini_config_db" class="anchor-heading" aria-labelledby="get_ini_config_db"><svg viewBox="0 0 16 16" aria-hidden="true"><use xlink:href="#svg-link"></use></svg></a> <strong>get_ini_config_db</strong> </h3> <p class="label label-green">sfall.h</p> <div class="language-c++ highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">array</span> <span class="n">get_ini_config_db</span><span class="p">(</span><span class="n">string</span> <span class="n">file</span><span class="p">)</span>
</code></pre></div></div> <p>Works exactly like <code class="language-plaintext highlighter-rouge">get_ini_config</code>, except it searches the file in database (DAT) files. If not found, then it will try the regular file system.</p><hr /> <h3 class="d-inline-block" id="get_ini_section"> <a href="#get_ini_section" class="anchor-heading" aria-labelledby="get_ini_section"><svg viewBox="0 0 16 16" aria-hidden="true"><use xlink:href="#svg-link"></use></svg></a> <strong>get_ini_section</strong> </h3> <p class="label label-green">sfall.h</p> <div class="language-c++ highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">array</span> <span class="n">get_ini_section</span><span class="p">(</span><span class="n">string</span> <span class="n">file</span><span class="p">,</span> <span class="n">string</span> <span class="n">sect</span><span class="p">)</span>
</code></pre></div></div> <p>Returns an associative array of keys and values for a given INI file and section.</p> <ul> <li>If the INI file is not found, it returns an empty array.</li> <li><strong>NOTE:</strong> all keys and their values will be of String type.</li> </ul><hr /> <h3 class="d-inline-block" id="get_ini_sections"> <a href="#get_ini_sections" class="anchor-heading" aria-labelledby="get_ini_sections"><svg viewBox="0 0 16 16" aria-hidden="true"><use xlink:href="#svg-link"></use></svg></a> <strong>get_ini_sections</strong> </h3> <p class="label label-green">sfall.h</p> <div class="language-c++ highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">array</span> <span class="n">get_ini_sections</span><span class="p">(</span><span class="n">string</span> <span class="n">file</span><span class="p">)</span>
</code></pre></div></div> <p>Returns an array of names of all sections in a given INI file.</p> <ul> <li>If the INI file is not found, it returns an empty array.</li> </ul><hr /> <h3 id="get_ini_setting"> <a href="#get_ini_setting" class="anchor-heading" aria-labelledby="get_ini_setting"><svg viewBox="0 0 16 16" aria-hidden="true"><use xlink:href="#svg-link"></use></svg></a> <strong>get_ini_setting</strong> </h3> <div class="language-c++ highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kt">int</span> <span class="n">get_ini_setting</span><span class="p">(</span><span class="n">string</span> <span class="n">setting</span><span class="p">)</span>
</code></pre></div></div> <p>Reads an integer value from an ini file in the Fallout directory.</p> <ul> <li>It only takes a single argument; seperate the file name, section and key with a “|” character; e.g. <code class="language-plaintext highlighter-rouge">myvar:=get_ini_setting("myini.ini|mysec|var1")</code></li> <li>If the file or key cannot be found or the setting argument is in an invalid format, it returns -1.</li> <li>The file name is limited to 63 chars, including the extension.</li> <li>The section name is limited to 32 characters.</li> <li>It can also be used to get sfall settings by using <strong>ddraw.ini</strong> as the file name.</li> </ul><hr /> <h3 id="get_ini_string"> <a href="#get_ini_string" class="anchor-heading" aria-labelledby="get_ini_string"><svg viewBox="0 0 16 16" aria-hidden="true"><use xlink:href="#svg-link"></use></svg></a> <strong>get_ini_string</strong> </h3> <div class="language-c++ highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">string</span> <span class="n">get_ini_string</span><span class="p">(</span><span class="n">string</span> <span class="n">setting</span><span class="p">)</span>
</code></pre></div></div> <p>Reads a string value from an ini file in the Fallout directory.</p> <ul> <li>If the file or key cannot be found, it returns an empty string.</li> <li>If the setting argument is in an invalid format, it returns -1 (integer).</li> </ul><hr /> <h3 id="modified_ini"> <a href="#modified_ini" class="anchor-heading" aria-labelledby="modified_ini"><svg viewBox="0 0 16 16" aria-hidden="true"><use xlink:href="#svg-link"></use></svg></a> <strong>modified_ini</strong> </h3> <div class="language-c++ highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kt">int</span> <span class="n">modified_ini</span>
</code></pre></div></div> <p>Writes an integer or a string value to an ini file in the Fallout directory. If the ini file does not exist, it will be created The setting argument works in the same way as in <code class="language-plaintext highlighter-rouge">get_ini_setting</code>, seperate the file name, section and key with a “|” character. <strong>Note:</strong> the file name is limited to 63 chars (including the extension), the section name is limited to 32 characters.</p> </main> </div> </div> <div class="search-overlay"></div> </div> </body> </html>