NAME

Tcl_PkgRequire, Tcl_PkgProvide - package version control

SYNOPSIS

#include <tcl.h>
char *
Tcl_PkgRequire(interp, name, version, exact)
int
Tcl_PkgProvide(interp, name, version)

ARGUMENTS

Tcl_Interp *interp (in)
Interpreter where package is needed or available.

char *name (in)
Name of package.

char *version (in)
A version string consisting of one or more decimal numbers separated by dots.

int exact (in)
Non-zero means that only the particular version specified by version is acceptable. Zero means that newer versions than version are also acceptable as long as they have the same major version number as version.

DESCRIPTION

These procedures provide C-level interfaces to Tcl's package and version management facilities. Tcl_PkgRequire is equivalent to the package require command, and Tcl_PkgProvide is equivalent to the package provide command. See the documentation for the Tcl commands for details on what these procedures do. If Tcl_PkgRequire completes successfully it returns a pointer to the version string for the version of the package that is provided in the interpreter (which may be different than version); if an error occurs it returns NULL and leaves an error message in interp->result. Tcl_PkgProvide returns TCL_OK if it completes successfully; if an error occurs it returns TCL_ERROR and leaves an error message in interp->result.

KEYWORDS

package, provide, require, version
Copyright © 1996 Sun Microsystems, Inc.
Copyright © 1995-1997 Roger E. Critchlow Jr.