DllLoad

Gamma: Version 4.0
Prev |  | Next

# `DllLoad`

`DllLoad` -- loads dynamic libraries.

## Syntax

    DllLoad ("filename", verbose? = nil)

## Arguments

`filename`

  The name of the dynamic library to be loaded.

`verbose`

  When set to `t`, shows the paths of load attempts.

## Returns

An integer "handle" on success, or an error message.

## Description

This function loads a DLL if the system supports it (Linux, QNX 6, and MS-Windows). The first search path for the DLL is taken to be `./`, next is `/usr/cogent/dll/`, and finally the system DLL search path, if any.

## Example

Without using the optional `verbose` parameter:

        Gamma> DllLoad("gammagtk.so");
        135024608
        Gamma>

Using the optional `verbose` parameter:

        Gamma> DllLoad("gammagtk.so", t);
        DllLoad: attempting to load: ./gammagtk.so
        DllLoad: attempting to load: /usr/cogent/dll/gammagtk.so
        135024608
        Gamma>

## See Also

`AutoLoad`

Prev | Home | Next
`dlfunc` | Up | `dlmethod`

Copyright 1995-2002 by Cogent Real-Time Systems, Inc.