Many functions contain optional parameters that can be omitted. If you
wish to specify an optional parameter, however, all parameters that precede
it must be specified!
For example, consider Run ( "filename", ["workingdir"
[, flag]] ). If you wish to specify the flag, you must
specify a workingdir.
Many Win___ functions contain an optional parameter "text." This parameter
is intended to help differentiate between windows that have identical titles.
Some functions indicate success/failure as a return value; others indicate
it by setting the @error flag. Some do both....
@error = 0 ;is always success
Return = varies, but is typically non-zero for success to allow easy to read
code...
If someUserFunc() then ;...function worked
If Not someUserFunc() then ;...function failed
$x = FileReadLine("C:\someFile.txt")
If @error = -1 Then ;end-of-file was reached
If a function can set the @error flag, you should always check it before
using a return value - if @error indicates an error then the function return
value is generally undefined...