logf - функция вычисления натурального логарифма
logf(3)
функция вычисления натурального логарифма
Other Alias
log, logl
ОБЗОР
#include <math.h>
double log(double x);
float logf(float x);
long double logl(long double x);
Компонуется при указании параметра -lm.
Требования макроса тестирования свойств для glibc
(см. feature_test_macros(7)):
logf(), logl():
_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE >= 600 || _ISOC99_SOURCE
|| _POSIX_C_SOURCE >= 200112L;
или
cc -std=c99
ОПИСАНИЕ
Данные функции возвращают натуральный логарифм от
x.
ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ
При успешном выполнении данные функции возвращают натуральный логарифм от
x.
Если x равно NaN, будет возвращено NaN.
Если x равно 1, результат будет +0.
Если x стремится к плюс бесконечности, то будет возвращена плюс
бесконечность.
Если x равно нулю, возникнет ошибка особой точки, и функция вернет
-HUGE_VAL, -HUGE_VALF или -HUGE_VALL, соответственно.
Если x отрицательно (включая минус бесконечность), то будет сгенерирована
ошибка области, и будет возвращено NaN (Not a Number, не число).
ОШИБКИ
Смотрите
math_error(7), чтобы определить, какие ошибки могут возникать
при вызове этих функций.
Могут возникать следующие ошибки:
Ошибка области:
x является отрицательным
errno устанавливается в
EDOM. Вызывается исключение неправильной
плавающей точки (
FE_INVALID).
Ошибка особой точки:
x равен нулю
errno устанавливается в
ERANGE. Возникает исключение деления плавающей
точки на ноль (
FE_DIVBYZERO).
АТРИБУТЫ
Описание терминов данного раздела смотрите в
attributes(7).
Интерфейс Атрибут Значение
log(),
logf(),
logl()
безвредность в потоках: безвредно (MT-Safe)
СООТВЕТСТВИЕ СТАНДАРТАМ
C99, POSIX.1-2001, POSIX.1-2008.
Вариант, возвращающий значение типа double, также соответствует SVr4,
4.3BSD, C89.
ДЕФЕКТЫ
В версии glibc 2.5 и ниже значение
log() от NaN ошибочно производила
исключение неправильной плавающей запятой (
FE_INVALID).
