Tcl_GetDoubleFromObj(3) - phpMan

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  ini-
                                            tialize 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_GetDoubleFro-
                                            mObj,  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-preci-
       sion floating-point values.

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

       Tcl_SetDoubleObj sets the value of an existing Tcl object pointed to by objPtr to the dou-
       ble  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



Tcl                                            8.0                               Tcl_DoubleObj(3)

Generated by $Id: phpMan.php,v 4.55 2007/09/05 04:42:51 chedong Exp $ Author: Che Dong
On Apache
Under GNU General Public License
2024-04-25 12:11 @18.119.160.154 CrawledBy Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)