Liest einen Wert aus einer Standard-INI-Datei.
IniRead, Var, Filename, Section, Key [, Default]
| Var | Der Name der Variable, in die der gelesene Wert gespeichert wird. Wenn der Wert nicht gelesen werden kann, wird die Variable auf den im Default-Parameter stehenden Wert gesetzt, siehe unten. |
| Filename | Name der INI-Datei. Falls kein absoluter Pfad angegeben ist, wird als solcher der in %A_WorkingDir% verwendet. |
| Section | Der Name der Sektion innerhalb der INI-Datei; dies ist der Text in den eckigen Klammern (dieser Parameter darf selber keine eckigen Klammern enthalten). |
| Key | Der Name des Keys (Schlüssel) in der INI-Datei. |
| Default | Dieser Wert wird in Var gespeichert, wenn der angeforderte Key nicht gefunden wurde. Wenn er nicht angegeben wird, ist das voreingestellte Wort: ERROR. Um einen leeren String zu speichern, geben Sie %A_Space% an. Für AutoIt-Scripts (.aut) wird dieser Parameter aus Kompatibilitätsgründen nicht unterstützt; in Var wird grundsätzlich der String ERROR gespeichert, wenn der Wert nicht gelesen werden konnte. |
ErrorLevel wird bei diesem Befehl nicht gesetzt. Bei einem Problem wird Var auf Default gesetzt, wie oben beschrieben.
Die Betriebssystem verwirft automatisch führende and anhängenden Leerzeichen/Tabulatoren vom gelesenen String.
Eine Standard-INI-Datei sieht so aus:
[SectionName]
Key=Value
IniDelete, IniWrite, RegRead, Datei-Loop, FileRead
IniRead, Var, C:\Temp\MeineDatei.ini, Sektion2, Key MsgBox, Der Wert ist %Var%.