Difference between revisions of "LOADLIBRARY()"
Yvonne.milne (Talk | contribs) |
Barrymavin (Talk | contribs) |
||
| Line 19: | Line 19: | ||
==Example== | ==Example== | ||
<code lang="recital"> | <code lang="recital"> | ||
| − | // Open | + | // Open example API extension library |
| − | loadlibrary(" | + | loadlibrary("example.dll") |
| + | |||
// Open pdf.so procedure library without closing active libraries | // Open pdf.so procedure library without closing active libraries | ||
set library to pdf.so additive | set library to pdf.so additive | ||
| + | |||
// Close pdf.so API procedure library | // Close pdf.so API procedure library | ||
release library pdf.so | release library pdf.so | ||
| − | // Close all active API | + | |
| − | set library to</code> | + | // Close all active API extension libraries |
| + | set library to | ||
| + | </code> | ||
[[Category:Documentation]] | [[Category:Documentation]] | ||
Revision as of 02:04, 17 April 2013
Contents
Purpose
Load an API library file
Syntax
LOADLIBRARY(<expC>)
See Also
CLOSE PROCEDURE, DISPLAY PROCEDURE, DO, FUNCTION, LIST PROCEDURE, PARAMETERS, PROCEDURE, RELEASE LIBRARY, REQUIRE(), REQUIRE_ONCE(), SET LIBRARY
Description
The LOADLIBRARY() function opens the specified API procedure library file, <expC>, scans the contents of it, and records the names and positions of the procedures defined within it. You can place as many procedures as you want in an API procedure library file. By default, library files are loaded from the directory defined in the DB_LIBDIR Registry setting / environment variable. To load a library that is not in the current directory or the DB_LIBDIR directory, the full path must be included.
The SET LIBRARY TO command, without any filename specified, closes all active API procedure library files. A closed library file discards any knowledge of where the procedures within reside. The RELEASE LIBRARY <library filename> command can be used to close an individual API library file.
The LOADLIBRARY() function and the SET LIBRARY and RELEASE LIBRARY commands only affect API procedure library files, not Lianja procedure library files: these are handled by the SET PROCEDURE and CLOSE PROCEDURE commands and the REQUIRE() and REQUIRE_ONCE() functions.
The active API procedures and functions can be listed with the LIST or DISPLAY PROCEDURE commands. Classes can be listed with the LIST or DISPLAY CLASSES commands.
Example
// Open example API extension library loadlibrary("example.dll") // Open pdf.so procedure library without closing active libraries set library to pdf.so additive // Close pdf.so API procedure library release library pdf.so // Close all active API extension libraries set library to
