Tcl_PkgRequire(3) Tcl Library Procedures 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 sepa‐
rated by dots.
int exact (in) Non-zero means that only the par‐
ticular version specified by ver‐
sion 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 ver‐
sion management facilities. Tcl_PkgRequire is equivalent to the pack‐
age 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 suc‐
cessfully 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 com‐
pletes successfully; if an error occurs it returns TCL_ERROR and leaves
an error message in interp->result.
KEYWORDS
package, provide, require, version
Tcl 7.5 Tcl_PkgRequire(3)