cppreference.com

Log in

Namespaces

Variants

Views

Actions

fmax, fmaxf, fmaxl

From cppreference.com

< c‎ | numeric‎ | math

Compiler support

Program utilities

Variadic function support

Dynamic memory management

Strings library

Date and time utilities

Input/output support

Localization support

Concurrency support (C11)

Technical Specifications

Common mathematical functions

Floating-point environment (C99)

Pseudo-random number generation

Complex number arithmetic (C99)

Type-generic math (C99)

Bit manipulation (C23)

Checked integer arithmetic (C23)

Common mathematical functions

Functions

Basic operations

abslabsllabsimaxabs

(C99)(C99)

divldivlldivimaxdiv

(C99)(C99)

(C99)

(C99)

(C99)

(C99)

nannanfnanlnandN

(C99)(C99)(C99)(C23)

Maximum/minimum operations

fmax

(C99)

(C99)

(C23)

(C23)

(C23)

(C23)

(C23)

(C23)

fmaximum_mag_num

(C23)

fminimum_mag_num

(C23)

Exponential functions

(C23)

(C99)

(C99)

(C23)

(C23)

(C99)

(C99)(C23)

(C23)

(C23)

Power functions

(C99)

(C23)

(C23)

(C99)

(C23)

(C23)

(C23)

Trigonometric and hyperbolic functions

(C23)

(C23)

(C23)

(C23)

(C23)

(C23)

(C23)

(C99)

(C99)

(C99)

Nearest integer floating-point

roundlroundllround

(C99)(C99)(C99)

(C23)

(C99)

(C99)

rintlrintllrint

(C99)(C99)(C99)

fromfpfromfpxufromfpufromfpx

(C23)(C23)(C23)(C23)

Floating-point manipulation

(C99)(C99)

(C99)(C23)

(C99)

nextafternexttoward

(C99)(C99)

(C23)(C23)

(C99)

(C23)

Narrowing operations

(C23)

(C23)

(C23)

(C23)

(C23)

(C23)

Quantum and quantum exponent

(C23)

(C23)

(C23)

(C23)

Decimal re-encoding functions

(C23)

(C23)

(C23)

(C23)

Total order and payload functions

(C23)

(C23)

(C23)

(C23)

Classification

(C99)

(C23)

(C99)

(C99)

(C99)

(C99)

(C99)

(C23)

(C23)

(C99)

(C99)

(C99)

(C99)

(C99)

(C99)

(C23)

(C23)

Error and gamma functions

(C99)

(C99)

(C99)

(C99)

Types

div_tldiv_tlldiv_timaxdiv_t

(C99)(C99)

float_tdouble_t

(C99)(C99)

_Decimal32_t_Decimal64_t

(C23)(C23)

Macro constants

Special floating-point values

HUGE_VALHUGE_VALFHUGE_VALLHUGE_VALDN

(C99)(C99)(C23)

INFINITYDEC_INFINITY

(C99)(C23)

(C99)(C23)

Arguments and return values

FP_ILOGB0FP_ILOGBNAN

(C99)(C99)

FP_NORMALFP_SUBNORMALFP_ZEROFP_INFINITEFP_NAN

(C99)(C99)(C99)(C99)(C99)

FP_LLOGB0FP_LLOGBNAN

(C23)(C23)

FP_INT_UPWARDFP_INT_DOWNWARDFP_INT_TOWARDZEROFP_INT_TONEARESTFROMZEROFP_INT_TONEAREST

(C23)(C23)(C23)(C23)(C23)

Error handling

MATH_ERRNOMATH_ERRNOEXCEPT

(C99)(C99)

math_errhandling

(C99)

Fast operation indicators

FP_FAST_FMAFFP_FAST_FMA

(C99)(C99)

FP_FAST_FADDFP_FAST_FADDLFP_FAST_DADDLFP_FAST_DMADDDN

(C23)(C23)(C23)(C23)

FP_FAST_FMULFP_FAST_FMULLFP_FAST_DMULLFP_FAST_DMMULDN

(C23)(C23)(C23)(C23)

FP_FAST_FFMAFP_FAST_FFMALFP_FAST_DFMALFP_FAST_DMFMADN

(C23)(C23)(C23)(C23)

FP_FAST_FMALFP_FAST_FMADN

(C99)(C23)

FP_FAST_FSUBFP_FAST_FSUBLFP_FAST_DSUBLFP_FAST_DMSUBDN

(C23)(C23)(C23)(C23)

FP_FAST_FDIVFP_FAST_FDIVLFP_FAST_DDIVLFP_FAST_DMDIVDN

(C23)(C23)(C23)(C23)

FP_FAST_FSQRTFP_FAST_FSQRTLFP_FAST_DSQRTLFP_FAST_DMSQRTDN

(C23)(C23)(C23)(C23)

Defined in header <math.h>

float fmaxf( float x, float y );

(1) (since C99)

double fmax( double x, double y );

(2) (since C99)

long double fmaxl( long double x, long double y );

(3) (since C99)

Defined in header <tgmath.h>

#define fmax( x, y )

(4) (since C99)

1-3) Returns the larger of two floating-point arguments, treating NaNs as missing data (between a NaN and a numeric value, the numeric value is chosen).

4) Type-generic macro: If any argument has type long double, fmaxl is called. Otherwise, if any argument has integer type or has type double, fmax is called. Otherwise, fmaxf is called.

Contents

1 Parameters
2 Return value
3 Error handling
4 Notes
5 Example
6 References
7 See also

[edit] Parameters

x, y - floating-point values

[edit] Return value

If successful, returns the larger of two floating-point values. The value returned is exact and does not depend on any rounding modes.

[edit] Error handling

This function is not subject to any of the error conditions specified in math_errhandling.

If the implementation supports IEEE floating-point arithmetic (IEC 60559),

If one of the two arguments is NaN, the value of the other argument is returned.
Only if both arguments are NaN is NaN returned.

[edit] Notes

This function is not required to be sensitive to the sign of zero, although some implementations additionally enforce that if one argument is +0 and the other is -0, then +0 is returned.

[edit] Example

Run this code

#include <math.h>
#include <stdio.h>
 
int main(void)
{
 printf ("fmax(2,1) = %f\n", fmax(2,1));
 printf ("fmax(-Inf,0) = %f\n", fmax(-INFINITY,0));
 printf ("fmax(NaN,-1) = %f\n", fmax(NAN,-1));
}

Output:

fmax(2,1) = 2.000000
fmax(-Inf,0) = 0.000000
fmax(NaN,-1) = -1.000000

[edit] References

C23 standard (ISO/IEC 9899:2024):

7.12.12.2 The fmax functions (p: TBD)

7.25 Type-generic math <tgmath.h> (p: TBD)

F.10.9.2 The fmax functions (p: TBD)

C17 standard (ISO/IEC 9899:2018):

7.12.12.2 The fmax functions (p: 188)

7.25 Type-generic math <tgmath.h> (p: 397)

F.10.9.2 The fmax functions (p: 386)

C11 standard (ISO/IEC 9899:2011):

7.12.12.2 The fmax functions (p: 257-258)

7.25 Type-generic math <tgmath.h> (p: 373-375)

F.10.9.2 The fmax functions (p: 530)

C99 standard (ISO/IEC 9899:1999):

7.12.12.2 The fmax functions (p: 238-239)

7.22 Type-generic math <tgmath.h> (p: 335-337)

F.9.9.2 The fmax functions (p: 466)

[edit] See also

(C99)

checks if the first floating-point argument is greater than the second
(function macro) [edit]

(C99)(C99)(C99)

determines smaller of two floating-point values
(function) [edit]

C++ documentation for fmax

Retrieved from "https://en.cppreference.com/mwiki/index.php?title=c/numeric/math/fmax&oldid=172015"