#include [once] "file"

#include вставляет исходный код из другого файла в точке где указана директива #include. Это приводит к компиляции исходного кода из файла включения, как будто он является частью исходного файла, который включает его. После того, как компилятор достиг конца включаемого файла, продолжается компиляция исходного файла.

Это полезно, чтобы удалить код из файла и разделить его на несколько файлов. Полезно иметь один файл с декларациями в программе, имеющей несколько модулей. Вы можете включить файлы в включаемом файле, и это поможет избежать включение исходного файла самого в себе. Как правило, включаемые файлы имеют расширение .bi и в основном используются для декларации процедур/функций/переменных в библиотеке, однако любой действительный исходный код может присутствовать во включаемом файле.

Спецификатор once сообщает компилятору о том, что данный включаемый файл нужно включить только один раз, даже если он включен несколько раз по исходному коду.

$Include является альтернативной формой include, существующая только для совместимости с QuickBASIC. Рекомендуется использовать #include.

Компилятор автоматически преобразует символы разделителей пути ( '/' и '\' ) по мере необходимости, чтобы должным образом загрузить файл. Название файла может иметь абсолютный или относительный путь.

Для относительных путей, или где путь не дается вообще, поиск включаемого файла осуществляется в следующем порядке:

• Относительно каталога исходного файла
  
• Относительно текущего рабочего каталога
  
• Относительно добавленного каталога, указанного в командной строке с опцией -i
  
• Включаемый каталог, где FreeBASIC установлен (FreeBASIC\inc, где FreeBASIC  - это папка, где расположен файл fbc )
  
  

' файл header.bi
Type FooType
    Bar As Byte
    Barbeque As Byte 
End Type

' файл main.bas
#include "header.bi"

Dim Foo As FooType

Foo.Bar = 1
Foo.Barbeque = 2

• Новое в FreeBASIC
  
  

• #define
  
• #inclib
  
• Опция компилятора: -i