HP-UX Reference (11i v1 05/09) - 3 Library Functions A-M (vol 6)

l
ldcvt(3C) ldcvt(3C)
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 char-
acter 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 F
ORTRAN F-format if possible, or E-format otherwise.
A minus sign, if required, and a radix character are included in the returned string. Trail-
ing 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.
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 sub-
sequent calls to these interfaces by the same thread.
_ldecvt_r() and _ldfcvt_r() are obsolescent interfaces supported only for compatibility with exist-
ing DCE applications. New multithreaded applications should use _ldecvt() and
_ldfcvt().
EXTERNAL INFLUENCES
Locale
The
LC_NUMERIC category determines the radix character.
HP-UX 11i Version 1: September 2005 − 1 − Hewlett-Packard Company Section 3−−517