TclOO Package

Update of "Doc: Tcl_OOInitStubs"
Login
Bounty program for improvements to Tcl and certain Tcl packages.
Tcl 2018 Conference, Houston/TX, US, Oct 15-19
Send your abstracts to tclconference@googlegroups.com
or submit via the online form by Aug 20.

Many hyperlinks are disabled.
Use anonymous login to enable hyperlinks.

Overview

Artifact ID: ff1939cd0e185d29156fa63044ae05f4b91e4368
Page Name:Doc: Tcl_OOInitStubs
Date: 2016-09-17 13:57:11
Original User: dkf
Mimetype:text/x-markdown
Parent: c23d92c9c44f1d148572c81b53e60225cd4ac25f
Content

Tcl_OOInitStubs

NAME

Tcl_OOInitStubs — initialize library access to TclOO functionality

SYNOPSIS

#include <tclOO.h>
const char *Tcl_OOInitStubs(interp)

ARGUMENTS

Tcl_Interp *interp (in)
The Tcl interpreter that the TclOO API is integrated with and whose C interface is going to be used.

DESCRIPTION

When an extension library is going to use the C interface exposed by TclOO, it should use Tcl_OOInitStubs to initialize its access to that interface from within its *_Init (or *_SafeInit) function, passing in the interp that was passed into that routine as context. If the result of calling Tcl_OOInitStubs is NULL, the initialization failed and an error message will have been left in the interpreter's result. Otherwise, the initialization succeeded and the TclOO API may thereafter be used; the version of the TclOO API is returned.

When using this function, either the C #define symbol USE_TCLOO_STUBS should be defined and your library code linked against the Tcl stub library, or that #define symbol should not be defined and your library code linked against the Tcl main library directly.

BACKWARD COMPATIBILITY NOTE

If you are linking against the Tcl 8.5 forward compatibility package for TclOO, only the stub-enabled configuration is supported and you should also link against the TclOO independent stub library; that library is an integrated part of the main Tcl stub library in Tcl 8.6.

KEYWORDS

stubs