Guardian Native C Library Calls Reference Manual (G06.29+, H06.08+, J06.03+)

ldexpl(3) Guardian Native C Library Calls Reference Manual
NAME
ldexpl - Multiplies a long double number by a power of 2
LIBRARY
H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL
32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll
64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll
SYNOPSIS
#include <math.h>
long double ldexpl(
long double value,
int exp
);
PARAMETERS
value Specifies the long double value to be multiplied by a power of 2.
exp Specifies the exponent for 2.
DESCRIPTION
Every nonzero number can be written uniquely as x times 2 raised to the power n, where the
mantissa (fraction), x, is in the range 0.5 ≤ | x | < 1.0, and the exponent, n, is an integer.
The ldexpl() function is a long double version of the ldexp() function; it takes a long double
argument and returns a long double result.
The ldexpl() function multiplies the floating-point number value by an integral power of 2.
NOTES
This function supports both IEEE Std 754-1985 floating-point and Tandem floating-point values
in the native environment. IEEE values can include NaN and infinity, and the sign of 0.0 (zero)
can be either positive or negative. Refer to the fp_class(3) reference page for a description of
IEEE value classes.
Guardian functions are available to convert between floating-point formats. Refer to the Guar-
dian Programmer’s Guide for a discussion of floating-point conversions.
RETURN VALUES
Upon successful completion, the ldexpl() function returns a long double value equal to value
times 2 to the power exp.
For IEEE floating-point values, if the value of value is NaN, NaN is returned. If the value of
value is positive or negative infinity, the value of value is returned.
If ldexpl() would cause overflow, positive or negative HUGE_VALL is returned (according to
the sign of value) and errno is set to [ERANGE]. If ldexpl() would cause underflow, a value of
0.0 (zero) is returned and errno is set to [ERANGE].
ERRORS
If any of the following conditions occurs, the ldexpl() function sets errno to the corresponding
value:
[ERANGE] The value to be returned would cause an overflow or underflow.
4−18 Hewlett-Packard Company 527192-018