Developer Guide and Reference

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

IEEE_MIN

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

Module

USE, INTRINSIC :: IEEE_ARITHMETIC

result = IEEE_MIN (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 one or both of x or y is a NaN, the result is quiet NaN. Otherwise, one argument is negative zero and the other is positive zero, and the result is negative 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 minimum operation as specified in the ISO/IEC 60559:2020 standard.

Example

The result value of IEEE_MIN (3.7, IEEE_VALUE (0.0, IEEE_QUIET _NAN)) is a quiet NaN. No exceptions are signaled.