Developer Guide and Reference

ID 767251
Date 10/31/2024
Public
Document Table of Contents

IEEE_MAX

Inquiry Module Intrinsic Function (Generic): Returns the maximum of two values. This is equivalent to the IEEE maximum operation.

Module

USE, INTRINSIC :: IEEE_ARITHMETIC

result = IEEE_MAX (x,y)

x

(Input) Must be of type REAL.

y

(Input) Must be of type REAL with the same kind type parameter as x.

Results

The result type is REAL with the same kind type parameter as x. If x > y, the result is x. If y > x, the result is y. If x == y and both have the same sign, the result is either x or y. If either x or y is a NaN, the result is a quiet NaN. Otherwise, one argument is negative zero, the other is positive zero, and the result is positive zero.

If either or both of the arguments is a signaling NaN, the exception IEEE_INVALID is signaled. No other exceptions are signaled.

This is the maximum operation as specified in the ISO/IEC 60559:2020 standard.

Example

The result value of IEEE_MAX (3.7, IEEE_VALUE (0.0, IEEE_SIGNALING_NAN)) is a NaN. The exception IEEE_INVALID is signaled.