Manual Pages for UNIX Operating System command usage for man Tcl_RecordAndEval

Tcl Library Procedures                    Tcl_RecordAndEval(3TCL)



_________________________________________________________________

NAME
     Tcl_RecordAndEval - save  command  on  history  list  before
     evaluating

SYNOPSIS
     #include 

     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 his-
     tory  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  command
     held in a Tcl object instead of a string.






Tcl                     Last change: 7.4                        1






Tcl Library Procedures                    Tcl_RecordAndEval(3TCL)



SEE ALSO
     Tcl_RecordAndEvalObj


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

ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     _______________________________________
    |   ATTRIBUTE TYPE   |  ATTRIBUTE VALUE|
    |____________________|__________________|_
    | Availability       |  runtime/tcl-8  |
    |____________________|__________________|_
    | Interface Stability|  Uncommitted    |
    |____________________|_________________|

NOTES
     Source for Tcl is available on http://opensolaris.org.


































Tcl                     Last change: 7.4                        2