DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

ecvt(S-osr5)


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

Syntax

cc ... -lc

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;

Description

ecvt- converts value to string of ndigit

fcvt- converts value to string of ndigit rounded for FORTRAN F-format

gcvt- converts value to a null-terminated string in an array

The ecvt function converts value to a null-terminated string of ndigit digits and returns a pointer thereto. The high-order digit is non-zero, unless the value is zero. The low-order digit is rounded up if its value is 5 or greater and rounded down if it is less than 5. The position of the decimal point relative to the beginning of the string is stored indirectly through decpt (negative means to the left of the returned digits). The decimal point 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 attempts to produce ndigit significant digits in FORTRAN F-format if possible, otherwise E-format, ready for printing. A minus sign, if there is one, or a decimal point is included as part of the returned string. Trailing zeros are suppressed.

Notes

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

See also

printf(S-osr5)

Standards conformance

ecvt, fcvt and gcvt are conformant with:

Intel386 Binary Compatibility Specification, Edition 2 (iBCSe2) .


© 2005 The SCO Group, Inc. All rights reserved.
SCO OpenServer Release 6.0.0 -- 02 June 2005