Linux Man на русском

  User    Syst    Libr    Device    Files    Other    Admin  



   erf - функция ошибки

erf(3) функция ошибки

Other Alias

erff, erfl


ОБЗОР

#include <math.h>
double erf(double x);
float erff(float x);
long double erfl(long double x);

Компонуется при указании параметра -lm.

Требования макроса тестирования свойств для glibc (см. feature_test_macros(7)):

erf():

_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE || _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L;
или cc -std=c99
erff(), erfl():
_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE >= 600 || _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L;
или cc -std=c99


ОПИСАНИЕ

Эти функции возвращают функцию ошибки от x, определённую как

    erf(x) = 2/sqrt(pi)* интеграл от 0 до x по exp(-t*t) dt


ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ

При успешном выполнении эти функции возвращают функцию ошибки от x, значение в диапазоне [-1, 1].

Если x имеет значение NaN, будет возвращено NaN.

Если x равно +0 (-0), будет возвращено +0 (-0).

Если x стремится к плюс или минус бесконечности, то будет возвращено +1 или -1.

Если значение x субнормально, то генерируется ошибка диапазона и возвращается значение 2*x/sqrt(pi).


ОШИБКИ

Смотрите math_error(7), чтобы определить, какие ошибки могут возникать при вызове этих функций.

Могут возникать следующие ошибки:


Ошибка диапазона: результат потерял разрядность (x субнормально) Возникает исключение исчезновение порядка плавающей запятой (FE_UNDERFLOW).

Эти функции не изменяют errno.


АТРИБУТЫ

Описание терминов данного раздела смотрите в attributes(7).

Интерфейс Атрибут Значение
erf(), erff(), erfl() безвредность в потоках: безвредно (MT-Safe)


СООТВЕТСТВИЕ СТАНДАРТАМ

C99, POSIX.1-2001, POSIX.1-2008.

Вариант, возвращающий значение типа double, также соответствует SVr4, 4.3BSD.