Referenz - INCLUDE (Meta)

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 A: #INCLUDE [ONCE] "Datei"
Syntax B: '$INCLUDE [ONCE]: 'Datei'
Typ: Metabefehl
Kategorie: Metabefehle

#INCLUDE bindet Programmcode aus einer anderen Quellcodedatei ein. Dies hat zur Folge, dass der eingebundene Code beim Compilieren so behandelt wird, als stünde er an der Stelle, an der sich im echten Code #INCLUDE befindet. Dadurch lässt sich ein Programm in mehrere Teile zerlegen, wodurch es übersichtlicher wird.

'Datei' ist der Dateiname des einzubindenden Codes, eventuell mit Pfadangabe. Wenn kein Pfad angegeben wird, sucht FreeBASIC zuerst im aktuellen Arbeitsverzeichnis, dann im Verzeichnis, in dem sich der Quellcode befindet, und schließlich in den System-Include-Verzeichnissen nach der einzubindenden Datei.
Sowohl Slashes (/) als auch Backslashes (\) werden als Pfad-Trennzeichen akzeptiert.
'ONCE' verhindert, dass Daten doppelt eingebunden werden. Dies kann geschehen, wenn eingebundene Dateien ebenfalls INCLUDE-Befehle enthalten.

Beispiel:

#INCLUDE ONCE "vbcompat.bi"

Im Gegensatz zu QB können in per #INCLUDE eingebundene Daten auch 'ausführbare' Befehle enthalten sein.

Es hat sich durchgesetzt, Deklarationsdateien (Dateien, die lediglich COMMON/DIM [SHARED]-, DECLARE-, oder TYPE-Anweisungen enthalten) mit der Erweiterung BI zu kennzeichnen. BIs werden oft eingesetzt, um die Prozeduren einer LIB/DLL zu deklarieren.

Das maximale Rekursionslevel liegt bei 16, d. h. dass bei einem Code, der einen weiteren einbindet, der einen weiteren einbindet etc. nach 16 Dateien die Grenze erreicht ist, bei dem der Compiler aufhört zu suchen. Eine solch tiefe Verschachtelung ist allerdings unüblich.

Achtung:
Seit FreeBASIC v0.14 werden ESCAPE-Chars in #INCLUDE-Anweisungen nicht mehr interpretiert.

Unterschiede zu QB:

Wenn der Pfadname einen Unterstrich enthält, müssen doppelte Anführungsstriche statt einfacher verwendet werden.
Es können auch 'echte' BAS-Files eingebunden werden, die auch 'ausführbare' Anweisungen enthalten.
Das Schlüsselwort 'ONCE' steht zur Verfügung.

Unterschiede zu früheren Versionen von FreeBASIC:

Die Variante '$INCLUDE ist seit FreeBASIC v0.17 nicht mehr zulässig.
Escape-Chars werden seit FreeBASIC v0.14 in INCLUDE-Anweisungen nicht mehr interpretiert.

Siehe auch:
INCLIB, Präprozessor-Anweisungen

Zusätzliche Informationen und Funktionen

Der Referenzeintrag wurde am 30.07.2007 von nemored angelegt.
Die aktuellste Version wurde am 19.01.2013 von MOD 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.