std::log

 

C++

Поддержка компилятором

Автономные и размещённые реализации

Язык

Стандартная библиотека

Заголовки стандартной библиотеки

Требования к именованию

Макросы тестирования функциональности (C++20)

Поддержка языка

Библиотека концептов (C++20)

Библиотека метапрограммирования (C++11)

Библиотека диагностики

Библиотека общих утилит

Библиотека строк

Библиотека контейнеров

Библиотека итераторов

Библиотека диапазонов (C++20)

Библиотека алгоритмов

Библиотека численных данных

Библиотека ввода/вывода

Библиотека локализаций

Регулярные выражения (C++11)

Атомарные операции (C++11)

Библиотека поддержки конкуренции (C++11)

Библиотека файловой системы (C++17)

Технические спецификации

Указатель символов

Внешние библиотеки

 

Библиотека числовых данных

Общие математические функции

Специальные математические функции (C++17)

Математические константы (C++20)

Среда с плавающей точкой (C++11)

Комплексные числа

Числовые массивы

Генерация псевдослучайных чисел

Рациональная арифметика времени компиляции (C++11)

Факторные операции

gcd (C++17)

lcm (C++17)

Интерполяции

midpoint (C++20)

lerp (C++20)

Общие числовые операции

iota (C++11)

ranges::iota (C++23)

accumulate

inner_product

adjacent_difference

partial_sum

reduce (C++17)

transform_reduce (C++17)

inclusive_scan (C++17)

exclusive_scan (C++17)

transform_inclusive_scan (C++17)

transform_exclusive_scan (C++17)

Операции с битами

bit_cast (C++20)

byteswap (C++23)

has_single_bit (C++20)

bit_ceil (C++20)

bit_floor (C++20)

bit_width (C++20)

rotl (C++20)

rotr (C++20)

countl_zero (C++20)

countl_one (C++20)

countr_zero (C++20)

countr_one (C++20)

popcount (C++20)

endian (C++20)

 

Общие математические функции

Функции
Основные операции
abs(int)labsllabsimaxabs (C++11) abs(float)fabs divldivlldivimaxdiv (C++11) fmod	remainder (C++11) remquo (C++11) fma (C++11) fmax (C++11) fmin (C++11) fdim (C++11) nannanfnanl (C++11)(C++11)(C++11)
Экспоненциальные функции
exp exp2 (C++11) expm1 (C++11)	log log10 log1p (C++11) log2 (C++11)
Степенные функции
sqrt cbrt (C++11)	hypot (C++11) pow
Тригонометрические и гиперболические функции
sin cos tan asin acos atan atan2	sinh cosh tanh asinh (C++11) acosh (C++11) atanh (C++11)

Ошибка и гамма функции
erf (C++11) erfc (C++11)	lgamma (C++11) tgamma (C++11)
Операции целочисленного округления с плавающей запятой
ceil floor roundlroundllround (C++11)(C++11)(C++11)	trunc (C++11) nearbyint (C++11) rintlrintllrint (C++11)(C++11)(C++11)
Функции манипуляции с плавающей запятой
ldexp scalbnscalbln (C++11)(C++11) ilogb (C++11) logb (C++11)	frexp modf nextafternexttoward (C++11)(C++11) copysign (C++11)
Классификация/Сравнение
fpclassify (C++11) isfinite (C++11) isinf (C++11) isnan (C++11) isnormal (C++11) signbit (C++11)	isgreater (C++11) isgreaterequal (C++11) isless (C++11) islessequal (C++11) islessgreater (C++11) isunordered (C++11)
Макро-константы
HUGE_VALFHUGE_VALHUGE_VALL (C++11)(C++11) INFINITY (C++11) NAN (C++11) math_errhandlingMATH_ERRNOMATH_ERREXCEPT (C++11)	FP_NORMALFP_SUBNORMALFP_ZEROFP_INFINITEFP_NAN (C++11)(C++11)(C++11)(C++11)(C++11)

 

<tbody> </tbody>

Определено в заголовочном файле <cmath>
float log( float arg );	(1)
double log( double arg );	(2)
long double log( long double arg );	(3)
double log( Integral arg );	(4)	(начиная с C++11)

1-3) Вычисляет натуральный (по основанию e) логарифм числа arg.

4) Несколько перегрузок или шаблонов функций принимающих аргумент любого из интегральных типов. Эквивалентно 2) (аргумент приводится к double).

Параметры

arg

—

значение вещественного типа или интегрального типа

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

При отсутствии ошибок, возвращается натуральный (по основанию e) логарифм arg (то есть ln(arg) или log
e(arg)).

При возникновении domain-ошибки, возвращается определяемое реализацией значение (NaN если поддерживается)

При возникновении pole-ошибки, возвращается -HUGE_VAL, -HUGE_VALF или -HUGE_VALL.

Ошибки

Ошибки возникают в соответствии с определением math_errhandling

Domain-ошибка возникает, если arg меньше нуля.

Pole-ошибка возникает, если arg равен нулю.

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

• Если аргумент равен ±0, возвращается -∞ и FE_DIVBYZERO возникает.
• Если аргумент равен 1, возвращается +0
• Если аргумент отрицательный, возращается NaN и FE_INVALID возникает.
• Если аргумент равен +∞, возвращается +∞
• Если аргумент является NaN, возвращается NaN

Пример

Запустить этот код

#include <iostream>
#include <cmath>
#include <cerrno>
#include <cstring>
#include <cfenv>
#pragma STDC FENV_ACCESS ON
int main()
{
    std::cout << "log(1) = " << std::log(1) << '\n'
              << "логарифм 125 по основанию 5 равен " << std::log(125)/std::log(5) << '\n';
    // граничные случаи
    std::cout << "log(1) = " << std::log(1) << '\n'
              << "log(+Inf) = " << std::log(INFINITY) << '\n';
    // обработка ошибок
    errno=0; std::feclearexcept(FE_ALL_EXCEPT);
    std::cout << "log(0) = " << std::log(0) << '\n';
    if(errno == ERANGE)
        std::cout << "    errno == ERANGE: " << std::strerror(errno) << '\n';
    if(std::fetestexcept(FE_DIVBYZERO))
        std::cout << "    FE_DIVBYZERO raised\n";
}

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

log(1) = 0
логарифм 125 по основанию 5 равен 3
log(1) = 0
log(+Inf) = inf
log(0) = -inf
    errno == ERANGE: Numerical result out of range
    FE_DIVBYZERO raised

См. также

log10log10flog10l (C++11)(C++11)	вычисляет общий (с основанием 10) логарифм (\({\small \log_{10}{x} }\)log10(x)) (функция)
log2log2flog2l (C++11)(C++11)(C++11)	логарифм по основанию 2 данного числа (\({\small \log_{2}{x} }\)log2(x)) (функция)
log1plog1pflog1pl (C++11)(C++11)(C++11)	натуральный логарифм (по основанию e) заданного числа плюс 1 (\({\small \ln{(1+x)} }\)ln(1+x)) (функция)
expexpfexpl (C++11)(C++11)	возвращает e в заданной степени (\({\small e^x}\)ex) (функция)
log(std::complex)	комплексный натуральный логарифм с ветвью, обрезанной по отрицательной действительной оси (шаблон функции)
log(std::valarray)	применяет функцию std::log к каждому элементу valarray (шаблон функции)
Документация C по log