Initialisierungsdatei

Eine Initialisierungsdatei (kurz INI-Datei) ist eine Textdatei, die z. B. unter Windows zum Ablegen von Programmeinstellungen (z. B. Position des Programmfensters) verwendet wird. Bei erneutem Aufruf des Programms werden die Programmeinstellungen eingelesen, um den Zustand vor dem letzten Schließen wieder einzunehmen.

INI-Dateien im Programm- oder Systemverzeichnis, wie es zum Beispiel unter Windows 3.1 noch üblich war, sind unter neueren Windowsversionen immer weniger gebräuchlich, da Programmeinstellungen meist in der Registry oder bei NT-basierten Versionen im Anwendungsdatenverzeichnis des Benutzerprofils abgelegt werden.

Aufbau

 ;Kommentar
 [Sektion]
 ;Kommentar
 Schlüssel=Wert

Eine INI-Datei kann in Sektionen unterteilt werden, deren Namen jeweils am Anfang stehen und mit eckigen Klammern umschlossen sein müssen.

Jede Information wird als Paar aus Schlüssel und zugehörigem Wert gespeichert bzw. gelesen.

Bei dem Erstellen einer INI-Datei sind folgende Regeln zu beachten:

• Jede Sektion darf nur einmal vorkommen.
• Jeder Schlüssel darf nur einmal je Sektion vorkommen.
• Auf Werte wird mittels Sektion und Schlüssel zugegriffen.
• Kommentare werden mit einem ";" eingeleitet.
• Kommentare dürfen nur auf separaten Zeilen (nicht hinter Sektionsüberschriften oder Schlüsseln) stehen.
• Leerzeichen und Anführungszeichen werden von verschiedenen Programmen teilweise unterschiedlich behandelt.
• Groß-/Kleinschreibung wird nicht unterschieden
• No und False werden als 0, True und Yes als 1 interpretiert.

Es gibt Dateien mit nahezu demselben Aufbau, die sich lediglich durch folgende Merkmale unterscheiden:

• Andere (z. B. conf und cfg) oder fehlende Dateiendung
• Einleitung von Kommentaren mit einem anderen Zeichen (z. B. "#").

Ein Beispiel für eine solche Variation findet sich in den Konfigurationsdateien für Subversion-Repositories.

Weblinks

• GetPrivateProfileString: Microsoft Windows API-Funktion zum Auslesen von Werten aus einer INI-Datei.
• GetPrivateProfileSection: Microsoft Windows API-Funktion zum Auslesen von allen Schlüsseln und Werten aus einer Sektion der INI-Datei.
• GetPrivateProfileSectionNames: Microsoft Windows API-Funktion zum Auslesen von Sektionen aus einer INI-Datei.