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)
Typ: Zeichenkette
Name der INI-Datei. Wenn kein absoluter Pfad angegeben ist, wird die Datei im A_WorkingDir-Verzeichnis vermutet.
Typ: Zeichenkette
Name einer Sektion in der INI-Datei, erkennbar an den eckigen Klammern (die Klammern müssen in diesem Parameter weggelassen werden).
Typ: Zeichenkette
Name eines Schlüssels in der INI-Datei.
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.
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 der Schlüssel- und Sektion-Parameter weggelassen werden, gibt diese Funktion eine Liste von Sektionsnamen zurück, die alle mit einem LF-Zeichen (`n) voneinander getrennt sind.
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.
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