Поделиться через

log1p, , log1pflog1pl

  • Статья

Вычисляет натуральный логарифм суммы указанного значения и 1.

Синтаксис

double log1p(double x);
float log1pf(float x);
long double log1pl(long double x);

#define log1p(X) // Requires C11 or higher

float log1p(float x); //C++ only
long double log1p(long double x); //C++ only

Параметры

x
Аргумент с плавающей запятой.

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

В случае успешного выполнения возвращает естественный (base-e) журнал (x+ 1).

В случае неудачи может возвращать одно из следующих значений:

Входные данные Результат Исключение SEH errno
+INF +INF
Денормализованные числа Так же, как и для входных данных UNDERFLOW
±0 Так же, как и для входных данных
-1 -INF DIVBYZERO ERANGE
< -1 Не число INVALID EDOM
-INF Не число INVALID EDOM
±SNaN Так же, как и для входных данных INVALID
±QNaN, неопределенный Так же, как и для входных данных

errno имеет значение ERANGE, если x = –1. Если errno значение равно EDOM x< -1.

Замечания

Функции log1p могут быть более точными, чем при использовании log(x + 1) x почти 0.

Поскольку C++ допускает перегрузки, можно вызывать перегрузки функции log1p, принимающие и возвращающие типы float и long double. В программе C, если вы не используете <макрос tgmath.h> для вызова этой функции, log1p всегда принимает и возвращает значение double.

При использовании <tgmath.h> log1p() макроса тип аргумента определяет, какая версия функции выбрана. Дополнительные сведения см . в разделе "Математика с универсальным типом".

Где x является естественное число, эта функция возвращает базовый логарифм x + 1.

По умолчанию глобальное состояние этой функции ограничивается приложением. Чтобы изменить это поведение, см . статью "Глобальное состояние" в CRT.

Требования

Function Заголовок C Заголовок C++
log1p, , log1pflog1pl <math.h> <cmath>
log1pМакрос <tgmath.h>

Дополнительные сведения о совместимости см. в разделе Совместимость.

См. также

Справочник по алфавитной функции
log2, , log2flog2l
log, , logflog10log10f