Tcl_StaticPackage(3) Tcl Library Procedures Tcl_StaticPackage(3)
_________________________________________________________________________________________________
NAME
Tcl_StaticPackage - make a statically linked package available via the 'load' command
SYNOPSIS
#include <tcl.h>
Tcl_StaticPackage(interp, pkgName, initProc, safeInitProc)
ARGUMENTS
Tcl_Interp *interp (in) If not NULL, points to an interpreter into
which the package has already been loaded
(i.e., the caller has already invoked the
appropriate initialization procedure).
NULL means the package has not yet been
incorporated into any interpreter.
const char *pkgName (in) Name of the package; should be properly
capitalized (first letter upper-case, all
others lower-case).
Tcl_PackageInitProc *initProc (in) Procedure to invoke to incorporate this
package into a trusted interpreter.
Tcl_PackageInitProc *safeInitProc (in) Procedure to call to incorporate this
package into a safe interpreter (one that
will execute untrusted scripts). NULL
means the package cannot be used in safe
interpreters.
_________________________________________________________________
DESCRIPTION
This procedure may be invoked to announce that a package has been linked statically with a
Tcl application and, optionally, that it has already been loaded into an interpreter.
Once Tcl_StaticPackage has been invoked for a package, it may be loaded into interpreters
using the load command. Tcl_StaticPackage is normally invoked only by the Tcl_AppInit
procedure for the application, not by packages for themselves (Tcl_StaticPackage should
only be invoked for statically loaded packages, and code in the package itself should not
need to know whether the package is dynamically or statically loaded).
When the load command is used later to load the package into an interpreter, one of init-
Proc and safeInitProc will be invoked, depending on whether the target interpreter is safe
or not. initProc and safeInitProc must both match the following prototype:
typedef int Tcl_PackageInitProc(Tcl_Interp *interp);
The interp argument identifies the interpreter in which the package is to be loaded. The
initialization procedure must return TCL_OK or TCL_ERROR to indicate whether or not it
completed successfully; in the event of an error it should set the interpreter's result to
point to an error message. The result or error from the initialization procedure will be
returned as the result of the load command that caused the initialization procedure to be
invoked.
KEYWORDS
initialization procedure, package, static linking
Tcl 7.5 Tcl_StaticPackage(3)
Generated by $Id: phpMan.php,v 4.55 2007/09/05 04:42:51 chedong Exp $ Author: Che Dong
On Apache/2.4.6 (CentOS)
Under GNU General Public License
2025-06-23 22:12 @127.0.0.1 CrawledBy Wget/1.21.2