ecvt(3C) ecvt(3C)
NAME
ecvt(), fcvt(), gcvt() - convert floating-point number to string
SYNOPSIS
Obsolescent Interfaces
DESCRIPTION
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.
One of three non-digit characters strings could be returned if the converted value is out of range. A or is returned if the
value is larger than the exponent can contain, and is negative, or positive, respectively. The third string is returned if the
number is illegal, a zero divide for example. The result value is Not A Number (NAN) and would return a character.
Identical to
except that the correct digit has been rounded for printf (FORTRAN F-format) output of the number of digits specified by
ndigit.
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 is included in the
returned string. Trailing zeros are suppressed. The radix character is determined by the currently loaded NLS environment
(see setlocale(3C)). If has not been called successfully, the default NLS environment, "C", is used (see lang(5)). The
default environment specifies a period as the radix character.
Obsolescent Interfaces
and convert floating-point number to string.
EXTERNAL INFLUENCES
Locale
The category determines the value of the radix character within the current NLS environment.
WARNINGS
The values returned by and point to an array whose content is overwritten by subsequent calls to these interfaces by the same thread.
and are obsolescent interfaces supported only for compatibility with existing DCE applications. New multi-threaded applications should use
and
AUTHOR
and were developed by AT&T. was developed by AT&T and HP.
SEE ALSO
setlocale(3C), printf(3S), lang(5), thread_safety(5), glossary(9).
STANDARDS CONFORMANCE
ecvt(3C)