Referenz - RUN

Referenz-Navigation

FreeBASIC-Referenz (anklicken z. Aufklappen)
- Über diese Referenz
- Alphabetische Befehlsreferenz
  - A
    - ABS
    - ABSTRACT
    - ACCESS
    - ACOS
    - ADD
    - ALIAS
    - ALLOCATE
    - ALPHA
    - AND (Methode)
    - AND (Operator)
    - ANDALSO
    - ANY
    - APPEND
    - AS
    - ASC
    - ASIN
    - ASM
    - ASSERT
    - ASSERT (Meta)
    - ASSERTWARN
    - ATAN2
    - ATN
    - THREADDETACH
  - B
    - BASE
    - BASE (Vererbung)
    - BEEP
    - BIN
    - BINARY
    - BIT
    - BITRESET
    - BITSET
    - BLOAD
    - BOOLEAN
    - BSAVE
    - BYREF
    - BYREF (Rückgaben)
    - BYTE
    - BYVAL (Klausel)
    - BYVAL (Rückgaben)
    - BYVAL (Schlüsselwort)
  - C
    - CALL
    - CALLOCATE
    - CASE
    - CAST
    - CBOOL
    - CBYTE
    - CDBL
    - CDECL
    - CHAIN
    - CHDIR
    - CHR
    - CINT
    - CIRCLE
    - CLASS
    - CLEAR
    - CLNG
    - CLNGINT
    - CLOSE
    - CLS
    - COLOR (Anweisung)
    - COLOR (Funktion)
    - COM
    - COMMAND
    - COMMON
    - CONDBROADCAST
    - CONDCREATE
    - CONDDESTROY
    - CONDSIGNAL
    - CONDWAIT
    - CONS
    - CONST
    - CONST (Klausel)
    - CONSTRUCTOR (Klassen)
    - CONSTRUCTOR (Module)
    - CONTINUE
    - COS
    - CPTR
    - CSHORT
    - CSIGN
    - CSNG
    - CSRLIN
    - CUBYTE
    - CUINT
    - CULNG
    - CULNGINT
    - CUNSG
    - CURDIR
    - CUSHORT
    - CUSTOM
    - CVA_ARG
    - CVA_COPY
    - CVA_END
    - CVA_START
    - CVD
    - CVI
    - CVL
    - CVLONGINT
    - CVS
    - CVSHORT
  - D
    - DATA
    - DATE
    - DATEADD
    - DATEDIFF
    - DATEPART
    - DATESERIAL
    - DATEVALUE
    - DAY
    - DEALLOCATE
    - DECLARE
    - DEFBYTE
    - DEFDBL
    - DEFINE (Meta)
    - DEFINED
    - DEFINT
    - DEFLNG
    - DEFLONGINT
    - DEFSHORT
    - DEFSNG
    - DEFSTR
    - DEFUBYTE
    - DEFUINT
    - DEFULONGINT
    - DEFUSHORT
    - DEFxxx
    - DELETE
    - DESTRUCTOR (Klassen)
    - DESTRUCTOR (Module)
    - DIM
    - DIR
    - DO ... LOOP
    - DOUBLE
    - DRAW (Grafik)
    - DRAW STRING
    - DYLIBFREE
    - DYLIBLOAD
    - DYLIBSYMBOL
    - DYNAMIC (Meta)
    - DYNAMIC (Schlüsselwort)
  - E
    - ELSE
    - ELSEIF
    - ENCODING
    - END
    - ENDIF
    - ENDMACRO (Meta)
    - ENUM
    - ENVIRON
    - EOF
    - EQV
    - ERASE
    - ERFN
    - ERL
    - ERMN
    - ERR (Anweisung)
    - ERR (Funktion)
    - ERROR (Anweisung)
    - ERROR (Meta)
    - ESCAPE
    - EXEC
    - EXEPATH
    - EXIT
    - EXP
    - EXPLICIT
    - EXPORT
    - EXTENDS
    - EXTERN (Module)
    - EXTERN ... END EXTERN
  - F
    - FALSE
    - FIELD
    - FILEATTR
    - FILECOPY
    - FILEDATETIME
    - FILEEXISTS
    - FILELEN
    - FIX
    - FLIP
    - FOR
    - FOR ... NEXT
    - FORMAT
    - FRAC
    - FRE
    - FREEFILE
    - FUNCTION
  - G
    - GET (Datei)
    - GET (Grafik)
    - GETJOYSTICK
    - GETKEY
    - GETMOUSE
    - GOSUB
    - GOSUB (Schlüsselwort)
    - GOTO
  - H
    - HEX
    - HIBYTE
    - HIWORD
    - HOUR
  - I
    - IF (Meta)
    - IF ... THEN
    - IFDEF (Meta)
    - IFNDEF (Meta)
    - IIF
    - IMAGECONVERTROW
    - IMAGECREATE
    - IMAGEDESTROY
    - IMAGEINFO
    - IMP
    - IMPLEMENTS
    - IMPORT
    - INCLIB (Meta)
    - INCLUDE (Meta)
    - INKEY
    - INP
    - INPUT (Anweisung)
    - INPUT (Datei)
    - INPUT (Dateimodus)
    - INPUT (Funktion)
    - INSTR
    - INSTRREV
    - INT
    - INTEGER
    - IS
    - IS (Vererbung)
    - ISDATE
    - ISREDIRECTED
  - K
    - KILL
  - L
    - LANG (Meta)
    - LBOUND
    - LCASE
    - LEFT
    - LEN
    - LET
    - LIB
    - LIBPATH (Meta)
    - LINE (Grafik)
    - LINE (Meta)
    - LINE INPUT
    - LINE INPUT (Datei)
    - LOBYTE
    - LOC
    - LOCAL
    - LOCATE (Anweisung)
    - LOCATE (Funktion)
    - LOCK
    - LOF
    - LOG
    - LONG
    - LONGINT
    - LOOP
    - LOWORD
    - LPOS
    - LPRINT (Anweisung)
    - LPRINT USING
    - LPT
    - LSET
    - LTRIM
  - M
    - MACRO (Meta)
    - MID (Anweisung)
    - MID (Funktion)
    - MINUTE
    - MKD
    - MKDIR
    - MKI
    - MKL
    - MKLONGINT
    - MKS
    - MKSHORT
    - MOD
    - MONTH
    - MONTHNAME
    - MULTIKEY
    - MUTEXCREATE
    - MUTEXDESTROY
    - MUTEXLOCK
    - MUTEXUNLOCK
  - N
    - NAKED
    - NAME
    - NAMESPACE
    - NEW
    - NEXT
    - NOGOSUB (Schlüsselwort)
    - NOKEYWORD
    - NOT
    - NOW
  - O
    - OBJECT
    - OCT
    - OFFSETOF
    - ON ... GOSUB
    - ON ... GOTO
    - ON ERROR
    - ONCE
    - OPEN (Anweisung)
    - OPEN (Funktion)
    - OPEN COM
    - OPEN CONS
    - OPEN ERR
    - OPEN LPT
    - OPEN PIPE
    - OPEN SCRN
    - OPERATOR
    - OPTION
    - Option()
    - OR (Methode)
    - OR (Operator)
    - ORELSE
    - OUT
    - OUTPUT
    - OVERLOAD
    - OVERRIDE
  - P
    - PAINT
    - PALETTE
    - PALETTE GET
    - PASCAL
    - PCOPY
    - PEEK
    - PIPE
    - PMAP
    - POINT
    - POINTCOORD
    - POINTER
    - POKE
    - POS
    - PRAGMA (Meta)
    - PRESERVE
    - PRESET (Grafik)
    - PRESET (Methode)
    - PRINT (Anweisung)
    - PRINT (Datei)
    - PRINT (Meta)
    - PRINT USING
    - PRIVATE (Klausel)
    - PRIVATE (Schlüsselwort)
    - PRIVATE (UDT)
    - PROCPTR
    - PROPERTY
    - PROTECTED
    - PSET (Grafik)
    - PSET (Methode)
    - PTR
    - PUBLIC (Klausel)
    - PUBLIC (UDT)
    - PUT (Datei)
    - PUT (Grafik)
  - R
    - RANDOM
    - RANDOMIZE
    - READ
    - REALLOCATE
    - REDIM
    - REM
    - RESET
    - RESTORE
    - RESUME
    - RETURN
    - RGB
    - RGBA
    - RIGHT
    - RMDIR
    - RND
    - RSET
    - RTRIM
    - RUN
  - S
    - SADD
    - SCOPE
    - SCREEN (Anweisung)
    - SCREEN (Funktion)
    - SCREENCONTROL
    - SCREENCOPY
    - SCREENEVENT
    - SCREENGLPROC
    - SCREENINFO
    - SCREENLIST
    - SCREENLOCK
    - SCREENPTR
    - SCREENRES
    - SCREENSET
    - SCREENSYNC
    - SCREENUNLOCK
    - SCRN
    - SECOND
    - SEEK (Anweisung)
    - SEEK (Funktion)
    - SELECT CASE
    - SETDATE
    - SETENVIRON
    - SETMOUSE
    - SETTIME
    - SGN
    - SHARED
    - SHELL
    - SHL
    - SHORT
    - SHR
    - SIN
    - SINGLE
    - SIZEOF
    - SLEEP
    - SPACE
    - SPC
    - SQR
    - STATIC (Anweisung)
    - STATIC (Klausel)
    - STATIC (Meta)
    - STATIC (Schlüsselwort)
    - STATIC (UDT)
    - STDCALL
    - STEP
    - STICK
    - STOP
    - STR
    - STRIG
    - STRING (Datentyp)
    - STRING (Funktion)
    - STRPTR
    - SUB
    - SWAP
    - SYSTEM
  - T
    - TAB
    - TAN
    - THEN
    - THIS
    - THREADCALL
    - THREADCREATE
    - THREADDETACH
    - THREADWAIT
    - TIME
    - TIMER
    - TIMESERIAL
    - TIMEVALUE
    - TO
    - TRANS
    - TRIM
    - TRUE
    - TYPE (Forward Referencing)
    - TYPE (Funktion)
    - TYPE (UDT)
    - TYPEOF
  - U
    - UBOUND
    - UBYTE
    - UCASE
    - UINTEGER
    - ULONG
    - ULONGINT
    - UNDEF (Metabefehl)
    - UNION
    - UNLOCK
    - UNSIGNED
    - UNTIL
    - USHORT
    - USING (Namespace)
  - V
    - VAL
    - VAL64
    - VALINT
    - VALLNG
    - VALUINT
    - VALULNG
    - VAR
    - VARPTR
    - VA_ARG
    - VA_FIRST
    - VA_NEXT
    - VIEW (Grafik)
    - VIEW (Text)
    - VIRTUAL
  - W
    - WAIT
    - WBIN
    - WCHR
    - WEEKDAY
    - WEEKDAYNAME
    - WEND
    - WHEX
    - WHILE
    - WHILE ... WEND
    - WIDTH (Anweisung)
    - WIDTH (Funktion)
    - WINDOW
    - WINDOWTITLE
    - WINPUT
    - WITH
    - WOCT
    - WRITE (Anweisung)
    - WRITE (Datei)
    - WSPACE
    - WSTR
    - WSTRING (Datentyp)
    - WSTRING (Funktion)
  - X
    - XOR (Methode)
    - XOR (Operator)
  - Y
    - YEAR
  - Z
    - ZSTRING
  - Metabefehle
    - __DATE_ISO__
    - __DATE__
    - __FB_64BIT__
    - __FB_ARGC__
    - __FB_ARGV__
    - __FB_BACKEND__
    - __FB_BIGENDIAN__
    - __FB_BUILD_DATE__
    - __FB_CYGWIN__
    - __FB_DARWIN__
    - __FB_DEBUG__
    - __FB_DOS__
    - __FB_ERR__
    - __FB_FPMODE__
    - __FB_FPU__
    - __FB_FREEBSD__
    - __FB_GCC__
    - __FB_LANG__
    - __FB_LINUX__
    - __FB_MAIN__
    - __FB_MIN_VERSION__
    - __FB_MT__
    - __FB_NETBSD__
    - __FB_OPENBSD__
    - __FB_OPTION_BYVAL__
    - __FB_OPTION_DYNAMIC__
    - __FB_OPTION_ESCAPE__
    - __FB_OPTION_EXPLICIT__
    - __FB_OPTION_GOSUB__
    - __FB_OPTION_PRIVATE__
    - __FB_OUT_DLL__
    - __FB_OUT_EXE__
    - __FB_OUT_LIB__
    - __FB_OUT_OBJ__
    - __FB_PCOS__
    - __FB_SIGNATURE__
    - __FB_SSE__
    - __FB_UNIX__
    - __FB_VECTORIZE__
    - __FB_VERSION__
    - __FB_VER_MAJOR__
    - __FB_VER_MINOR__
    - __FB_VER_PATCH__
    - __FB_WIN32__
    - __FB_XBOX__
    - __FILE_NQ__
    - __FILE__
    - __FUNCTION_NQ__
    - __FUNCTION__
    - __LINE__
    - __PATH__
    - __TIME__
- BASIC-Grundlagen
- Operatoren in FreeBASIC
- Prozeduren in FreeBASIC
- Die Gfxlib
- Verschiedene Themen
- FreeBASIC thematische Übersicht
Alle Ordner öffnen
Alle Ordner schließen

Syntax: RUN (Datei [, Argumente])
Typ: Funktion
Kategorie: System

RUN startet eine ausführbare Datei. Wenn die Datei ordnungsgemäß ausgeführt werden konnte, wird die Kontrolle anschließend an das Betriebssystem zurückgegeben.

'Datei' ist ein STRING, der den vollen Dateinamen (inklusive Erweiterung) der auszuführenden Datei enthält.
'Argumente' ist ein STRING, der die Argumente enthält, die an das Programm übergeben werden sollen.
Wenn ein Fehler aufgetreten ist, z. B. wenn die aufzurufende Datei nicht existiert, wird -1 zurückgegeben.

RUN transferiert die Kontrolle auf das aufgerufene Programm. Nachdem das aufgerufene Programm beendet wurde, erhält das aufrufende Programm die Kontrolle nicht mehr zurück. Sie wird ans Betriebssystem zurückgegeben. Das bedeutet, dass als Rückgabewert von RUN immer -1 aufgefangen wird, da bei erfolgreichem Aufruf kein Rückgabewert mehr ausgewertet werden kann.

Beispiel:
Wenn die Datei "file.exe" im aktuellen Arbeitsverzeichnis existiert, wird sie durch diesen Code aufgerufen:

IF RUN "file.exe" = -1 THEN

  PRINT """file.exe"" existiert scheinbar doch nicht."

ELSE

    PRINT "Es ist egal was hier passiert, es wird nie ausgefuehrt."

END IF



SLEEP 'Wird nur ausgefuehrt, wenn der RUN-Aufruf -1 zurueckgibt.

Da das Programm automatisch beendet wird, wenn "file.exe" erfolgreich ausgeführt werden konnte, muss nicht geprüft werden, ob der Rückgabewert -1 war.

Unterschiede zu QB:

In FreeBASIC muss der volle Dateiname inklusive Erweiterung (.exe unter Win32 und DOS) angegeben werden.
RUN kann in FreeBASIC auch als Funktion eingesetzt werden.

Plattformbedingte Unterschiede:

Unter Linux muss der Dateiname 'case sensitive' erfolgen. Windows und DOS sind 'case insensitive'.
Das Trennzeichen für den Dateipfad ist unter Linux der vorwärtsgerichtete Slash /. Windows verwendet den Backslash \, erlaubt aber auch den Slash. DOS verwendet den Backslash.

Siehe auch:
CHAIN, EXEC, SHELL, END, COMMAND, Betriebssystem-Anweisungen

Zusätzliche Informationen und Funktionen

Der Referenzeintrag wurde am 05.08.2007 von Mao angelegt.
Die aktuellste Version wurde am 27.12.2012 von nemored gespeichert.

Versionen

Um die Aufklappnavigation links benutzen zu können, müssen Sie JavaScript aktivieren. Ohne JavaScript können Sie die Referenzeinträge nur über die Liste aller Einträge erreichen.