NAME

_ldecvt(), _ldfcvt(), _ldgcvt() − convert long-double floating-point number to string

SYNOPSIS

#include <stdlib.h>

char *_ldecvt(long_double value, size_t ndigit, int *decpt, int *sign);

char *_ldfcvt(long_double value, size_t ndigit, int *decpt, int *sign);

char *_ldgcvt(long_double value, size_t ndigit, char *buf);

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. 

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 a single static-data array whose content is overwritten by each call. 

AUTHOR

_ldecvt(), _ldfcvt(), and _ldgcvt() were developed by HP. 

SEE ALSO

setlocale(3C), printf(3S), hpnls(5), lang(5). 

EXTERNAL INFLUENCES

Locale

The LC_NUMERIC category determines the radix character. 

International Code Set Support

Single-byte character code sets are supported. 

Hewlett-Packard Company  —  HP-UX Release 9.10: April 1995