Tcl_PkgRequire(3) Tcl (7.5) Tcl_PkgRequire(3)
_________________________________________________________________
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
Page 1 (printed 2/19/99)
Tcl_PkgRequire(3) Tcl (7.5) Tcl_PkgRequire(3)
TCL_ERROR and leaves an error message in interp->result.
KEYWORDS
package, provide, require, version
Page 2 (printed 2/19/99)