manpagez: man pages & more
man Load(3)
Home | html | info | man
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
© manpagez.com 2000-2024
Individual documents may contain additional copyright information.