Difference between revisions of "INCLUDE()"
From Lianjapedia
Yvonne.milne (Talk | contribs) m (1 revision) |
Yvonne.milne (Talk | contribs) |
||
| Line 1: | Line 1: | ||
==Purpose== | ==Purpose== | ||
| − | Load a | + | Load a procedure or C Extensions library |
| − | + | ||
==Syntax== | ==Syntax== | ||
INCLUDE(<expC>) | INCLUDE(<expC>) | ||
| − | |||
==See Also== | ==See Also== | ||
[[CLOSE PROCEDURE]], [[DO]], [[FUNCTION]], [[INCLUDE_ONCE()]], [[LINK]], [[LIST PROCEDURE]], [[PARAMETERS]], [[PROCEDURE]], [[RELEASE LIBRARY]], [[REQUIRE()]], [[REQUIRE_ONCE()]], [[SET LIBRARY]] | [[CLOSE PROCEDURE]], [[DO]], [[FUNCTION]], [[INCLUDE_ONCE()]], [[LINK]], [[LIST PROCEDURE]], [[PARAMETERS]], [[PROCEDURE]], [[RELEASE LIBRARY]], [[REQUIRE()]], [[REQUIRE_ONCE()]], [[SET LIBRARY]] | ||
| − | |||
==Description== | ==Description== | ||
| − | The INCLUDE() function opens the specified | + | 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 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 | + | 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. | The active procedures and functions can be listed with the LIST or DISPLAY PROCEDURE commands. | ||
| − | |||
| − | |||
| − | |||
==Example== | ==Example== | ||
<code lang="recital"> | <code lang="recital"> | ||
| − | // Open | + | // Open pdf.so C extensions library located in current directory |
| − | include(" | + | include("pdf.so") |
| − | // Close pdf.so | + | // Close pdf.so C extensions library |
release library pdf.so | release library pdf.so | ||
| − | // Close all active | + | // Close all active C extensions library files |
set library to | set library to | ||
</code> | </code> | ||
| − | |||
| − | |||
| − | |||
[[Category:Documentation]] | [[Category:Documentation]] | ||
[[Category:Functions]] | [[Category:Functions]] | ||
Revision as of 09:54, 9 January 2013
Contents
Purpose
Load a procedure or C Extensions library
Syntax
INCLUDE(<expC>)
See Also
CLOSE PROCEDURE, DO, FUNCTION, INCLUDE_ONCE(), LINK, 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
