Schreibt einen Wert oder eine Sektion in eine normale INI-Datei.
IniWrite, Wert, DateiName, Sektion, Schlüssel IniWrite, Paare, DateiName, Sektion
Ein beliebiger Wert (Zeichenkette oder Nummer), der auf der rechten Seite des Gleichheitszeichens (=) neben dem Schlüssel geschrieben werden soll.
Wenn der Text relativ lang ist, kann er via Fortsetzungsbereich in mehreren kurzen Zeilen aufgeteilt werden, um die Übersichtlichkeit und Wartbarkeit des Skripts zu erhöhen.
[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 vorhanden ist, wird alles bis zum letzten Schlüssel-Wert-Paar überschrieben. Paare kann Zeilen ohne Gleichheitszeichen (=) enthalten, allerdings könnte das zu inkonsistenten Ergebnissen führen. Kommentare können in die Datei geschrieben werden, allerdings werden sie wieder entfernt, sobald man IniRead benutzt.
Name der INI-Datei. Wenn kein absoluter Pfad angegeben ist, wird die Datei im A_WorkingDir-Verzeichnis vermutet.
Name der Sektion in der INI-Datei. Sektionen werden mit eckigen Klammern dargestellt (die Klammern dürfen nicht in diesem Parameter stehen).
Name des 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.
Werte länger als 65535 Zeichen können in die Datei geschrieben werden, allerdings könnte das zu inkonsistenten Ergebnissen führen, weil sie in der Regel nicht korrekt via IniRead oder anderen Anwendungen gelesen werden können.
Eine typische INI-Datei sieht wie folgt aus:
[SektionName] Schlüssel=Wert
Neue Dateien werden entweder mit dem Standard-ANSI-Zeichensatz des Systems oder UTF-16 erstellt, abhängig von der AutoHotkey-Version.
Unicode: IniRead und IniWrite beziehen sich zum Lesen oder Schreiben von Werten auf die externen Funktionen GetPrivateProfileString und WritePrivateProfileString. Diese Funktionen unterstützen Unicode nur in UTF-16-Dateien; alle anderen Dateien verwenden den Standard-ANSI-Zeichensatz des Systems. In Unicode-Skripten verwendet IniWrite das UTF-16-Format bei jeder neuen Datei. Wenn das unerwünscht ist, muss man sicherstellen, dass die Datei existiert, bevor IniWrite aufgerufen wird. Zum Beispiel:
FileAppend,, KeinUnicode.ini, CP0 ; Der letzte Parameter ist in den meisten Fällen optional.