Tcl_RecordAndEvalObj(3) Tcl (8.0) Tcl_RecordAndEvalObj(3)
_________________________________________________________________
NAME
Tcl_RecordAndEvalObj - save command on history list before
evaluating
SYNOPSIS
#include <tcl.h>
int
Tcl_RecordAndEvalObj(interp, cmdPtr, flags)
ARGUMENTS
Tcl_Interp *interp (in) Tcl interpreter in which
to evaluate command.
Tcl_Obj *cmdPtr (in) Points to a Tcl object
containing a 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
Tcl_RecordAndEvalObj is invoked to record a command as an
event on the history list and then execute it using
Tcl_EvalObj (or Tcl_GlobalEvalObj if the TCL_EVAL_GLOBAL bit
is set in flags). It returns a completion code such as
TCL_OK just like Tcl_EvalObj, as well as a result object
containing additional information (a result value or error
message) that can be retrieved using Tcl_GetObjResult. If
you don't want the command recorded on the history list then
you should invoke Tcl_EvalObj instead of
Tcl_RecordAndEvalObj. Normally Tcl_RecordAndEvalObj 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.
SEE ALSO
Tcl_EvalObj, Tcl_GetObjResult
Page 1 (printed 2/19/99)
Tcl_RecordAndEvalObj(3) Tcl (8.0) Tcl_RecordAndEvalObj(3)
KEYWORDS
command, event, execute, history, interpreter, object,
record
Page 2 (printed 2/19/99)