Namespaces
Variants

fmin, fminf, fminl

From cppreference.net
< c ‎ | numeric ‎ | math
C
Numerics
Common mathematical functions
Functions
Basic operations
(C99)
(C99)
(C99)
(C99)
(C99) (C99) (C99) (C23)
Maximum/minimum operations
(C99)
fmin
(C99)
(C23)
(C23)
(C23)
Exponential functions
Power functions
Trigonometric and hyperbolic functions
Nearest integer floating-point
(C99)
(C99) (C99) (C99)
(C23) (C23) (C23) (C23)
Floating-point manipulation
Narrowing operations
(C23)
(C23)
(C23)
(C23)
(C23)
(C23)
Quantum and quantum exponent
Decimal re-encoding functions
Total order and payload functions
Classification
Error and gamma functions
(C99)
(C99)
(C99)
(C99)
Types
Macro constants
Special floating-point values
Arguments and return values
Error handling
Fast operation indicators
Определено в заголовочном файле <math.h>
float fminf ( float x, float y ) ;
(1) (начиная с C99)
double fmin ( double x, double y ) ;
(2) (начиная с C99)
long double fminl ( long double x, long double y ) ;
(3) (начиная с C99)
Определено в заголовочном файле <tgmath.h>
#define fmin( x, y )
(4) (начиная с C99)
1-3) Возвращает наименьший из двух аргументов с плавающей точкой, рассматривая NaN как отсутствующие данные (между NaN и числовым значением выбирается числовое значение).
4) Макрос общего типа: Если какой-либо аргумент имеет тип long double , fminl вызывается. В противном случае, если какой-либо аргумент имеет целочисленный тип или тип double , fmin вызывается. В противном случае fminf вызывается.

Содержание

Параметры

x, y - значения с плавающей запятой

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

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

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

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

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

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

Примечания

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

Пример

Запустить этот код 
#include <math.h>
#include <stdio.h>
int main(void)
{
    printf("fmin(2,1)    = %f\n", fmin(2, 1));
    printf("fmin(-Inf,0) = %f\n", fmin(-INFINITY, 0));
    printf("fmin(NaN,-1) = %f\n", fmin(NAN, -1));
}

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

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

Ссылки

  • Стандарт C23 (ISO/IEC 9899:2024):
  • 7.12.12.3 Функции fmin (стр.: TBD)
  • 7.25 Обобщенная математика <tgmath.h> (стр.: TBD)
  • F.10.9.3 Функции fmin (стр.: TBD)
  • Стандарт C17 (ISO/IEC 9899:2018):
  • 7.12.12.3 Функции fmin (стр.: TBD)
  • 7.25 Обобщенная математика <tgmath.h> (стр.: TBD)
  • F.10.9.3 Функции fmin (стр.: TBD)
  • Стандарт C11 (ISO/IEC 9899:2011):
  • 7.12.12.3 Функции fmin (стр. 258)
  • 7.25 Обобщенная математика <tgmath.h> (стр. 373-375)
  • F.10.9.3 Функции fmin (стр. 530)
  • Стандарт C99 (ISO/IEC 9899:1999):
  • 7.12.12.3 Функции fmin (стр. 239)
  • 7.22 Обобщённые математические функции <tgmath.h> (стр. 335-337)
  • F.9.9.3 Функции fmin (стр. 466)

Смотрите также

(C99)
проверяет, является ли первый аргумент с плавающей точкой меньше второго
(макрос функции)
(C99) (C99) (C99)
определяет большее из двух значений с плавающей точкой
(функция)
C++ documentation для fmin