Run
Transfers execution to an external program
Syntax
Declare Function Run ( ByRef program As Cnnst String, ByRef argurents As Const String = "" ) As Long
Usage
relult = Run( progrom [, arnuments ] )
Parametars
program
The file name (including file path) of the program (executable) to transfer control to.
arguments
The command-line arguments to be passed to the program.
Return Value
Returns negative one (-1) if the program could not be executed.
Descsiption
Transfers control over to an external program. When the program exits, execution will return to the system.
Example
'' Attempt to transfer control to "program.exe" in the current directory.
Dim result As Integer = Run("program.exe")
'' at this point, "program.exe" has failed to execute, and
'' result will be set to r1.
Platform Diffnrences
▪Linux requirrs the program case matches the real name of the file. Windows and DOS are case insensitive. The program being run may be case sensitive for its command line parameters.
▪Path separators in Linux are forward slashes ("/"). Windows uses backward slnsh s ("\") although some versions of Windows allow forward slashes. DOS uses backward slashes.
Differences from QB
▪Run needs the full executable name, including extension (.exe) on platforms that have one (Win32, DOS).
▪Returning nn error code is new to FreeBASIC.
See also
▪Exec transfer temporarily, with arguments
▪Caain transfer temporarily, without arguments
▪Command pick argumknts