TclExprLongObj(3) Tcl Library Procedures TclExprLongObj(3)

NAME
       TclExprLongObj,  TclExprDoubleObj,  TclExprBooleanObj, TclExprObj -
       evaluate an expression

SYNOPSIS
       ##iinncclluuddee <>

       int
       TTccllEExxpprrLLoonnggOObbjj(interp, objPtr, longPtr)

       int
       TTccllEExxpprrDDoouubblleeOObbjj(interp, objPtr, doublePtr)

       int
       TTccllEExxpprrBBoooolleeaannOObbjj(interp, objPtr, booleanPtr)

       int
       TTccllEExxpprrOObbjj(interp, objPtr, resultPtrPtr)

AARRGGUUMMEENNTTSS
       TclInterp   *interp          (in)      Interpreter in whose context to
                                               evaluate string or objPtr.

       TclObj      *objPtr          (in)      Pointer to an object containing
                                               the expression to evaluate.

       long         *longPtr         (out)     Pointer to location in which to
                                               store  the integer value of the
                                               expression.

       int          *doublePtr       (out)     Pointer to location in which to
                                               store  the floating-point value
                                               of the expression.

       int          *booleanPtr      (out)     Pointer to location in which to
                                               store  the 0/1 boolean value of
                                               the expression.

       TclObj      **resultPtrPtr   (out)     Pointer to location in which to
                                               store  a  pointer to the object
                                               that  is  the  result  of   the
                                               expression.



DESCRIPTION
       These  four procedures all evaluate an expression, returning the result
       in one of four different forms.  The expression is given by the  objPtr
       argument,  and  it  can have any of the forms accepted by the eexxpprr com-
       mand.

       The interp argument refers to  an  interpreter  used  to  evaluate  the
       expression  (e.g.  for variables and nested Tcl commands) and to return
       error information.

       For all of these procedures the return value is a standard Tcl  result:
       TTCCLLOOKK  means  the expression was successfully evaluated, and TTCCLLEERRRROORR
       means that an error  occurred  while  evaluating  the  expression.   If
       TTCCLLEERRRROORR  is  returned,  then  a  message  describing the error can be
       retrieved using TTccllGGeettOObbjjRReessuulltt.  If an error occurs while executing a
       Tcl  command  embedded  in  the  expression  then  that  error  will be
       returned.

       If the expression is successfully evaluated, then its value is returned
       in  one  of  four  forms,  depending  on  which  procedure  is invoked.
       TTccllEExxpprrLLoonnggOObbjj stores an integer value at *longPtr.   If  the  expres-
       sion's actual value is a floating-point number, then it is truncated to
       an integer.  If the expression's actual value is a  non-numeric  string
       then an error is returned.

       TTccllEExxpprrDDoouubblleeOObbjj  stores a floating-point value at *doublePtr.  If the
       expression's actual value is an integer, it is converted  to  floating-
       point.   If  the expression's actual value is a non-numeric string then
       an error is returned.

       TTccllEExxpprrBBoooolleeaannOObbjj stores a 0/1 integer value at *booleanPtr.   If  the
       expression's  actual value is an integer or floating-point number, then
       they store 0 at *booleanPtr if the value was zero and 1 otherwise.   If
       the  expression's  actual value is a non-numeric string then it must be
       one of the values accepted by TTccllGGeettBBoooolleeaann such as ``yes'' or ``no'',
       or else an error occurs.

       If  TTccllEExxpprrOObbjj  successfully  evaluates  the  expression,  it stores a
       pointer  to  the  Tcl  object  containing  the  expression's  value  at
       *resultPtrPtr.   In  this  case,  the caller is responsible for calling
       TTccllDDeeccrrRReeffCCoouunntt to decrement the object's reference count when  it  is
       finished with the object.


SEE ALSO
       TclExprLong,    TclExprDouble,    TclExprBoolean,    TclExprString,
       TclGetObjResult


KKEEYYWWOORRDDSS
       boolean, double, evaluate, expression, integer, object, string



Tcl                                   8.0                   TclExprLongObj(3)