Работа с ini файлами в Delphi

Вообще, ini-файлы – очень удобная вещь. В ini-файл можно записать практически всё, хотя создан он в основном для хранения настроек программы.

Структура ini-файла очень проста: весь файл поделён на секции. В секциях содержатся ключи и эти ключи хранят значения. Вот пример открытого в блокноте ini-файла:

[Form properties]
Width=450
Height=320
Left=10
Top=35
[Application properties]
Dir=C:\Мои документы\Musuc
Date=28.09.02
В этом ини-файле, как мы видим, 2 секции: Form properties и Application properties. В каждой из этих секций есть ключи, содержащие числа, строковые выражения, дату. Запись в файл осуществляется путём указания секции ини-файла, названия ключа и указания самого значения. Ниже я опишу способы использования ини-файла на Borland Delphi.

Для работы с ини-файлами в Delphi существует модуль IniFiles. В нём описан нужный нам класс TIniFile.

1. Включите Delphi и создайте новый проект.

2. Допишите в Uses новый модуль IniFiles.

3. Создайте глобальную переменную класса TIniFile.

var 
  Form1: TForm1;
  IniFile: TIniFile;
4. При создании формы надо инициализировать переменную IniFile:

procedure TForm1.FormCreate(Sender: TObject);
begin
  IniFile:=TIniFile.Create('C:\Program files\MyApplication\MyIni.ini');
end;
Инициализация проходит с участием дополнительного параметра типа string. Это имя файла. Если имя введено не полностью, а, например, так: 'MyIni.ini', то файл создастся при записи в папке Windows. Я же рекомендую создавать файл в папке с программой (её можно узнать так: ExtractFilePath(Application.ExeName)).

5. Как осуществить запись в файл? Для записи в ини-файл есть несколько процедур у класса TIniFile - смотря что надо записать.

Процедура записи строки:

WriteString(const Section, Ident, Value: string);
Процедура записи цифры:

WriteInteger(const Section, Ident: string; Value: Longint);
Процедура записи булевого выражения:

WriteBool(const Section, Ident: string; Value: Boolean);
Запись даты:

WriteDate(const Section, Name: string; Value: TDateTime);
Запись время:

WriteTime(const Section, Name: string; Value: TDateTime);
Запись даты и время вместе:

WriteDateTime(const Section, Name: string; Value: TDateTime);
Запись не целого численного значения:

WriteFloat(const Section, Name: string; Value: Double);
Запись потока:

WriteBinaryStream(const Section, Name: string;Value: TStream);
Во всех этих функциях обязательно указывать секцию (Section), имя ключа (Name) и записываемое значение.

Для наглядности вы можете поместить на форму кнопку и по её нажатию можете прописать следующее:

procedure TForm1.Button2Click(Sender: TObject);
begin
  IniFile.WriteString('Form info','Form caption',Caption);
  IniFile.WriteInteger('Form info','Left',Left);
  IniFile.WriteInteger('Form info','Top',Top);
  IniFile.WriteInteger('Form info','Width',Width);
  IniFile.WriteInteger('Form info','Height',Height);
  IniFile.WriteTime('Other','Write time',Time);
end;
По выполнению этого кода программа создаст (если ещё не создан) файл в указанном при процедуре Create месте и запишет в него примерно следующее:

[Form info]
Form caption=Form1
Left=192
Top=107
Width=544
Height=375
[Other]
Write time=23:13:55
6. Процедура чтения из ини-файла осуществляется похожим способом. Для чтения существуют функции:

ReadString(const Section, Ident, Default: string): string;
ReadInteger(const Section, Ident: string; Default: Longint): Longint;
ReadBool(const Section, Ident: string; Default: Boolean): Boolean;
ReadBinaryStream(const Section, Name: string; Value: TStream): Integer;
ReadDate(const Section, Name: string; Default: TDateTime): TDateTime;
ReadDateTime(const Section, Name: string; Default: TDateTime): TDateTime;
ReadFloat(const Section, Name: string; Default: Double): Double;
ReadTime(const Section, Name: string; Default: TDateTime): TDateTime;
Каждая функция возвращает прочтённое из файла значение. Если по каким-либо причинам прочтение не удалось, то функция возвращает значение, указанное в параметре самой функции как Default.

Например, для прочтения из нашего ини-файла значения Form caption надо написать следующее:

Edit1.Text:=IniFile.ReadString('Form info',
       'Form caption','Ошибка при чтении!');
В этом примере тексту помещённого на форму Edit-а присваивается прочтённое из файла значение. В нашем случае тексту Edit-а будет присвоено значение «Form1». Если чтение не удастся, то тексту Edit-а будет присвоено значение «Ошибка при чтении».

Другие процедуры и функции для работы с ини-файлами:

Проверка, существует ли секция:

function SectionExists(const Section: string): Boolean;
Прочтение всей секции:

procedure ReadSection(const Section: string; Strings: TStrings);
Прочтение всего файла (все секции записываются в Strings):

procedure ReadSections(Strings: TStrings);
Прочтение всех значений в заданной секции:

procedure ReadSectionValues(const Section: string; Strings: TStrings);
Удалить заданную секцию со всеми её значениями:

procedure EraseSection(const Section: string);
Удаление определённого ключа (и его значения) в секции:

procedure DeleteKey(const Section, Ident: String);
Проверка, существует ли заданный ключ в указанной секции:

function ValueExists(const Section, Ident: string): Boolean; 