Using Dynamic Libraries

Table of Contents

• Loading a dynamic library
• Getting a procedure address

FPL has built-in support for loading dynamic libraries (.dll/.so).

Loading a dynamic library

To load a dynamic library, such as .dll or .so you simply call fplDynamicLibraryLoad() with the name of the library or the full path.

fplDynamicLibraryHandle libHandle;
if (fplDynamicLibraryLoad("mylibrary.dll", &libHandle)) {
    // ... using the library
 
    // Unload it when you are done
    fplDynamicLibraryUnload(&libHandle);
}

Note

Call fplDynamicLibraryUnload() to unload a loaded library when you are done.

Getting a procedure address

To get a procedure address from a function inside a library, simply call fplGetDynamicLibraryProc() .

typedef int(fn_LengthSquared)(int a, int b);
fplDynamicLibraryHandle libHandle;
if (fplDynamicLibraryLoad("mymathy.dll", &libHandle)) {
    // Get "LengthSquared" raw procedure address
    void *lenSqFuncRaw = fplGetDynamicLibraryProc(&libHandle, "LengthSquared");
 
    // Get "LengthSquared" casted procedure address
    fn_LengthSquared *lenSqFunc = (fn_LengthSquared *)fplGetDynamicLibraryProc(&libHandle, "LengthSquared");
 
    // Use the procedure like any function pointer
    int len = lenSqFunc(3, 6);
 
    // Unload it when you are done
    fplDynamicLibraryUnload(&libHandle);
}