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

Определено в заголовочном файле `<cmath>`
float fmin ( float x, float y ); double fmin ( double x, double y ); long double fmin ( long double x, long double y );	(1)	(до C++23)
constexpr /floating-point-type/ fmin ( /floating-point-type/ x, /floating-point-type/ y );	(1)		(начиная с 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)
Перегрузка SIMD (начиная с C++26)
Определено в заголовочном файле `<simd>`
template< class V0, class V1 > constexpr /math-common-simd-t/<V0, V1> fmin ( const V0& v_x, const V1& v_y );	(S)	(начиная с C++26)
Дополнительные перегрузки (начиная с 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)

S) Перегрузка SIMD выполняет поэлементное std::fmin над v_xи v_y. (Определение см. в разделе math-common-simd-t.) (начиная с C++26)

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

(начиная с C++11)

Параметры

x, y

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

Возвращаемое значение

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

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

На эту функцию не распространяются условия ошибок, указанные в math_errhandling.

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

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

Примечания

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

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

Если num1 или num2 имеет тип longdouble, то 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	возвращает наименьшее из заданных значений (шаблон функции и функциональный объект алгоритма)
ranges::min (C++20)
min_element	возвращает наименьший элемент в диапазоне (шаблон функции и функциональный объект алгоритма)
ranges::min_element (C++20)
minmax (C++11)	возвращает меньшее и большее из двух элементов (шаблон функции и функциональный объект алгоритма)
ranges::minmax (C++20)
minmax_element (C++11)	возвращает наименьший и наибольший элементы в диапазоне (шаблон функции и функциональный объект алгоритма)
ranges::minmax_element (C++20)
Документация по C для `fmin`

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