Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
Tk_InitStubs(3)		     Tk	Library	Procedures	       Tk_InitStubs(3)

______________________________________________________________________________

NAME
       Tk_InitStubs - initialize the Tk	stubs mechanism

SYNOPSIS
       #include	<tk.h>

       const char *
       Tk_InitStubs(interp, version, exact)

ARGUMENTS
       Tcl_Interp *interp (in)		Tcl interpreter	handle.

       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 particu-
					lar Tk version specified by version is
					acceptable.   Zero means that versions
					newer than version are also acceptable
					as  long  as  they have	the same major
					version	number as version.
______________________________________________________________________________

INTRODUCTION
       The Tcl stubs mechanism defines a way to	dynamically bind extensions to
       a  particular  Tcl implementation at run	time.  the stubs mechanism re-
       quires no changes to  applications  incoporating	 Tcl/Tk	 interpreters.
       Only  developers	 creating C-based Tcl/Tk extensions need to take steps
       to use the stubs	mechanism with their extensions.   See	the  Tcl_Init-
       Stubs page for more information.

       Enabling	 the  stubs mechanism for a Tcl/Tk extension requires the fol-
       lowing steps:

       1)   Call Tcl_InitStubs in the extension	before calling any  other  Tcl
	    functions.

       2)   Call  Tk_InitStubs	if  the	 extension before calling any other Tk
	    functions.

       2)   Define the USE_TCL_STUBS symbol. Typically,	you would include  the
	    -DUSE_TCL_STUBS flag when compiling	the extension.

       3)   Link  the extension	with the Tcl and Tk stubs libraries instead of
	    the	standard Tcl and Tk libraries.	On Unix	platforms, the library
	    names  are	libtclstub8.4.a	 and  libtkstub8.4.a; on Windows plat-
	    forms, the library names are tclstub84.lib and  tkstub84.lib  (ad-
	    just names with appropriate	version	number).

DESCRIPTION
       Tk_InitStubs  attempts to initialize the	Tk stub	table pointers and en-
       sure that the correct version of	Tk is loaded.  In addition to  an  in-
       terpreter  handle, it accepts as	arguments a version number and a Bool-
       ean flag	indicating whether the extension  requires  an	exact  version
       match  or  not.	 If  exact is 0, then the extension is indicating that
       newer versions of Tk are	acceptable as long as they have	the same major
       version	number as version; non-zero means that only the	specified ver-
       sion is acceptable.  Tcl_InitStubs returns a string containing the  ac-
       tual version of Tk satisfying the request, or NULL if the Tk version is
       not acceptable, does not	support	the stubs mechanism, or	any other  er-
       ror condition occurred.

SEE ALSO
       Tcl_InitStubs

KEYWORDS
       stubs

Tk				      8.4		       Tk_InitStubs(3)

NAME | SYNOPSIS | ARGUMENTS | INTRODUCTION | DESCRIPTION | SEE ALSO | KEYWORDS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=Tk_InitStubs.tk85&sektion=3&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help