NAME

       Tcl_NewDoubleObj,  Tcl_SetDoubleObj,  Tcl_GetDoubleFromObj  -  manipulate  Tcl  objects as
       floating-point values

SYNOPSIS

       #include <tcl.h>

       Tcl_Obj *
       Tcl_NewDoubleObj(doubleValue)

       Tcl_SetDoubleObj(objPtr, doubleValue)

       int
       Tcl_GetDoubleFromObj(interp, objPtr, doublePtr)

ARGUMENTS

       double doubleValue (in)              A  double-precision  floating-point  value  used   to
                                            initialize or set a Tcl object.

       Tcl_Obj *objPtr (in/out)             For  Tcl_SetDoubleObj,  this  points to the object in
                                            which    to    store    a    double    value.     For
                                            Tcl_GetDoubleFromObj,  this refers to the object from
                                            which to retrieve a double value.

       Tcl_Interp *interp (in/out)          When non-NULL, an error message  is  left  here  when
                                            double value retrieval fails.

       double *doublePtr (out)              Points  to  place  to store the double value obtained
                                            from objPtr.
_________________________________________________________________________________________________

DESCRIPTION

       These procedures are used to create, modify,  and  read  Tcl  objects  that  hold  double-
       precision floating-point values.

       Tcl_NewDoubleObj  creates  and  returns  a  new Tcl object initialized to the double value
       doubleValue.  The returned Tcl object is unshared.

       Tcl_SetDoubleObj sets the value of an existing Tcl object pointed  to  by  objPtr  to  the
       double  value doubleValue.  The objPtr argument must point to an unshared Tcl object.  Any
       attempt to set the value of a shared Tcl object violates Tcl's copy-on-write policy.   Any
       existing  string representation or internal representation in the unshared Tcl object will
       be freed as a consequence of setting the new value.

       Tcl_GetDoubleFromObj attempts to retrieve a double value from the Tcl object  objPtr.   If
       the  attempt  succeeds,  then  TCL_OK  is returned, and the double value is written to the
       storage pointed to by doublePtr.  If the attempt fails, then TCL_ERROR is returned, and if
       interp  is non-NULL, an error message is left in interp.  The Tcl_ObjType of objPtr may be
       changed to make subsequent calls to Tcl_GetDoubleFromObj more efficient.

SEE ALSO

       Tcl_NewObj, Tcl_DecrRefCount, Tcl_IncrRefCount, Tcl_GetObjResult

KEYWORDS

       double, double object, double type, internal representation, object, object  type,  string
       representation