An external library is loaded into memory. The parameter is the name of the external library file. If the library was successfully loaded or already loaded then the predicate is exited, if the library could not be loaded then the predicate fails. It is also possible with this predicate to load external libraries which are not in the plugin subdirectory of the executable nor in the directory of the executable running the Prolog program.
If an external clause is called for the first time and the external library is not loaded then during the first call the library is loaded. This slows down the first call to an external clause of a library. With this predicate it is possible to preload external libraries.
| Under windows the name of the file to load is case insensitive. |
see also: external_library/1 unload_external_library/1
| Examples | |
| load_external_library('numtest.dll'). | In the folder of the executable running the Prolog program and the 'plugin' subfolder of the executable the Windows library file 'numtest.dll' is searched and if found an attempt is started to load it. |
| load_external_library('c:\\temp\\numtest.dll'). | An attempt is made to load the library 'c:\\temp\\numtest.dll', the folder of the executable running the Prolog program and the plugin subfolder are not searched. |