Table of contents

Documentation

In order to integrate any C or \CC code with Tcl it is necessary to declare to the Tcl interpreter(s) the new commands implemented by one's Tcl code. This library contains three simple \CC classes which perform this feat. One class implements a \CC Tcl-intepreter stream class, allowing \CC addicts to use Tcl-interpreters in a more \CC kind of way. Another two classes implement the glue which connects Tcl commands to \CC objects.

The end result for the user is that any \CC object which needs to be creatable and manipulable from Tcl need just inherit from the classs `tcl_object', and a function call must be made once in your preamble to declare the object type.

Furthermore a couple of support classes are included to facilitate the parsing of commands from Tcl into \CC. A stream based class `tcl_args' allows rapid parsing of any Tcl command, including automatic signalling of parsing errors, with informative error messages including syntax, help and available command information -- this makes the Tcl interface to any \CC object self-documenting!

Hence this library may be of use to anyone wishing to write \CC extensions to Tcl. The overhead in terms of code size and speed is negligible.