ACOS(3)

ИМЯ
acos, acosf, acosl - функция вычисления арккосинуса

ОБЗОР
#include <math.h>

double acos(double x);
float acosf(float x);
long double acosl(long double x);

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

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

acosf(), acosl():
    _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
        || /* начиная с glibc 2.19: */ _DEFAULT_SOURCE
        || /* версии glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

ОПИСАНИЕ
Эти функции вычисляют косинус значения x; конус результата будет равен x.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ
В случае успеха эти функции возвращают арккосинус от x в радианах; результат находится в диапазоне значений [0, pi]. Если x равно NaN, будет возвращено NaN. Если x равно +1, будет возвращён +0. Если x стремится к плюс бесконечности или минус бесконечности, то будет сгенерирована ошибка выхода за пределы области, а в качестве результата будет возвращено NaN. Если x находится вне пределов [-1, 1], то будет сгенерирована ошибка выхода за пределы области, а в качестве результата будет возвращено значение NaN.

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

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

Ошибка области: x находится вне диапазона [-1, 1]
    Значение errno устанавливается в EDOM. Вызывается исключение неправильной плавающей точки (FE_INVALID).

АТРИБУТЫ
Описание терминов данного раздела смотрите в attributes(7).
Интерфейс | Атрибут | Значение
acos(), acosf(), acosl() | Безвредность в нитях | MT-Safe

СООТВЕТСТВИЕ СТАНДАРТАМ
C99, POSIX.1-2001, POSIX.1-2008. Вариант, возвращающий значение типа double, также соответствует SVr4, 4.3BSD, C89.

СМОТРИТЕ ТАКЖЕ
asin(3), atan(3), atan2(3), cacos(3), cos(3), sin(3), tan(3)