Rename metarule for consistency with other ini-related functions, add to functions.yml

artifacts/scripting/functions.yml

@@ -1866,6 +1866,17 @@
       Returns an array of names of all sections in a given INI file.
       - If INI file is not found, will return an empty array.
     macro: sfall.h
+  - name: get_ini_config
+    detail: array get_ini_config(string file)
+    doc: |
+      Loads given INI file and returns a permanent array (map) where keys are section names and values are other permanent arrays (maps) where keys and values are strings.
+      - File will be searched in normal file system like with all other ini-related functions.
+      - Subsequent calls for the same file will return the same array, unless it was disposed using free_array.
+    macro: sfall.h
+  - name: get_ini_config_db
+    detail: array get_ini_config_db(string file)
+    doc: Works exactly like get_ini_config except files are loaded from database (DAT) instead of regular file system.
+    macro: sfall.h
   - name: set_ini_setting
     detail: void set_ini_setting(string setting, int/string value)
     doc: '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 `get_ini_setting`, seperate the file name, section and key with a "|" character. __Note:__ the file name is limited to 63 chars (including the extension), the section name is limited to 32 characters.'

artifacts/scripting/headers/sfall.h

@@ -307,6 +307,8 @@
 #define get_current_terrain_name                                sfall_func0("get_terrain_name")
 #define get_cursor_mode                                         sfall_func0("get_cursor_mode")
 #define get_flags(obj)                                          sfall_func1("get_flags", obj)
+#define get_ini_config(file)                                    sfall_func2("get_ini_config", file, 0)
+#define get_ini_config_db(file)                                 sfall_func2("get_ini_config", file, 1)
 #define get_ini_section(file, sect)                             sfall_func2("get_ini_section", file, sect)
 #define get_ini_sections(file)                                  sfall_func1("get_ini_sections", file)
 #define get_interface_rect(winType)                             sfall_func2("get_window_attribute", winType, -1)