Tcl_RecordAndEval(3Tcl)				       Tcl_RecordAndEval(3Tcl)

NAME    [Toc]    [Back]

     Tcl_RecordAndEval - save command on history list before evaluating

SYNOPSIS    [Toc]    [Back]

     #include <tcl.h>

     int
     Tcl_RecordAndEval(interp, cmd, eval)

ARGUMENTS    [Toc]    [Back]

     Tcl_Interp	  *interp    (in)      Tcl interpreter in which	to evaluate
				       command.

     char	  *cmd	     (in)      Command (or sequence of commands) to
				       execute.

     int	  flags	     (in)      An OR'ed	combination of flag bits.     |
				       TCL_NO_EVAL means record	the command   |
				       but don't evaluate it.  TCL_EVAL_GLOBAL|
				       means evaluate the command at global   |
				       level instead of	the current stack     |
				       level.

DESCRIPTION    [Toc]    [Back]

     Tcl_RecordAndEval is invoked to record a command as an event on the
     history list and then execute it using Tcl_Eval (or Tcl_GlobalEval	if the|
     TCL_EVAL_GLOBAL bit is set	in flags).  It returns a completion code such
     as	TCL_OK just like Tcl_Eval and it leaves	information in interp->result.
     If	you don't want the command recorded on the history list	then you
     should invoke Tcl_Eval instead of Tcl_RecordAndEval.  Normally
     Tcl_RecordAndEval is only called with top-level commands typed by the
     user, since the purpose of	history	is to allow the	user to	re-issue
     recently-invoked commands.	 If the	flags argument contains	the
     TCL_NO_EVAL bit then the command is recorded without being	evaluated.

KEYWORDS    [Toc]    [Back]

     command, event, execute, history, interpreter, record


									PPPPaaaaggggeeee 1111