IniRead

Liest einen Wert, eine Sektion oder eine Liste von Sektionsnamen aus einer INI-Datei im Standardformat.

Wert := IniRead(DateiName, Sektion, Schlüssel , Standardwert)
Sektion := IniRead(DateiName, Sektion)
SektionNamen := IniRead(DateiName)

Parameter

DateiName

Typ: Zeichenkette

Name der INI-Datei. Wenn kein absoluter Pfad angegeben ist, wird die Datei im A_WorkingDir-Verzeichnis vermutet.

Sektion

Typ: Zeichenkette

Name einer Sektion in der INI-Datei, erkennbar an den eckigen Klammern (die Klammern müssen in diesem Parameter weggelassen werden).

Schlüssel

Typ: Zeichenkette

Name eines Schlüssels in der INI-Datei.

Standardwert

Typ: Zeichenkette

Wenn weggelassen, wird bei Misserfolg ein OSError ausgelöst. Andernfalls geben Sie den Wert an, der bei Misserfolg zurückgegeben werden soll, z.B. wenn der Schlüssel, die Sektion oder die Datei nicht gefunden wird.

Rückgabewert

Typ: Zeichenkette

Diese Funktion gibt den aktuellen Wert des angegebenen Schlüssels zurück. Wenn der Wert nicht abgerufen werden kann, wird der Standardwert zurückgegeben (sofern angegeben).

Wenn der Schlüssel-Parameter weggelassen wird, gibt diese Funktion eine komplette Sektion zurück. Kommentare und Leerzeilen werden weggelassen. Es werden nur die ersten 65533 Zeichen der Sektion abgerufen.

Wenn die Parameter Schlüssel und Sektion weggelassen werden, gibt diese Funktion eine Liste von Sektionsnamen zurück, die alle mit einem Zeilenvorschub (`n) voneinander getrennt sind.

Fehlerbehandlung

Bei Misserfolg wird ein OSError ausgelöst, es sei denn, Standardwert wird verwendet.

A_LastError wird immer auf das Ergebnis der Systemfunktion GetLastError() gesetzt, unabhängig davon, ob eine Ausnahme ausgelöst wird oder nicht.

Bemerkungen

Das Betriebssystem entfernt automatisch Leer- und Tabulatorzeichen am Anfang und Ende der abgerufenen Zeichenkette. Um das zu verhindern, umschließen Sie die Zeichenkette mit einfachen oder doppelten Anführungszeichen. Das äußerste Paar von einfachen oder doppelten Anführungszeichen wird ebenfalls entfernt, aber Leerzeichen innerhalb der Anführungszeichen bleiben erhalten.

Werte länger als 65535 Zeichen führen wahrscheinlich zu inkonsistenten Ergebnissen.

Eine typische INI-Datei sieht wie folgt aus:

[SektionName]
Schlüssel=Wert

Unicode: IniRead und IniWrite verwenden die externen Funktionen GetPrivateProfileString und WritePrivateProfileString, um Werte zu lesen oder zu schreiben. Diese Funktionen unterstützen Unicode nur in UTF-16-Dateien; alle anderen Dateien verwenden die Standard-ANSI-Codepage des Systems.

IniDelete, IniWrite, RegRead, dateilesende Schleife, FileRead

Beispiele

Liest den Wert eines Schlüssels in Sektion2 aus einer INI-Datei im Standardformat und speichert ihn in Wert.

Wert := IniRead("C:\Temp\MeineDatei.ini", "Sektion2", "Schlüssel")
MsgBox "Der Wert ist " Wert