---
name: "fmaximum_num"
section: "3"
platform: "freebsd"
package: "base"
version: "16.0-CURRENT-20261027-61c70dc16a79"
release: "FreeBSD 16.0-CURRENT (2026-10-27)"
platforms: ["freebsd"]
url: "https://new.carta.tech/fmaximum_num"
---

# fmaximum\_num(3)

floating-point maximum and minimum number functions

## NAME

**fmaximum\_num**, **fmaximum\_numf**, **fmaximum\_numl**, **fminimum\_num**, **fminimum\_numf**, **fminimum\_numl** – floating-point maximum and minimum number functions

## LIBRARY

Math Library (libm, -lm)

## SYNOPSIS

**#include \<math.h\>**

*double*\

**fmaximum\_num**(*double x*, *double y*);

*float*\

**fmaximum\_numf**(*float x*, *float y*);

*long double*\

**fmaximum\_numl**(*long double x*, *long double y*);

*double*\

**fminimum\_num**(*double x*, *double y*);

*float*\

**fminimum\_numf**(*float x*, *float y*);

*long double*\

**fminimum\_numl**(*long double x*, *long double y*);

## DESCRIPTION

The **fmaximum\_num**(), **fmaximum\_numf**(), and **fmaximum\_numl**() functions determine the larger of *x* and *y*, preferring a numeric value over an . If one argument is a numeric value and the other is an , the numeric value is returned. If both arguments are numeric, the larger value is returned. If both arguments are s, a quiet  is returned. For the purpose of these functions, positive zero is considered greater than negative zero.

Likewise, the **fminimum\_num**(), **fminimum\_numf**(), and **fminimum\_numl**() functions determine the smaller of *x* and *y*, preferring a numeric value over an . If one argument is a numeric value and the other is an , the numeric value is returned. If both arguments are numeric, the smaller value is returned. If both arguments are s, a quiet  is returned. For the purpose of these functions, negative zero is considered less than positive zero.

Unlike with the [fmaximum(3)](/fmaximum/3.md) and [fmaximum\_mag(3)](/fmaximum_mag/3.md) families of functions, 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)](/fmax/3.md), [fmaximum(3)](/fmaximum/3.md), [fmaximum\_mag(3)](/fmaximum_mag/3.md), [math(3)](/math/3.md)

## STANDARDS

The **fmaximum\_num**(), **fmaximum\_numf**(), **fmaximum\_numl**(), **fminimum\_num**(), **fminimum\_numf**(), and **fminimum\_numl**() functions conform to ISO/IEC 9899:2024 (“ISO C23”).

## HISTORY

These routines first appeared in FreeBSD 16.0.
