INI Files

On this page

Edit

General #

With the following commands you can save and load data to .ini files. Unlike with variables and stacks, the data is permanently saved and can be loaded again after you close and reopen LioranBoard.

Rules for saving and loading ini files:

Each file needs to have a specific structure for LioranBoard to read it, containing [section] and key=”value”.

Ini file structure

You can only save and load .ini files placed in your LioranBoard folder or one of its inner folders.
Make sure to use the right command for loading and saving data. There are different commands for text (strings) and different commands for numbers (real values).
Use relative path for loading and reading ini files. I.e. test.ini if you wanna load a file from your LioranBoard folder or /image/test.ini if you wanna load one from your LioranBoard/image folder.
You do not need to include the extension when loading a file. test is totally acceptable.

Edit

File: Save Number #

Saves a number to .ini file.

You cannot use File: Save Number on text (string).

Box Name	Type	Description
File Name	String	Name of the file. Will create one if it doesn’t exist. Do not include the path.
Section	String	The section to save the key under.
Key	String	Name of the value to be saved.
Value	String	Value to be saved as the key value.

Edit

File: Save Text #

Saves text (string) to .ini file.

You cannot use File: Save Text on number (real value).

Box Name	Type	Description
File Name	String	Name of the file. Will create one if it doesn’t exist. Do not include the path.
Section	String	The section to save the key under.
Key	String	Name of the value to be saved.
Text	String	Text to be saved as the key value.

Edit

File: Load Number #

Loads a number (real value) from .ini file. Will return 0 if it doesn’t exist.

You cannot use File: Load Number on text (string).

Box Name	Type	Description
File Name	String	Name of the file to load
Section	String	The section to load the key
Key	String	Name of the key to be loaded
Variable	String	Variable name you want to save the loaded string under

Edit

File: Load Text #

Loads text (string) from .ini file. Will return 0 if it doesn’t exist.

You cannot use File: Load Text on number (real value).

Box Name	Type	Description
File Name	String	Name of the file to load
Section	String	The section to load the key
Key	String	Name of the key to be loaded
Variable	String	Variable name you want to save the loaded string under

Edit

File: Delete Key #

Deletes a key within the specified section in a .ini file.

Box Name	Type	Description
File Name	String	Name of the file. Will create one if it doesn’t exist. Do not include the path.
Section	String	The section to find the key.
Key	String	Key to delete.

Edit

File: Delete Section #

Deletes a whole section of a .ini file, along with all its keys inside of it.

Box Name	Type	Description
File Name	String	Name of the file. Will create one if it doesn’t exist. Do not include the path.
Section	String	The section to delete.

Edit

File: Key Exists #

Check if a key exists within a given section of a .ini file.
Returns 1 if the key exists and 0 if it does not exist.

Box Name	Type	Description
File Name	String	Name of the file. Will create one if it doesn’t exist. Do not include the path.
Section	String	The section to look inside of.
Key	String	Name of the key you wish to check.
Variable	String	Variable to save the result in.

Edit

File: Section Exists #

Checks if a section exists within the specified .ini file.
Returns 1 if the section exists and 0 if it does not exist.

Box Name	Type	Description
File Name	String	Name of the file. Will create one if it doesn’t exist. Do not include the path.
Section	String	The section to check.
Variable	String	Variable to save the result in.