Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
Tcl_RecordAndEvalObj(3)	    Tcl	Library	Procedures     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  value	 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    do     not     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_EvalObjEx It returns a  com-
       pletion	code  such as TCL_OK just like Tcl_EvalObjEx, as well as a re-
       sult value containing additional	information (a result value  or	 error
       message)	 that  can be retrieved	using Tcl_GetObjResult.	 If you	do not
       want the	command	recorded on the	history	list then  you	should	invoke
       Tcl_EvalObjEx  instead of Tcl_RecordAndEvalObj.	Normally Tcl_RecordAn-
       dEvalObj	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_EvalObjEx, Tcl_GetObjResult

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

Tcl				      8.0	       Tcl_RecordAndEvalObj(3)

NAME | SYNOPSIS | ARGUMENTS | DESCRIPTION | SEE ALSO | KEYWORDS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=Tcl_RecordAndEvalObj.tcl87&sektion=3&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help