To support having multiple INI files open at once, functions for opening/creating files return a new INI "structure" (technically an array), and other functions take this structure as first argument. This isn't all too different from file_text_ or buffer_ functions.
Opens a file by path and returns the INI file.
If the optional secure argument is true, uses the built-in ds_map_secure_* functions to load/save, although this is no longer considered a good measure and you should probably use file_ini_parse with some different method of verifying integrity.
Much like the built-in function, if the path is not valid, assumes the file to be empty.
Creates a blank INI file.
Note that this will not bind the file to a path, so you will need to use file_ini_bind if you need to save it on disk.
Parses an INI structure from a string.
This is roughly equivalent to the built-in ini_open_from_string function that was introduced after the extension's release.
Note that this will not bind the file to a path, so you will need to use file_ini_bind if you need to save it on disk.
Flushes any unsaved changes to disk and destroys the INI file.
Destroys an INI file without saving any changes to disk.
Flushes any unsaved changes to disk without destroying the INI file.
This is the preferred method if you use INI for saving player progress - then you will not need to re-open it.
Returns the current state of an INI file as a string - essentially, the same thing that would be written to a file on close/flush.
For files not bound to disk paths, you would use print+destroy to get the changed string and clean up the structure.
Changes what path an INI file is bound to.
If path argument is provided, changes the path that the file will save to via file_ini_flush / file_ini_close, otherwise disables saving to disk.
If the optional secure argument is true, uses the built-in ds_map_secure_* functions to load/save, although this is no longer considered a good measure and you should probably use file_ini_parse with some different method of verifying integrity.