---
name: "PrintDbl"
section: "3"
platform: "macos"
package: "tcl"
version: "152"
release: "macOS 26.5"
platforms: ["macos"]
url: "https://new.carta.tech/PrintDbl"
---

# PrintDbl(3)

Convert floating value to string

## NAME

Tcl\_PrintDouble - Convert floating value to string

## SYNOPSIS

```
#include <tcl.h>

Tcl_PrintDouble(interp, value, dst)
```

## ARGUMENTS

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. Floating-point value to be converted. 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 so that it does not look like an integer.  Where **%g** would generate an integer with no decimal point, **Tcl\_PrintDouble** adds

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