INCLUDE ONCE()
Contents
Purpose
Function to load a procedure or C Extensions library
Syntax
INCLUDE_ONCE(<expC>)
See Also
CLOSE PROCEDURE, DO, FUNCTION, INCLUDE(), LIST PROCEDURE, PARAMETERS, PROCEDURE, RELEASE LIBRARY, REQUIRE(), REQUIRE_ONCE(), SET LIBRARY
Description
The INCLUDE_ONCE() function opens the specified extension or procedure library file if it is not already open, scans the contents of it, and records the names and positions of the procedures defined within it. The <expC> is the name of the library file.
The SET LIBRARY TO command, without any filename specified, closes all active C Extensions 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 C Extensions library file.
The SET PROCEDURE and CLOSE PROCEDURE commands can also be used to handle procedure library files.
The active procedures and functions can be listed with the LIST or DISPLAY PROCEDURE commands.
Example
// Open pdf.so C extensions library located in current directory include_once("pdf.so") // Close pdf.so C extensions library release library pdf.so // Close all active C extensions library files set library to