Tcl_PrintDouble

NAME
SYNOPSIS
ARGUMENTS
DESCRIPTION
KEYWORDS

______________________________________________________________________________

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