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