NAME

       Tcl_PrintDouble - Convert floating value to string

SYNOPSIS

       #include <tcl.h>

       Tcl_PrintDouble(interp, value, dst)

ARGUMENTS

       Tcl_Interp *interp (in)          Before   Tcl   8.0,  the  tcl_precision  variable  in  this  interpreter
                                        controlled the conversion.  As of Tcl 8.0, this argument is ignored  and
                                        the  conversion  is controlled by the tcl_precision variable that is now
                                        shared by all interpreters.

       double value (in)                Floating-point value to be converted.

       char *dst (out)                  Where to store the  string  representing  value.   Must  have  at  least
                                        TCL_DOUBLE_SPACE characters of storage.
________________________________________________________________________________________________________________

DESCRIPTION

       Tcl_PrintDouble  generates  a  string  that  represents the value of value and stores it in memory at the
       location given by dst.  It uses %g format to generate the string, with one special twist: the  string  is
       guaranteed  to  contain either a “.”  or an “e” so that it does not look like an integer.  Where %g would
       generate an integer with no decimal point, Tcl_PrintDouble adds “.0”.                                     │

       If the tcl_precision value is non-zero, the result will have precisely that many digits of  significance. │
       If the value is zero (the default), the result will have the fewest digits needed to represent the number │
       in such a way that Tcl_NewDoubleObj will generate the same number when presented with the  given  string. │
       IEEE semantics of rounding to even apply to the conversion.

KEYWORDS

       conversion, double-precision, floating-point, string