PSET 3CW "16 April 2007" "mathcw-1.00"

Table of contents


NAME

psetf, pset, psetl, psetw, psetq, psetll, psetdf, psetd, psetdl, psetdll - pair-precision set

SYNOPSIS

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

#include <mathcw.h>
#include <paircw.h>

extern void psetf (float_pair result, float x, float y);

extern void pset (double_pair result, double x, double y);

extern void psetl (long_double_pair result, long double x, long double y);

extern void psetw (__float80_pair result, __float80 x, __float80 y);

extern void psetq (__float128_pair result, __float128 x, __float128 y);

extern void psetll (long_long_double_pair result, long_long_double x, long_long_double y);

extern void psetdf (decimal_float_pair result, decimal_float x, decimal_float y);

extern void psetd (decimal_double_pair result, decimal_double x, decimal_double y);

extern void psetdl (decimal_long_double_pair result, decimal_long_double x, decimal_long_double y);

extern void psetdll (decimal_long_long_double_pair result, decimal_long_long_double x,
                     decimal_long_long_double y);

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


DESCRIPTION

Initialize a pair-precision value to high and low parts x and y.

This function provides a type cast from ordinary scalar floating-point arithmetic to pair-precision arithmetic.

If y is zero, pset(3CW) ensures that the zero value stored has the same sign as that of x; this action is necessary to ensure proper handling of signed zeros in other pair-precision arithmetic functions.

Use this function when the magnitude of the low part is known to be smaller than that of the high part by at least a factor of the machine epsilon, or if both parts are zero, or if the low part is zero. Otherwise, use psum2(3CW) for the initialization.


RETURN VALUES

None. The function result is stored in the first argument, result.

ERRORS

None.

SEE ALSO

pabs(3CW), pacos(3CW), pacosh(3CW), padd(3CW), pasin(3CW), pasinh(3CW), patan(3CW), patan2(3CW), patanh(3CW), pcbrt(3CW), pcmp(3CW), pcon(3CW), pcopy(3CW), pcopysign(3CW), pcos(3CW), pcosh(3CW), pcotan(3CW), pdiv(3CW), pdot(3CW), peps(3CW), peval(3CW), pexp(3CW), pexp10(3CW), pexp16(3CW), pexp2(3CW), pexp8(3CW), pexpm1(3CW), pfdim(3CW), pfmax(3CW), pfmin(3CW), pfrexp(3CW), pfrexph(3CW), phigh(3CW), phypot(3CW), pierf(3CW), pierfc(3CW), pilogb(3CW), pin(3CW), pinfty(3CW), pipow(3CW), pisinf(3CW), pisnan(3CW), pisqnan(3CW), pissnan(3CW), pldexp(3CW), pldexph(3CW), plog(3CW), plog101p(3CW), plog1p(3CW), plow(3CW), pmul(3CW), pmul2(3CW), pneg(3CW), pout(3CW), pprosum(3CW), pqnan(3CW), pscalbln(3CW), pscalbn(3CW), psignbit(3CW), psin(3CW), psinh(3CW), psnan(3CW), psplit(3CW), psqrt(3CW), psub(3CW), psum(3CW), psum2(3CW), ptan(3CW), ptanh(3CW).