Liest einen Wert, eine Sektion oder eine Liste von Sektionsnamen aus einer INI-Datei im Standardformat.
IniRead, AusgabeVar, DateiName, Sektion, Schlüssel , Standardwert IniRead, AusgabeVarSektion, DateiName, Sektion IniRead, AusgabeVarSektionNamen, DateiName
Name der Ausgabevariable, in der der abgerufene Wert gespeichert werden soll. Wenn der Wert nicht abgerufen werden kann, wird die Variable auf den Standardwert gesetzt (siehe unten).
[AHK_L 57+]: Lassen Sie den Schlüssel-Parameter weg, um die gesamte Sektion zu lesen. Kommentare und Leerzeilen werden weggelassen. Es werden nur die ersten 65533 Zeichen der Sektion abgerufen.
[AHK_L 57+]: Lassen Sie den Schlüssel- und Sektion-Parameter weg, um eine Liste von Sektionsnamen abzurufen, die alle mit einem Zeilenvorschub (`n) voneinander getrennt sind.
Name der INI-Datei. Wenn kein absoluter Pfad angegeben ist, wird die Datei im A_WorkingDir-Verzeichnis vermutet.
Name einer Sektion in der INI-Datei, erkennbar an den eckigen Klammern (die Klammern müssen in diesem Parameter weggelassen werden).
Name eines Schlüssels in der INI-Datei.
Wenn leer oder weggelassen, wird standardmäßig das Wort ERROR verwendet. Andernfalls geben Sie den Wert an, der in AusgabeVar gespeichert werden soll, wenn der gesuchte Schlüssel nicht gefunden wird. Um einen leeren Wert (leere Zeichenkette) als Standardwert zu definieren, geben Sie %A_Space% an.
[AHK_L 57+]: Dieser Parameter ist wirkungslos, wenn der Schlüssel-Parameter weggelassen wird.
ErrorLevel wird nicht durch diesen Befehl geändert. Wenn ein Problem aufgetreten ist, wird AusgabeVar auf den Standardwert gesetzt, wie oben beschrieben.
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