Open System Services Library Calls Reference Manual (G06.29+, H06.08+, J06.03+)

scalblnl(3) OSS Library Calls Reference Manual
NAME
scalblnl - Computes the long integral exponent of a radix-independent long double number
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 scalblnl(
long double x,
long int n
);
PARAMETERS
x Is the long double value to be multiplied.
n Is the long integral exponent of the radix.
DESCRIPTION
The scalblnl( ) function is a long double version of the scalbln( ) function; it takes a long double
first argument and returns a long double result.
The scalblnl( ) function calculates the value of x * r
n
, for long integral values of n, where r is the
radix of the machine’s floating-point arithmetic.
The difference between scalblnl( ) and scalbnl( ) is that the value of n is long int for scalblnl( ),
instead of int for scalbnl( ).
When r is 2, the scalblnl( ) function is equivalent to the ldexpl( ) function.
NOTES
This function is implemented only for the IEEE_float floating-point option. Applications using
this function cannot be compiled if the specified floating-point option is Tandem_float.
RETURN VALUES
Upon successful completion, scalblnl( ) returns the value of x * r
n
.
If the value of x is Nan, NaN is returned.
If the value of x is positive or negative zero or positive or negative infinity, x is returned.
If the value of n is 0 (zero), x is returned.
If the result would cause overflow, the scalblnl( ) function returns +HUGE_VALL or -
HUGE_VALL (according to the sign of x ) and sets errno to [ERANGE].
If the correct value would cause underflow, the scalblnl( ) function returns 0.0 (zero) and sets
errno to [ERANGE].
ERRORS
If any of the following conditions occurs, the scalblnl( ) function sets errno to the corresponding
value:
[ERANGE] The result would cause underflow or overflow.
6−8 Hewlett-Packard Company 527187-017