NTOS 3CW "21 March 2008" "mathcw-1.00"

Table of contents


NAME

ntosf, ntos, ntosl, ntosw, ntosq, ntosll, ntosdf, ntosd, ntosdl, ntosdll - number to string conversion

SYNOPSIS

cc [ flags ] -I/usr/local/include file(s) -L/usr/local/lib -lmcw [ ... ]

#include <mathcw.h>

extern const char * ntosf (float x);

extern const char * ntos (double x);

extern const char * ntosl (long double x);

extern const char * ntosw (__float80 x);

extern const char * ntosq (__float128 x);

extern const char * ntosll (long_long_double x);

extern const char * ntosdf (decimal_float x);

extern const char * ntosd (decimal_double x);

extern const char * ntosdl (decimal_long_double x);

extern const char * ntosdll (decimal_long_long_double x);

NB: Functions with prototypes containing underscores in type names may be available only with certain extended compilers.


DESCRIPTION

Convert the argument to a string in an internal buffer, with enough digits to recover the value exactly. For decimal floating-point values, the functions of the ntos family provide the only conversion that preserves quantization, the position of the decimal point in the coefficient.

RETURN VALUES

Return a pointer to the internal buffer, which is overwritten on subsequent calls. Thus, the functions are not thread safe, and cannot be reliably used to supply multiple arguments to a single printf(3CW) call.

ERRORS

None.

SEE ALSO

cvtia(3CW), cvtib(3CW), cvtid(3CW), cvtig(3CW), cvtih(3CW), cvtio(3CW), cvtob(3CW), cvtod(3CW), cvtog(3CW), cvtoh(3CW), cvtoi(3CW), cvton(3CW), cvtoo(3CW), printf(3CW), scanf(3CW).