home *** CD-ROM | disk | FTP | other *** search
- '\" Copyright 1989 Regents of the University of California
- '\" Permission to use, copy, modify, and distribute this
- '\" documentation for any purpose and without fee is hereby
- '\" granted, provided that this notice appears in all copies.
- '\" The University of California makes no representations about
- '\" the suitability of this material for any purpose. It is
- '\" provided "as is" without express or implied warranty.
- '\"
- '\" $Header: /sprite/src/lib/tcl/RCS/Tcl_CreateInterp.man,v 1.2 89/03/24 14:16:00 ouster Exp $ SPRITE (Berkeley)
- '\"
- .so \*(]ltmac.sprite
- .HS Tcl_CreateInterp tcl
- .BS
- .SH NAME
- Tcl_CreateInterp \- set up a new Tcl command interpreter
- .SH SYNOPSIS
- .nf
- \fB#include <tcl.h>\fR
- .sp
- Tcl_Interp *
- \fBTcl_CreateInterp\fR()
- .BE
-
- .SH DESCRIPTION
- .PP
- \fBTcl_CreateInterp\fR creates a new interpreter structure and returns
- a token for it. The token is required in calls to most other Tcl
- procedures, such as \fBTcl_CreateCommand\fR, \fBTcl_Eval\fR, and
- \fBTcl_DeleteInterp\fR.
- Clients are only allowed to access the fields of Tcl_Interp structures
- related to command return values; see the Tcl_Interp
- and \fBTcl_CreateCommand\fR man pages for details.
- The new interpreter is initialized with no defined variables and only
- the built-in Tcl commands. To bind in additional commands, call
- \fBTcl_CreateCommand\fR.
-
- .SH KEYWORDS
- command, create, interpreter
-