Namespaces
Variants

roundeven, roundevenf, roundevenl

From cppreference.net
< c ‎ | numeric ‎ | math
Common mathematical functions
Functions
Basic operations
(C99)
(C99)
(C99)
(C99) (C99) (C99) (C23)
Maximum/minimum operations
Exponential functions
Power functions
Trigonometric and hyperbolic functions
Nearest integer floating-point
(C99) (C99) (C99)
roundeven
(C23)
(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 roundevenf ( float arg ) ;
(1) (начиная с C23)
double roundeven ( double arg ) ;
(2) (начиная с C23)
long double roundevenl ( long double arg ) ;
(3) (начиная с C23)
Определено в заголовке <tgmath.h>
#define roundeven( arg )
(4) (начиная с C23)
1-3) Вычисляет ближайшее целое значение к arg (в формате с плавающей запятой), округляя средние случаи до ближайшего четного целого, независимо от текущего режима округления.
4) Макрос общего типа: Если arg имеет тип long double , roundevenl вызывается. В противном случае, если arg имеет целочисленный тип или тип double , roundeven вызывается. В противном случае roundevenf вызывается соответственно.

Содержание

Параметры

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

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

Если ошибок не возникает, возвращается ближайшее целочисленное значение к arg , с округлением средних случаев до ближайшего чётного целого числа.

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

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

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

  • FE_INEXACT никогда не возбуждается.
  • Если arg равен ±∞, возвращается без изменений.
  • Если arg равен ±0, возвращается без изменений.
  • Если arg является NaN, возвращается NaN.

Пример

#include <math.h>
#include <stdio.h>
int main(void)
{
    printf("roundeven(+2.4) = %+.1f\n", roundeven(2.4));
    printf("roundeven(-2.4) = %+.1f\n", roundeven(-2.4));
    printf("roundeven(+2.5) = %+.1f\n", roundeven(2.5));
    printf("roundeven(-2.5) = %+.1f\n", roundeven(-2.5));
    printf("roundeven(+2.6) = %+.1f\n", roundeven(2.6));
    printf("roundeven(-2.6) = %+.1f\n", roundeven(-2.6));
    printf("roundeven(+3.5) = %+.1f\n", roundeven(3.5));
    printf("roundeven(-3.5) = %+.1f\n", roundeven(-3.5));
    printf("roundeven(-0.0) = %+.1f\n", roundeven(-0.0));
    printf("roundeven(-Inf) = %+f\n",   roundeven(-INFINITY));
}

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

roundeven(+2.4) = +2.0
roundeven(-2.4) = -2.0
roundeven(+2.5) = +2.0
roundeven(-2.5) = -2.0
roundeven(+2.6) = +3.0
roundeven(-2.6) = -3.0
roundeven(+3.5) = +4.0
roundeven(-3.5) = -4.0
roundeven(-0.0) = -0.0
roundeven(-Inf) = -inf

Ссылки

  • Стандарт C23 (ISO/IEC 9899:2024):
  • 7.12.9.8 Функции roundeven (стр. 265-266)
  • 7.27 Обобщённая математика <tgmath.h> (стр. 386-390)
  • F.10.6.8 Функции roundeven (стр. 532)

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

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