std:: log, std:: logf, std:: logl
|
헤더 파일에 정의됨
<cmath>
|
||
| (1) | ||
|
float
log
(
float
num
)
;
double
log
(
double
num
)
;
|
(C++23 이전) | |
|
/*floating-point-type*/
log ( /*floating-point-type*/ num ) ; |
(C++23 이후)
(C++26부터 constexpr) |
|
|
float
logf
(
float
num
)
;
|
(2) |
(C++11 이후)
(C++26부터 constexpr) |
|
long
double
logl
(
long
double
num
)
;
|
(3) |
(C++11 이후)
(C++26부터 constexpr) |
|
SIMD 오버로드
(C++26 이후)
|
||
|
헤더 파일에 정의됨
<simd>
|
||
|
template
<
/*math-floating-point*/
V
>
constexpr
/*deduced-simd-t*/
<
V
>
|
(S) | (C++26 이후) |
|
추가 오버로드
(C++11 이후)
|
||
|
헤더 파일에 정의됨
<cmath>
|
||
|
template
<
class
Integer
>
double log ( Integer num ) ; |
(A) | (C++26부터 constexpr) |
std::log
의 오버로드를 제공합니다.
(C++23부터)
|
S)
SIMD 오버로드는
v_num
에 대해 요소별(element-wise)
std::log
연산을 수행합니다.
|
(C++26부터) |
|
A)
모든 정수 타입에 대해 추가 오버로드가 제공되며, 이들은
double
로 처리됩니다.
|
(since C++11) |
목차 |
매개변수
| num | - | 부동 소수점 또는 정수 값 |
반환값
오류가 발생하지 않으면, e 를 밑으로 하는 자연 로그 num 의 값( ln(num) 또는 log e (num) )이 반환됩니다.
도메인 오류가 발생하면 구현에서 정의한 값이 반환됩니다(NaN을 지원하는 경우 해당 값).
극점 오류가 발생하면,
-HUGE_VAL
,
-HUGE_VALF
, 또는
-HUGE_VALL
가 반환됩니다.
오류 처리
오류는 math_errhandling 에 명시된 대로 보고됩니다.
도메인 오류는 num 이 0보다 작을 때 발생합니다.
num 이 0인 경우 극점 오류가 발생할 수 있습니다.
구현이 IEEE 부동 소수점 연산(IEC 60559)을 지원하는 경우,
- 인자가 ±0인 경우, -∞가 반환되고 FE_DIVBYZERO 가 발생합니다.
- 인자가 1인 경우, +0이 반환됩니다.
- 인자가 음수인 경우, NaN이 반환되고 FE_INVALID 가 발생합니다.
- 인자가 +∞인 경우, +∞가 반환됩니다.
- 인자가 NaN인 경우, NaN이 반환됩니다.
참고 사항
추가 오버로드는 반드시 (A) 와 정확히 동일하게 제공될 필요는 없습니다. 정수 타입의 인수 num 에 대해, std :: log ( num ) 가 std :: log ( static_cast < double > ( num ) ) 와 동일한 효과를 가지도록 보장하기에 충분하기만 하면 됩니다.
예제
#include <cerrno> #include <cfenv> #include <cmath> #include <cstring> #include <iostream> // #pragma STDC FENV_ACCESS ON int main() { std::cout << "log(1) = " << std::log(1) << '\n' << "base-5 logarithm of 125 = " << std::log(125) / std::log(5) << '\n'; // special values std::cout << "log(1) = " << std::log(1) << '\n' << "log(+Inf) = " << std::log(INFINITY) << '\n'; // error handling 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
base-5 logarithm of 125 = 3
log(1) = 0
log(+Inf) = inf
log(0) = -inf
errno == ERANGE: Numerical result out of range
FE_DIVBYZERO raised
참고 항목
|
(C++11)
(C++11)
|
상용(밑수
10
) 로그를 계산함 (
log
10
(x)
)
(함수) |
|
(C++11)
(C++11)
(C++11)
|
주어진 숫자의 밑수
2
로그 (
log
2
(x)
)
(함수) |
|
(C++11)
(C++11)
(C++11)
|
주어진 숫자에 1을 더한 값의 자연 로그(밑수
e
) (
ln(1+x)
)
(함수) |
|
(C++11)
(C++11)
|
주어진 거듭제곱으로 올린
e
값을 반환함 (
e
x
)
(함수) |
|
음의 실수축을 따라 가지 절단(branch cut)이 있는 복소수 자연 로그
(함수 템플릿) |
|
|
함수
std::log
를 valarray의 각 요소에 적용함
(함수 템플릿) |
|
|
C 문서
for
log
|
|