GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  TCL_STATICPACKAGE (3)

NAME

Tcl_StaticPackage - make a statically linked package available via the ’load’ command

CONTENTS

Synopsis
Arguments
Description
Keywords

SYNOPSIS

#include <tcl.h>

Tcl_StaticPackage(interp, pkgName, initProc, safeInitProc)

ARGUMENTS


.TP 15 Tcl_Interp *interp (in)
Tcl_Interp*interp Tcl_Interp 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.
.TP 15 const char *pkgName (in)
const char*pkgName const char Name of the package; should be properly capitalized (first letter upper-case, all others lower-case).
.TP 15 Tcl_PackageInitProc *initProc (in)
Tcl_PackageInitProc*initProc Tcl_PackageInitProc Procedure to invoke to incorporate this package into a trusted interpreter.
.TP 15 Tcl_PackageInitProc *safeInitProc (in)
Tcl_PackageInitProc*safeInitProc Tcl_PackageInitProc 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.

   








\L’|0u-1v’\l’75u+3n_’\L’0u+1v-0u’\l’|0u-1.5n_’



\L’|0u-1v’\L’0u+1v-0u’\l’|0u-1.5n_’





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 initProc 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
Search for    or go to Top of page |  Section 3 |  Main Index


Tcl TCL_STATICPACKAGE (3) 7.5

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.