Unix/Linux Go Back    


CentOS 7.0 - man page for tcl_recordandeval (centos 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   do   not   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 do not 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 09:53 AM.