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

Guardian Native C Library Calls (f) fdiml(3)
NAME
fdiml - Computes the positive difference between two long double values
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 fdiml(
long double x,
long double y
);
PARAMETERS
x Specifies a long double value.
y Specifies a long double value.
DESCRIPTION
The fdiml() function is a long double version of the fdim( ) function; it takes long double argu-
ments and returns a long double result.
The fdiml() function computes the positive difference between x and y.Ifx is greater than y, x -
y is returned. If x is less than or equal to y, positive zero is returned.
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, the fdiml() function returns the positive difference between x and
y.
If x - y is positive and overflows, HUGE_VALL is returned and errno is set to [ERANGE].
If x - y is positive and underflows, 0.0 (zero) is returned.
If x or y is NaN, NaN is returned.
ERRORS
If any of the following conditions occurs, the fdiml() function sets errno to the corresponding
value:
[ERANGE] The result would cause an overflow.
RELATED INFORMATION
Functions: fdim(3), fdimf(3), fmin(3), fmax(3).
Files: math(4).
STANDARDS CONFORMANCE
This function conforms to the ISO/IEC 9899:1999 standard.
This function conforms to the IEEE Std 1003.1, 2004 Edition.
527192-018 Hewlett-Packard Company 2−11