NAME
_ldecvt(), _ldfcvt(), _ldgcvt() — convert long-double floating-point number to string
SYNOPSIS
#include <stdlib.h>
char *_ldecvt(long_double value, int ndigit, int *decpt, int *sign);
char *_ldgcvt(long_double value, int ndigit, char *buf);
char *_ldfcvt(long_double value, int ndigit, int *decpt, int *sign);
Obsolescent Interfaces
int _ldecvt_r(
long_double value,
int ndigit,
int *decpt,
int *sign,
char *buffer,
int buflen);
int _ldfcvt_r(
long_double value,
int ndigit,
int *decpt,
int *sign,
char *buffer,
int buflen);
DESCRIPTION
- _ldecvt()
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.
- _ldfcvt()
is identical to
_ldecvt(),
except that the correct digit has been rounded for printf
%Lf
(FORTRAN F-format) output of the number of digits specified by
ndigit.
- _ldgcvt()
Convert the
value
to a null-terminated string in the array pointed to by
buf
and return
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
are included in the returned string.
Trailing zeros are suppressed.
The radix character is determined by the currently loaded
NLS
environment (see
setlocale(3C)).
If
setlocale()
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
_ldecvt_r(),
_ldfcvt_r()
convert long-double floating-point number to string.
APPLICATION USAGE
_ldecvt(),
_ldfcvt()
and
_ldgcvt()
are thread-safe. These interfaces are not async-cancel-safe.
RETURN VALUE
NaN
is returned for Not-a-Number, and
±INFINITY
is returned for Infinity.
WARNINGS
The values returned by
_ldecvt()
and
_ldfcvt()
point to data
whose content is overwritten by subsequent calls to these
interfaces by the same thread.
_ldecvt_r()
and
_ldfcvt_r()
are obsolescent interfaces supported only for compatibility with
existing DCE applications. New multithreaded applications should use
_ldecvt()
and
_ldfcvt().
EXTERNAL INFLUENCES
Locale
The
LC_NUMERIC
category determines the radix character.
International Code Set Support
Single-byte character code sets are supported.
AUTHOR
_ldecvt(),
_ldfcvt(),
and
_ldgcvt()
were developed by HP.
