std::fmin, std::fminf, std::fminl

Определено в заголовке `<cmath>`
	(1)
float fmin ( float x, float y ); double fmin ( double x, double y ); long double fmin ( long double x, long double y );		(до C++23)
constexpr /* floating-point-type / fmin ( / floating-point-type / x, / floating-point-type */ y );		(с C++23)
float fminf( float x, float y );	(2)	(с C++11) (constexpr с C++23)
long double fminl( long double x, long double y );	(3)	(с C++11) (constexpr с C++23)
Дополнительные перегрузки (с C++11)
Определено в заголовке `<cmath>`
template< class Integer > double fmin ( Integer x, Integer y );	(A)	(constexpr с C++23)

1-3) Возвращает меньшее из двух аргументов с плавающей точкой, обрабатывая NaN как пропущенные данные (между NaN и числовым значением выбирается числовое значение). Библиотека предоставляет перегрузки std::fmin для всех типов с плавающей точкой без квалификаторов cv в качестве типа параметров.(с C++23)

A) Дополнительные перегрузки предоставляются для всех целочисленных типов, которые обрабатываются как double.

(с C++11)

Параметры

x, y

значения с плавающей точкой или целые значения

Значение возврата

В случае успеха возвращает меньшее из двух значений с плавающей точкой. Возвращаемое значение является точным и не зависит от режимов округления.

Обработка ошибок

Эта функция не подчиняется ни одному из условий ошибок, указанных в math_errhandling.

Если реализация поддерживает арифметику с плавающей точкой IEEE (IEC 60559),

Если один из двух аргументов является NaN, возвращается значение другого аргумента.
Только если оба аргумента являются NaN, возвращается NaN.

Примечания

Эта функция не обязана учитывать знак нуля, хотя некоторые реализации дополнительно требуют, чтобы если один аргумент +0 , а другой -0, то возвращалось -0.

Дополнительные перегрузки не требуются, чтобы предоставляться точно как (A). Они должны быть достаточными для того, чтобы для их первого аргумента num1 и второго аргумента num2:

Если num1 или num2 имеет тип long double, то std::fmin(num1, num2) имеет тот же эффект, что и std::fmin(static_cast<long double>(num1), static_cast<long double>(num2)).
В противном случае, если num1 и/или num2 имеет тип double или целочисленный тип, то std::fmin(num1, num2) имеет тот же эффект, что и std::fmin(static_cast<double>(num1), static_cast<double>(num2)).
В противном случае, если num1 или num2 имеет тип float, то std::fmin(num1, num2) имеет тот же эффект, что и std::fmin(static_cast<float>(num1), static_cast<float>(num2)).

(до C++23)

Если num1 и num2 имеют типы арифметики, то std::fmin(num1, num2) имеет тот же эффект, что и std::fmin(static_cast</* common-floating-point-type */>(num1), static_cast</* common-floating-point-type */>(num2)), где /* common-floating-point-type */ - это тип с плавающей точкой с наибольшим рангом преобразования с плавающей точкой и наибольшим подрангом преобразования с плавающей точкой между типами num1 и num2, аргументы целочисленного типа считаются имеющими тот же ранг преобразования с плавающей точкой, что и double.

Если такого типа с плавающей точкой с наибольшим рангом и подрангом не существует, то разрешение перегрузки не приводит к работоспособному кандидату из предоставляемых перегрузок.

(с C++23)

Пример

#include <cmath>
#include <iostream>
 
int main()
{
    std::cout << "fmin(2,1)    = " << std::fmin(2, 1) << '\n'
              << "fmin(-Inf,0) = " << std::fmin(-INFINITY, 0) << '\n'
              << "fmin(NaN,-1) = " << std::fmin(NAN, -1) << '\n';
}

Возможный вывод:

fmin(2,1)    = 1
fmin(-Inf,0) = -inf
fmin(NaN,-1) = -1

См. также

isless (C++11)	проверяет, меньше ли первый аргумент с плавающей точкой второго (функция)
fmaxfmaxffmaxl (C++11)(C++11)(C++11)	большее из двух значений с плавающей точкой (функция)
min	возвращает меньшее из заданных значений (шаблон функции)
min_element	возвращает наименьший элемент в диапазоне (шаблон функции)
minmax (C++11)	возвращает меньшее и большее из двух элементов (шаблон функции)
minmax_element (C++11)	возвращает наименьший и наибольший элементы в диапазоне (шаблон функции)
C документация для `fmin`

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/numeric/math/fmin