_FileWriteLog

[RedZone]

$iFlag value does not work when $sLogPath = a file handle returned from FileOpen().

It appears that FileOpen()$mode=1$FO_APPEND (1) = Write mode (append to end of file) overrides _FileWriteLog $iFlag value.

In reference to this ​post

_FileWriteLog help file ​link
FileOpen help file ​link

Example:

#include <File.au3>
$hTest = fileopen("C:\temp\test.log", 1)
$sTestPath = "C:\temp\test.log"
;Test with handle
_FileWriteLog($hTest, "First Message")
_FileWriteLog($hTest, "Message at the End", -1)
_FileWriteLog($hTest, "Message at the Top", 1)
ShellExecute($sTestPath)
FileClose($hTest)

Result:
2020-06-07 10:54:16 : First Message
2020-06-07 10:54:16 : Message at the End
2020-06-07 10:54:16 : Message at the Top

#include <File.au3>
$hTest = fileopen("C:\temp\test.log", 1)
$sTestPath = "C:\temp\test.log"
;Test with handle
_FileWriteLog($sTestPath, "First Message")
_FileWriteLog($sTestPath, "Message at the End", -1)
_FileWriteLog($sTestPath, "Message at the Top", 1)
ShellExecute($sTestPath)
FileClose($hTest)

Result:
2020-06-07 10:55:58 : Message at the Top
2020-06-07 10:55:58 : First Message
2020-06-07 10:55:58 : Message at the End

[Jpm]

As when using Handle it will be needed to override the opening mode,
I prefer to change the doc to explain that with handle the $iFlag is ignored and so only apending will occurs

[Jpm]

Fixed by revision [12351] in version: 3.3.15.4