NAME

ecvt, fcvt, gcvt, nl_gcvt − convert floating-point number to string

SYNOPSIS

char ∗ecvt (value, ndigit, decpt, sign)
double value;
int ndigit, ∗decpt, ∗sign;

char ∗fcvt (value, ndigit, decpt, sign)
double value;
int ndigit, ∗decpt, ∗sign;

char ∗gcvt (value, ndigit, buf)
double value;
int ndigit;
char ∗buf;

char ∗nl_gcvt (value, ndigit, buf, langid)
double value;
int ndigit;
char ∗buf;
int langid;

DESCRIPTION

Ecvt converts value to a null-terminated string of ndigit digits and returns a pointer to the string.  The high-order digit is non-zero, unless the value is zero.  The low-order digit is rounded.  The position of the radix character relative to the beginning of the string is stored indirectly through decpt (negative means to the left of the returned digits).  The radix character is not included in the returned string.  If the sign of the result is negative, the word pointed to by sign is non-zero, otherwise it is zero. 

Fcvt is identical to ecvt, except that the correct digit has been rounded for printf “%f” (FORTRAN F-format) output of the number of digits specified by ndigit.

Gcvt converts the value to a null-terminated string in the array pointed to by buf and returns buf. It produces ndigit significant digits in FORTRAN F-format if possible, or E-format otherwise.  A minus sign, if required, and a radix character will be included in the returned string.  Trailing zeros are suppressed.  The radix character is determined by the currently loaded NLS environment (see nl_init(3C)). If nl_init has not been called successfully, the default NLS environment, ­"n-computer" (see langid(5)), is used.  The default environment specifies a period (.) as the radix character.

Nl_gcvt differs from gcvt only by first calling langinit (see nl_init(3C)) to load the NLS environment according to the language specified by langid.

WARNINGS

The values returned by ecvt and fcvt point to a single static data array whose content is overwritten by each call. 

Nl_gcvt is provided for historical reasons only; its use is not recommended. 

AUTHOR

Ecvt and fcvt were developed by AT&T.  Gcvt was developed by AT&T and HP.  Nl_gcvt was developed by HP. 

SEE ALSO

nl_init(3C), printf(3S), hpnls(5), langid(5). 

INTERNATIONAL SUPPORT

8-bit data. 

Hewlett-Packard Company  —  May 11, 2021