Schreibt einen Wert oder eine Sektion in eine INI-Datei im Standardformat.
IniWrite, Wert, DateiName, Sektion, Schlüssel IniWrite, Paare, DateiName, Sektion
Eine Zeichenkette oder Zahl, die rechts neben das Gleichheitszeichen (=) von Schlüssel geschrieben werden soll.
Wenn der Text relativ lang ist, kann er via Fortsetzungsbereich in mehrere kurze Zeilen aufgeteilt werden, um die Übersichtlichkeit und Wartbarkeit des Skripts zu verbessern.
[AHK_L 57+]: Der komplette Inhalt einer Sektion, die in die INI-Datei geschrieben werden soll, ohne [SektionName]-Überschrift. Schlüssel muss weggelassen werden. Paare darf keine Leerzeilen enthalten. Wenn die Sektion bereits existiert, wird alles bis zum letzten Schlüssel-Wert-Paar überschrieben. Paare kann Zeilen ohne Gleichheitszeichen (=) enthalten, was aber zu inkonsistenten Ergebnissen führen kann. Es können Kommentare in die Datei geschrieben werden, diese werden jedoch entfernt, sobald IniRead verwendet wird.
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.
[v1.1.04+]: Dieser Befehl ist in der Lage, bei Misserfolg eine Ausnahme auszulösen. Weitere Informationen finden Sie unter Laufzeitfehler.
ErrorLevel wird bei Misserfolg auf 1 und bei Erfolg auf 0 gesetzt.
Es können Werte länger als 65535 Zeichen in die Datei geschrieben werden, allerdings kann das zu inkonsistenten Ergebnissen führen, da sie in der Regel von IniRead oder anderen Anwendungen nicht korrekt gelesen werden können.
Eine typische INI-Datei sieht wie folgt aus:
[SektionName] Schlüssel=Wert
Neue Dateien werden entweder in der Standard-ANSI-Codepage des Systems oder im UTF-16-Format erstellt, abhängig von der AutoHotkey-Version.
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. In Unicode-Skripten verwendet IniWrite für jede neue Datei das UTF-16-Format. Wenn das nicht erwünscht ist, müssen Sie sicherstellen, dass die Datei existiert, bevor Sie IniWrite aufrufen. Zum Beispiel:
FileAppend,, KeinUnicode.ini, CP0 ; Der letzte Parameter ist in den meisten Fällen optional.