nearest

Date:: 02-08-2023

NAME

NEAREST - Returns the nearest different machine representable number in a given direction

SYNOPSIS

NEAREST ([X=]x, [S=]s)

STANDARDS

Fortran

DESCRIPTION

The NEAREST intrinsic function returns the nearest different machine representable number in a given direction. It accepts the following arguments:

x: Must be of type real
s: Must be of type real and not equal to zero

NEAREST is an elemental function. The name of this intrinsic cannot be passed as an argument.

RETURN VALUES

This intrinsic vectorizes inline for 64-bit operands and calls to scalar-only library routines for 128-bit operands. The result type and type parameter are the same as x. The result has a value equal to the machine-representable number distinct from x and nearest to it in the direction of the infinity with the same sign as s.

EXAMPLES

NEAREST(3.0,2.0) yields 3 + 2-22 according to the real number system model.

For more information on the real number model, see the models(3i) man page.