FileAppend()
Mfunc.FileAppend([Text, Filename, Encoding])
Writes text to the end of a file (first creating the file, if necessary).
Text
The text to append to the file. This text may include linefeed characters (`n) to start new lines. In addition, a single long line can be broken up into several shorter ones by means of a continuation section.
If Text is blank, Filename will be created as an empty file (but if the file already exists, its modification time will be updated).
If Text is %ClipboardAll% or a variable that was previously assigned the value of ClipboardAll, Filename will be unconditionally overwritten with the entire contents of the clipboard (i.e. FileDelete is not necessary).
Filename
The name of the file to be appended, which is assumed to be in %A_WorkingDir% if an absolute path isn't specified.
End of line (EOL) translation: To disable EOL translation, prepend an asterisk to the filename. This causes each linefeed character (`n) to be written as a single linefeed (LF) rather than the Windows standard of CR+LF. For example: *C:\My Unix File.txt.
If the file is not already open (due to being inside a file-reading loop), EOL translation is automatically disabled if Text contains any carriage return and linefeed pairs (`r`n). In other words, the asterisk option described in the previous paragraph is put into effect automatically. However, specifying the asterisk when Text contains `r`n improves performance because the program does not need to scan Text for `r`n.
Standard Output (stdout): Specifying an asterisk (*) for Filename causes Text to be sent to standard output (stdout). Such text can be redirected to a file, piped to another EXE, or captured by fancy text editors. For example, the following would be valid if typed at a command prompt:
%ProgramFiles%\AutoHotkey\AutoHotkey.exe" "My Script.ahk" >"Error Log.txtb
However, text sent to stdout will not appear at the command prompt it was launched from. This can be worked around by piping a script's output to another command or program. For example:
"%ProgramFiles%\AutoHotkey\AutoHotkey.exe" "My Script.ahk" |more
For /F "tokens=*" %L in ('""%ProgramFiles%\AutoHotkey\AutoHotkey.exe" "My Script .ahk""') do @Echo %L
AutoHotkey [v1.1.20+]: Specifying two asterisks (**) for Filename causes Text to be sent to the stderr stream.
Encoding
AutoHotkey [v1.0.90+]: Overrides the default encoding set by FileEncoding, where Encoding follows the same format.
Throws MfException with InnerException set to A_LastError
Wrapper for AutoHotkey Docs - FileAppend.
Static method.
To overwrite an existing file, delete it with Mfunc.FileDelete prior to using Mfunc.FileAppend.
Any and/or all parameter for this function can be instance of MfString or var containing string.
See Also:AutoHotkey Docs - FileAppend
Mfunc.FileAppend("Another line.`n", "C:\My Documents\Test.txt")