| THE META-HTML LANGUAGE REFERENCE MANUAL

Server Variables | [TOC] | Direct Dbm Access

## Section Intro: Dynamic Modules

Synopsis:

You can now write C language code to implement your own built-in Meta-HTML functions! Such functions are first-class objects, and can manipulate the Meta-HTML environment directly, easily reset the parser pointer, manage hardware devices or talk on proprietery networks, or anything else that you can do in C.

It works by supplying you with the necessary Meta-HTML header files and a Makefile for building modules on your system. Using our supplied Makefile provides you with a resultant dynamically loadable module, which can be loaded into the Server, Engine, or a single page with the `<load-module>` function.

See the `modules` directory of the distribution for more details.

Commands:

load-module |  |  |

### Function Documentation

`<load-module MODULE-NAME>` | Simple

Loads a module dynamically at runtime, adding the function definitions found therein to the global package of Meta-HTML functions.

`load-module` returns the string `"true"` if the module is loaded successfully, or places an error in `system-error-output` if not.

MODULE-NAME is searched for by looking in each directory specified in the array `mhtml::module-directories`, or by loading the module as if the name specified is the full pathname to that file.

Once a module is loaded, the functions within it can be invoked just as with any standard Meta-HTML command.

See the `examples.c` file in the `modules` directory of your distribution for more information on writing Meta-HTML modules.

Example:

    <set-var loaded? = <load-module /www/lib/example.so>>

Edit Section
Function Index
Variable Index

The META-HTML Reference Manual V1.4 Copyright © 1995, 1996, Brian J. Fox, 1996, 1997 Universal Access Inc.
Found a bug? Send mail to bug-manual@metahtml.com