Referenz - SHELL

Referenz-Navigation

FreeBASIC-Referenz (anklicken z. Aufklappen)
- Über diese Referenz
- Alphabetische Befehlsreferenz
  - A
    - ABS
    - ACCESS
    - ACOS
    - ADD
    - ALIAS
    - ALLOCATE
    - ALPHA
    - AND (Methode)
    - AND (Operator)
    - ANDALSO
    - ANY
    - APPEND
    - AS
    - ASC
    - ASIN
    - ASM
    - ASSERT
    - ASSERTWARN
    - ATAN2
    - ATN
  - B
    - BASE
    - BASE (Vererbung)
    - BEEP
    - BIN
    - BINARY
    - BIT
    - BITRESET
    - BITSET
    - BLOAD
    - BSAVE
    - BYREF
    - BYTE
    - BYVAL (Klausel)
    - BYVAL (Schlüsselwort)
  - C
    - CALL
    - CALLOCATE
    - CASE
    - CAST
    - 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
    - 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
    - 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
  - 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
  - P
    - PAINT
    - PALETTE
    - PALETTE GET
    - PASCAL
    - PCOPY
    - PEEK
    - PIPE
    - PMAP
    - POINT
    - 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
    - THREADWAIT
    - TIME
    - TIMER
    - TIMESERIAL
    - TIMEVALUE
    - TO
    - TRANS
    - TRIM
    - 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)
  - 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_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_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 Order öffnen
Alle Order schließen

Syntax: SHELL [Kommando AS STRING]
Typ: Funktion
Kategorie: Verschiedenes

SHELL führt ein Systemkommando aus und gibt die Kontrolle an das aufrufende Programm zurück, sobald das aufgerufene Kommando abgearbeitet wurde.

'Kommando' ist eine Befehlszeile, die an die Konsole übergeben wird. Dies kann der Name eines Programms inklusive Parametern oder ein Systemkommando sein.
Der Rückgabewert ist 0, wenn der Aufruf erfolgreich war, oder -1, wenn ein Fehler aufgetreten ist. Ein Fehler kann z.B. sein, dass die angegebene Datei oder der Befehl nicht existiert.

Beispiel (Windows):

SHELL "DIR C:\*.*"

Beispiel (Linux):

SHELL "ls -alh"

Soll das aufgerufene Programm parallel zum FB-Programm laufen, kann unter Win32 "Start" gestartet werden:

SHELL "START notepad"

Beispiel zum Aufruf als Funktion:

DIM AS INTEGER Result

Result = SHELL ("NOTEPAD.EXE")

Print "Rueckgabe war " & Result & "."

Sleep

Unterschiede
zu QB:

SHELL kann auch als Funktion eingesetzt werden.
Ohne Parameter wird keine CMD-Sitzung gestartet.

Bug in der Linux-Version (bis einschließlich V. 0.20.0):
Ab dem 1020. Aufruf des SHELL-Befehls innerhalb eines Programms (etwa durch eine Schleife) funktioniert SHELL nicht mehr, d.h. das übergebene Kommando wird nicht ausgeführt. Stattdessen wird die Fehlermeldung

sh: pipe error: Zu viele offene Dateien

ausgegeben. Der Fehler ist im Bugtracker dokumentiert (siehe auch Bugreport im Forum) und wurde am 08.04.2010 in der SVN-Version behoben. Die aktuelle Stable-Version (0.20.0) enthält den Bug noch. Nutzer dieser Version können einen Workaround wie den folgenden verwenden, wenn sie nicht auf eine SVN-Version updaten möchten: Ersatzfunktion für Shell in der NoPaste-Codeablage

Siehe auch:
RUN, EXEC, CHAIN, END, COMMAND, CONSTRUCTOR, DESTRUCTOR

Zusätzliche Informationen und Funktionen

Der Referenzeintrag wurde am 03.08.2007 von nemored angelegt.
Die aktuellste Version wurde am 09.04.2010 von Sebastian 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.