find-foreign-library
Prev | Functions & Libraries | Next

## Name

find-foreign-library — Finds a foreign library file. Function

## Syntax

    	  find-foreign-library names directories & drive-letters types => path

## Arguments and Values

`names`

  A string or list of strings containing the base name of the library file.

`directories`

  A string or list of strings containing the directory the library file.

`drive-letters`

  A string or list of strings containing the drive letters for the library file.

`types`

  A string or list of strings containing the file type of the library file. Default is `NIL`. If `NIL`, will use a default type based on the currently running implementation.

path

  A path containing the path found, or `NIL` if the library file was not found.

## Description

Finds a foreign library by searching through a number of possible locations. Returns the path of the first found file.

## Examples

    (find-foreign-library '("libmysqlclient" "libmysql")
        '("/opt/mysql/lib/mysql/" "/usr/local/lib/" "/usr/lib/" "/mysql/lib/opt/")
        :types '("so" "dll")
        :drive-letters '("C" "D" "E"))
    => #P"D:\\mysql\\lib\\opt\\libmysql.dll"

## Side Effects

None.

## Affected by

None.

## Exceptional Situations

None.

Prev | Up | Next
load-foreign-library | Home | Appendix A. Installation