Using Prebuilt Libraries
FreeBASIC is distributed with many headers for common or popular libraries. The headers allow a programmer to use functions available in these existing static or shared libraries (DLLs).
The libraries themselves are not distributed with FreeBASIC, but most can be downloaded from the web and readily installed. Some other libraries may need to be first compiled from sources to be used. Please see the documentation for the specific library on how to configure, install, and use them.
Some static or shared libraries (DLLs) may be already present on the system since they might be part of FreeBASIC itself or the operating system.
Although many headers can be used on any of the platforms supported by FreeBASIC, some headers are platform specific and will not be usable on other platforms.
There are a few headers that are specific to FreeBASIC and expose some functions that are otherwise not available:
Where possible cross-platform compatible headers have been provided for the C runtime (CRT). For example,
To include a specific CRT header, prefix the name of the header file with "crt/". For example:
Many (many) headers for the Windows API are available for inclusion in FreeBASIC source code. In most cases the only include file needed is "windows.bi". For example,
To include a specific Windows API header, prefix the name of the header with "win/" for example:
Browse the "./inc/win/" directory where FreeBASIC was installed to see all of the available Windows API headers.
Browse the "./inc/" directory located where FreeBASIC was installed to find other headers. It is possible that headers might be available for a library you need to use. Some headers are located in "./inc/" and others might be located in a sub-directory. To include headers located in a subdirectory of "./inc/", prefix the name of the header with the name of the directory where it is located. For example:
The libraries themselves are not distributed with FreeBASIC, but most can be downloaded from the web and readily installed. Some other libraries may need to be first compiled from sources to be used. Please see the documentation for the specific library on how to configure, install, and use them.
Some static or shared libraries (DLLs) may be already present on the system since they might be part of FreeBASIC itself or the operating system.
Although many headers can be used on any of the platforms supported by FreeBASIC, some headers are platform specific and will not be usable on other platforms.
FreeBASIC headers
There are a few headers that are specific to FreeBASIC and expose some functions that are otherwise not available:
- datetime.bi - Declarations for DateSerial, DateValue, IsDate, Year, Month, Day, Weekday, TimeSerial, TimeValue, Hour, Minute, Second, Now, DateAdd, DatePart, DateDiff, MonthName, WeekdayName
- dir.bi - Constants to be used with Dir
- fbgfx.bi - Additional constants and structures to be used with graphics commands such as MultiKey, ScreenControl, and ScreenEvent, ImageCreate.
- file.bi - Declarations for FileCopy, FileAttr, FileLen, FileExists, FileDateTime
- string.bi - Declarations for Format
- vbcompat.bi - Includes datetime.bi, dir.bi, file.bi, and string.bi plus additional constants compatible with Microsoft Visual Basic.
C Runtime (CRT)
Where possible cross-platform compatible headers have been provided for the C runtime (CRT). For example,
#include once "crt.bi"
printf( !"Hello World\n" )
printf( !"Hello World\n" )
To include a specific CRT header, prefix the name of the header file with "crt/". For example:
#include once "crt/stdio.bi"
Dim f As FILE Ptr
f = fopen("somefile.txt", "w")
fprintf( f, "Hello File\n")
fclose( f )
Dim f As FILE Ptr
f = fopen("somefile.txt", "w")
fprintf( f, "Hello File\n")
fclose( f )
Windows API
Many (many) headers for the Windows API are available for inclusion in FreeBASIC source code. In most cases the only include file needed is "windows.bi". For example,
#include once "windows.bi"
MessageBox( null, "Hello World", "FreeBASIC", MB_OK )
MessageBox( null, "Hello World", "FreeBASIC", MB_OK )
To include a specific Windows API header, prefix the name of the header with "win/" for example:
#include once "win/ddraw.bi"
Browse the "./inc/win/" directory where FreeBASIC was installed to see all of the available Windows API headers.
Other Headers Provided
Browse the "./inc/" directory located where FreeBASIC was installed to find other headers. It is possible that headers might be available for a library you need to use. Some headers are located in "./inc/" and others might be located in a sub-directory. To include headers located in a subdirectory of "./inc/", prefix the name of the header with the name of the directory where it is located. For example:
'' located in ./inc/
#include once "curl.bi"
'' located in ./inc/GL
#include once "GL/gl.bi"
#include once "curl.bi"
'' located in ./inc/GL
#include once "GL/gl.bi"
Requirements for Using Prebuilt Static Libraries
Requirements for Using Prebuilt Shared Libraries
- The source code must include the appropriate headers using #include.
- The shared library (.DLL) must be present on the host computer where the compiled program will run.
