std:: log10, std:: log10f, std:: log10l
|
Определено в заголовочном файле
<cmath>
|
||
| (1) | ||
|
float
log10
(
float
num
)
;
double
log10
(
double
num
)
;
|
(до C++23) | |
|
/*floating-point-type*/
log10 ( /*floating-point-type*/ num ) ; |
(начиная с C++23)
(constexpr начиная с C++26) |
|
|
float
log10f
(
float
num
)
;
|
(2) |
(начиная с C++11)
(constexpr начиная с C++26) |
|
long
double
log10l
(
long
double
num
)
;
|
(3) |
(начиная с C++11)
(constexpr начиная с C++26) |
|
SIMD перегрузка
(начиная с C++26)
|
||
|
Определено в заголовочном файле
<simd>
|
||
|
template
<
/*math-floating-point*/
V
>
constexpr
/*deduced-simd-t*/
<
V
>
|
(S) | (начиная с C++26) |
|
Дополнительные перегрузки
(начиная с C++11)
|
||
|
Определено в заголовочном файле
<cmath>
|
||
|
template
<
class
Integer
>
double log10 ( Integer num ) ; |
(A) | (constexpr начиная с C++26) |
std::log10
для всех типов с плавающей точкой без cv-квалификаторов в качестве типа параметра.
(since C++23)
|
S)
Перегрузка SIMD выполняет поэлементное вычисление
std::log10
для
v_num
.
|
(since C++26) |
|
A)
Дополнительные перегрузки предоставляются для всех целочисленных типов, которые трактуются как
double
.
|
(since C++11) |
Содержание |
Параметры
| num | - | значение с плавающей точкой или целочисленное значение |
Возвращаемое значение
Если ошибок не возникает, возвращается десятичный логарифм num ( log 10 (num) или lg(num) ).
Если происходит ошибка области определения, возвращается значение, определяемое реализацией (NaN, если поддерживается).
Если возникает ошибка полюса,
-HUGE_VAL
,
-HUGE_VALF
, или
-HUGE_VALL
возвращается.
Обработка ошибок
Ошибки сообщаются, как указано в math_errhandling .
Ошибка домена возникает, если num меньше нуля.
Ошибка полюса может возникнуть, если num равен нулю.
Если реализация поддерживает арифметику с плавающей запятой IEEE (IEC 60559),
- Если аргумент равен ±0, возвращается -∞ и FE_DIVBYZERO устанавливается.
- Если аргумент равен 1, возвращается +0.
- Если аргумент отрицательный, возвращается NaN и FE_INVALID устанавливается.
- Если аргумент равен +∞, возвращается +∞.
- Если аргумент равен NaN, возвращается NaN.
Примечания
Дополнительные перегрузки не обязаны быть предоставлены в точности как (A) . Они лишь должны быть достаточными для обеспечения того, чтобы для их аргумента num целочисленного типа, std :: log10 ( num ) имел тот же эффект, что и std :: log10 ( static_cast < double > ( num ) ) .
Пример
#include <cerrno> #include <cfenv> #include <cmath> #include <cstring> #include <iostream> // #pragma STDC FENV_ACCESS ON int main() { std::cout << "log10(1000) = " << std::log10(1000) << '\n' << "log10(0.001) = " << std::log10(0.001) << '\n' << "base-5 logarithm of 125 = " << std::log10(125) / std::log10(5) << '\n'; // special values std::cout << "log10(1) = " << std::log10(1) << '\n' << "log10(+Inf) = " << std::log10(INFINITY) << '\n'; // error handling errno = 0; std::feclearexcept(FE_ALL_EXCEPT); std::cout << "log10(0) = " << std::log10(0) << '\n'; if (errno == ERANGE) std::cout << " errno == ERANGE: " << std::strerror(errno) << '\n'; if (std::fetestexcept(FE_DIVBYZERO)) std::cout << " FE_DIVBYZERO raised\n"; }
Возможный вывод:
log10(1000) = 3
log10(0.001) = -3
base-5 logarithm of 125 = 3
log10(1) = 0
log10(+Inf) = inf
log10(0) = -inf
errno == ERANGE: Numerical result out of range
FE_DIVBYZERO raised
Смотрите также
|
(C++11)
(C++11)
|
вычисляет натуральный логарифм (по основанию
e
) (
ln(x)
)
(функция) |
|
(C++11)
(C++11)
(C++11)
|
логарифм по основанию
2
от заданного числа (
log
2
(x)
)
(функция) |
|
(C++11)
(C++11)
(C++11)
|
натуральный логарифм (по основанию
e
) от
1
плюс заданное число (
ln(1+x)
)
(функция) |
|
комплексный десятичный логарифм с разрезами ветвей вдоль отрицательной вещественной оси
(шаблон функции) |
|
|
применяет функцию
std::log10
к каждому элементу valarray
(шаблон функции) |
|
|
Документация C
для
log10
|
|