Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
Tcl_PrintDouble(3)	    Tcl	Library	Procedures	    Tcl_PrintDouble(3)


       Tcl_PrintDouble - Convert floating value	to string

       #include	<tcl.h>

       Tcl_PrintDouble(interp, value, dst)

       Tcl_Interp *interp (in)		Before	 Tcl  8.0,  the	 tcl_precision
					variable  in  this  interpreter	  con-
					trolled	 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_DOU-
					BLE_SPACE characters of	storage.

       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  for-
       mat to generate the string, with	one special twist: the string is guar-
       anteed 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.

       conversion, double-precision, floating-point, string

Tcl				      8.0		    Tcl_PrintDouble(3)


Want to link to this manual page? Use this URL:

home | help