This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

This manual page is associated with the Mac OS X developer tools. The software or headers described may not be present on your Mac OS X installation until you install the developer tools package. This package is available on your Mac OS X installation DVD, and the latest versions can be downloaded from developer.apple.com.

For more information about the manual page format, see the manual page for manpages(5).

Tcl_DoubleObj(3)                           Tcl Library Procedures                           Tcl_DoubleObj(3)



____________________________________________________________________________________________________________

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 double object.

       Tcl_Obj      *objPtr       (in/out)  For  Tcl_SetDoubleObj, this points to the object to be converted
                                            to double type.  For Tcl_GetDoubleFromObj, this  refers  to  the
                                            object  from  which  to  get  a double value; if objPtr does not
                                            already point to a double object, an attempt  will  be  made  to
                                            convert it to one.

       Tcl_Interp   *interp       (in/out)  If  an  error occurs during conversion, an error message is left
                                            in the interpreter's result object unless interp is NULL.

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


DESCRIPTION
       These  procedures  are  used to create, modify, and read double Tcl objects from C code.  Tcl_NewDou-bleObj Tcl_NewDoubleObj
       bleObj and Tcl_SetDoubleObj will create a new object of double type or modify an existing  object  to
       have  double  type.   Both  of  these procedures set the object to have the double-precision floating
       point value given by doubleValue; Tcl_NewDoubleObj returns a pointer to a newly created  object  with
       reference count zero.  Both procedures set the object's type to be double and assign the double value
       to the object's internal representation doubleValue member.   Tcl_SetDoubleObj  invalidates  any  old
       string  representation and, if the object is not already a double object, frees any old internal rep-resentation. representation.
       resentation.

       Tcl_GetDoubleFromObj attempts to return a double value from the Tcl object objPtr.  If the object  is
       not already a double object, it will attempt to convert it to one.  If an error occurs during conver-sion, conversion,
       sion, it returns TCL_ERROR and leaves an error message in  the  interpreter's  result  object  unless
       interp  is  NULL.   Otherwise,  it returns TCL_OK and stores the double value in the address given by
       doublePtr.  If the object is not already a double object, the conversion will free any  old  internal
       representation.


SEE ALSO
       Tcl_NewObj, Tcl_DecrRefCount, Tcl_IncrRefCount, Tcl_GetObjResult


KEYWORDS
       double,  double object, double type, internal representation, object, object type, string representa-tion representation
       tion



Tcl                                                  8.0                                    Tcl_DoubleObj(3)