Inifiles - Lesen und Schreiben

Die TDBINI.DLL enthält eine Hand voll Funktionen, die es Ihnen ermöglichen INI-Dateien zu erzeugen, zu manipulieren und zu lesen.

Um eine INI-Datei erzeugen oder lesen zu können müssen Sie mit IniFileOpen() ein Filehandle erzeugen, über das Sie im weiteren auf die Datei zugreifen. Es stehen Ihnen zwei Handles zur Verfügung; d.h. Sie können maximal auf zwei Dateien gleichzeitig zugreifen. Mit IniFilesLeft() können Sie jederzeit herausfinden, wieviele Handles noch verfügbar sind. Haben Sie alle Modifikationen an den INI-Dateien vorgenommen, dann schließen Sie diese mit IniFileClose() um diese zu aktuallisieren und die Handles wieder frei zu geben.

IniFileOpen(cFile : String; iMake : integer) : integer

Liefert das Filehandle (1 oder 2) zurück, wenn die INI-Datei cFile erfolgreich geöffnet/erzeugt werden kann und noch Filehandle verfügbar sind. Ansonsten ist das Ergebnis der Funktion 0. iMake teilt der Funktion mit, ob diese eine Datei erzeugen soll, wenn Sie noch nicht existiert. 0 bedeutet dabei "nicht anlegen", während bei iMake gleich 1 eine neue Datei angelegt wird.

IniFileClose(iF : integer) : integer

Schließt die Datei, der das handle iF entspricht und speichert alle Änderungen. Das Handle iF wird freigegeben und kann für eine andere Datei verwendet werden.

IniFilesLeft : integer

Liefert die Anzahl der noch verfügbaren Handles zurück.

IniReadString(iF : integer;var cValue : string; cSect : string; cItem : string)

Liest den Stringwert, der in der Datei iF in der Sektion cSect unter dem Item cItem gespeichert liegt in cValue ein.

IniWriteString(iF : integer; cSect : string; cItem : string; cValue : string; i : integer) : integer

Schreibt den Stringwert cValue in das Item cItem der Sektion cSect innerhalb der Datei iF. Das Ergebnis ist 1, wenn der Wert erfolgreich geschrieben werden konnte, ansonsten 0.

IniDeleteSection(iF : integer; cSect : string) : integer

Löscht eine komplette Sektion cSect aus der durch iF bestemmten Datei.War die Funktion erfolgreich, liefert sie als Ergebnis 1 zurück, andernfalls 0.