INCLUDE()

From Lianjapedia
Jump to: navigation, search

Purpose

Function to load a procedure or C Extensions library

Syntax

INCLUDE(<expC>)

See Also

CLOSE PROCEDURE, DO, FUNCTION, INCLUDE_ONCE(), LIST PROCEDURE, PARAMETERS, PROCEDURE, RELEASE LIBRARY, REQUIRE(), REQUIRE_ONCE(), SET LIBRARY

Description

The INCLUDE() function opens the specified extension or procedure library file, 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("pdf.so")
// Close pdf.so C extensions library
release library pdf.so
// Close all active C extensions library files
set library to