consolewrite() documentation addendum

[flyingboz]

Assuming the behavior is desired, and not leveraging a bug...
If there are any other cool behaviors possible (moving the cursor up a line, writing from right to left, etc.), it would be nice if they were documented somewhere as well.

Suggest adding this line (or similar) after "...unless the script is compiled as a console application...:

In a compiled console application, prepending @CR to "data" will reset the cursor location to the beginning of the current line.

Sample code demonstrating functionality (by ResNullis)
#Region ; Directives created by AutoIt3Wrapper_GUI
#AutoIt3Wrapper_Change2CUI=y
#EndRegion ; Directives created by AutoIt3Wrapper_GUI
$ClearProgress = 0

$progress = "ùùùùùùùùùù";Chr(249)
$processing = "Processing ["

For $i = 1 To 3

For $iPos = 1 To 10

$DisplayProgress = StringReplace($progress, $iPos, " ", 1)
ConsoleWrite(@CR & $processing & $DisplayProgress & "]")
Sleep(50)

Next
For $iPos = 10 To 1 Step -1

$DisplayProgress = StringReplace($progress, $iPos, " ", 1)
ConsoleWrite(@CR & $processing & $DisplayProgress & "]")
Sleep(50)

Next

Next

$DisplayProgress = $progress

ConsoleWrite(@CR & $processing & $DisplayProgress & "]")
ConsoleWrite(@CRLF & "DONE")

[TicketCleanup]

Automatic ticket cleanup.

[Valik]

This doesn't appear to be a bug (I can reproduce it with a simple C++ program). However, it is not an AutoIt feature, either. It seems to be a feature/bug/quirk in the command interpreter. I don't feel that we should be documenting the functionality of other programs.