Reference

fmaximum_mag_num(3)

floating-point maximum and minimum magnitude number functions

NAME

fmaximum_mag_num, fmaximum_mag_numf, fmaximum_mag_numl, fminimum_mag_num, fminimum_mag_numf, fminimum_mag_numl – floating-point maximum and minimum magnitude number functions

LIBRARY

Math Library (libm, -lm)

SYNOPSIS

#include <math.h>

double

fmaximum_mag_num(double x, double y);

float

fmaximum_mag_numf(float x, float y);

long double

fmaximum_mag_numl(long double x, long double y);

double

fminimum_mag_num(double x, double y);

float

fminimum_mag_numf(float x, float y);

long double

fminimum_mag_numl(long double x, long double y);

DESCRIPTION

The fmaximum_mag_num(), fmaximum_mag_numf(), and fmaximum_mag_numl() functions determine the larger of the absolute values of x and y, and return the argument with the larger absolute value, preferring a numeric value over an . If one argument is a numeric value and the other is an , the numeric value is returned. If the absolute values are equal, the behavior is equivalent to calling the corresponding fmaximum_num() function on the arguments.

Likewise, the fminimum_mag_num(), fminimum_mag_numf(), and fminimum_mag_numl() functions determine the smaller of the absolute values of x and y, and return the argument with the smaller absolute value, preferring a numeric value over an . If one argument is a numeric value and the other is an , the numeric value is returned. If the absolute values are equal, the behavior is equivalent to calling the corresponding fminimum_num() function on the arguments.

If both arguments are s, a quiet is returned. If either argument is a signaling , an invalid exception is raised. Otherwise, these routines do not raise any floating-point exceptions.

SEE ALSO

fmax(3), fmaximum(3), fmaximum_mag(3), fmaximum_num(3), math(3)

STANDARDS

The fmaximum_mag_num(), fmaximum_mag_numf(), fmaximum_mag_numl(), fminimum_mag_num(), fminimum_mag_numf(), and fminimum_mag_numl() functions conform to ISO/IEC 9899:2024 (“ISO C23”).

HISTORY

These routines first appeared in FreeBSD 16.0