fmaxf4

NAME

fmaxf4 - return larger values of float elements

SYNOPSIS

Procedure call syntax:

#include <simdmath.h>
vector float fmaxf4(vector float x, vector float y);
Link with -lsimdmath

Inline call syntax:

#include <simdmath.h>
#include <fmaxf4.h>
vector float _fmaxf4(vector float x, vector float y);
Parameters  
x.y input vectors

DESCRIPTION

The fmaxf4 function returns a vector containing the larger (more positive) elements of x and y.

RETURN VALUE

The function fmaxf4 returns a float vector in which each element is defined as:
  • the larger (more positive) of the corresponding elements of x and y.
  • If one element is NaN and the other is numeric, the numeric value is returned.
  • If both elements are NaN, NaN is returned.

On the SPU single-precision subnormal values are not coerced to zero by this function. Instead, it compares them as normal values even though the floating-point instructions of the SPU do not.

In double precision subnormals1 equate to zero and so compare as equal. This means that the value returned may be either one of the subnormals, thereby making the following possibly true for two subnormal inputs:

fmaxf4(a, b) != fmaxf4(b, a)

ENVIRONMENT

SPU and PPU

CONFORMING TO

SIMD Math library specification for the Cell Broadband Engineā„¢ Architecture.

NOTES

Basis

ISO9899 (C99) fmax functions.

SEE ALSO

fmax(3), fmaxd2(3), fmin(3), fminf4(3), fmind2(3), fdim(3), fdimf4(3), fdimd2(3)
1 subnormality: a) the transitive closure of normality; b) floating-point numbers too small to be expressed in normal form.