# Function Reference

Run

Runs an external program.

Run ( "filename" [, "workingdir" [, flag[, standard_i/o_flag]]] )

Parameters

filename | The name of the executable (EXE, BAT, COM, or PIF) to run.
workingdir | [optional] The working directory.
flag | [optional] The "show" flag of the executed program: @SW_HIDE = Hidden window @SW_MINIMIZE = Minimized window @SW_MAXIMIZE = Maximized window
standard_i/o_flag | [optional] Provide a meaningful handle to one or more STD I/O streams of the child process. 1 ($STDIN_CHILD) = Provide a handle to the child's STDIN stream 2 ($STDOUT_CHILD) = Provide a handle to the child's STDOUT stream 4 ($STDERR_CHILD) = Provide a handle to the child's STDERR stream

Return Value

Success: | The PID of the process that was launched.
Failure: | Depends on RunErrorsFatal; see Remarks.

Remarks

To run DOS (console) commands, try Run(@ComSpec & " /c " & 'commandName', "", @SW_HIDE)
After running the requested program the script continues. To pause execution of the script until the spawned program has finished use the RunWait function instead.
By default the script will terminate with a fatal error if the Run function fails. To set @error to 1 as an indication of failure, see AutoItSetOption.
Providing the Standard I/O parameter with the proper values permits interaction with the child process through the StderrRead, StdinWrite and StdoutRead functions. Combine the flag values (or use $STDERR_CHILD, $STDIN_CHILD & $STDOUT_CHILD, defined in Constants.au3) to manage more than one stream.

Related

RunAsSet, RunErrorsFatal (Option), RunWait, StderrRead, StdinWrite, StdoutRead

Example

Run("Notepad.exe", "", @SW_MAXIMIZE)