Unix/Linux Go Back    


OpenDarwin 7.2.1 - man page for tcl_recordandeval (opendarwin section 3)

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)


Tcl_RecordAndEval(3)		      Tcl Library Procedures		     Tcl_RecordAndEval(3)

_________________________________________________________________________________________________

NAME
       Tcl_RecordAndEval - save command on history list before evaluating

SYNOPSIS
       #include <tcl.h>

       int
       Tcl_RecordAndEval(interp, cmd, flags)

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

       CONST 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
       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  the	interpreter's 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.

       Note  that  Tcl_RecordAndEval  has  been  largely  replaced  by the object-based procedure
       Tcl_RecordAndEvalObj.  That object-based procedure records and optionally executes a  com-
       mand held in a Tcl object instead of a string.

SEE ALSO
       Tcl_RecordAndEvalObj

KEYWORDS
       command, event, execute, history, interpreter, record

Tcl					       7.4			     Tcl_RecordAndEval(3)
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums


All times are GMT -4. The time now is 06:11 AM.