ldcvt.3c (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

ldcvt(3C) ldcvt(3C)

NAME

_ldecvt( ), _ldfcvt( ), _ldgcvt( ) - convert long-double ﬂoating-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 nega-

tive, 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 speciﬁed by ndigit .

_ldgcvt() Convert the value to a null-terminated string in the array pointed to by buf and return

buf. It produces ndigit signiﬁcant 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. 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 speciﬁes a period (.) as the radix character.

Obsolescent Interfaces

_ldecvt_r(), _ldfcvt_r() convert long-double ﬂoating-point number to string.

RETURN VALUE

NaN is returned for Not-a-Number, and ±INFINITY is returned for Inﬁnity.

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

existing 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 3: September 2010 − 1 − Hewlett-Packard Company 1