Load(3) Tcl Library Procedures Load(3)
NAME
Tcl_LoadFile, Tcl_FindSymbol - platform-independent dynamic library
loading
SYNOPSIS
#include <tcl.h>
int
Tcl_LoadFile(interp, pathPtr, symbols, flags, procPtrs, loadHandlePtr)
void *
Tcl_FindSymbol(interp, loadHandle, symbol)
ARGUMENTS
Interpreter to use for reporting error messages. The name of the file
to load. If it is a single name, the library search path of the current
environment will be used to resolve it. Array of names of symbols to
be resolved during the load of the library, or NULL if no symbols are
to be resolved. If an array is given, the last entry in the array must
be NULL. The value should normally be 0, but TCL_LOAD_GLOBAL or
TCL_LOAD_LAZY or a combination of those two is allowed as well. Points
to an array that will hold the addresses of the functions described in
the symbols argument. Should be NULL if no symbols are to be resolved.
Points to a variable that will hold the handle to the abstract token
describing the library that has been loaded. Abstract token describing
the library to look up a symbol in. The name of the symbol to look up.
DESCRIPTION
Tcl_LoadFile loads a file from the filesystem (including potentially
any virtual filesystem that has been installed) and provides a handle
to it that may be used in further operations. The symbols array, if
non-NULL, supplies a set of names of symbols (typically functions) that
must be resolved from the library and which will be stored in the array
indicated by procPtrs. If any of the symbols is not resolved, the load-
ing of the file will fail with an error message left in the interpreter
(if that is non-NULL). The result of Tcl_LoadFile is a standard Tcl
error code. The library may be unloaded with Tcl_FSUnloadFile.
Tcl_FindSymbol locates a symbol in a loaded library and returns it. If
the symbol cannot be found, it returns NULL and sets an error message
in the given interp (if that is non-NULL). Note that it is unsafe to
use this operation on a handle that has been passed to Tcl_FSUnload-
File.
SEE ALSO
Load(3), Load(3)
KEYWORDS
binary code, loading, shared library
Tcl 8.6 Load(3)
tcl 8.6.0 - Generated Sun Jan 13 09:06:15 CST 2013