INI Configuration

The TIniFile class provides a simple way to read and write configuration settings using the standard Windows INI format.

Basic Usage

uses System.IniFiles;

var ini := new TIniFile('.data/config.ini');
try
  // Writing
  ini.WriteString('Server', 'Host', 'localhost');
  ini.WriteString('Server', 'Port', '8080');
  
  // Reading
  var host := ini.ReadString('Server', 'Host', '127.0.0.1');
finally
  ini.Free;
end;

In-Memory Parsing

You can also use CreateInMemory to parse INI-formatted strings directly without using the file system.

uses System.IniFiles;

var raw := '[User]' + #13#10 + 'Name=Alice';
var ini := TIniFile.CreateInMemory(raw);

PrintLn(ini.ReadString('User', 'Name', 'Unknown'));
Result
Alice

Related Reference

For a full list of methods for managing sections and keys, see the reference documentation:

On this page