Computes complex natural (base e) logarithm of a complex value z with a branch cut along the negative real axis.
[edit] Parameters [edit] Return valueIf no errors occur, the complex natural logarithm of z is returned, in the range of a strip in the interval [âiÏ, +iÏ] along the imaginary axis and mathematically unbounded along the real axis.
[edit] Error handling and special valuesErrors are reported consistent with math_errhandling.
If the implementation supports IEEE floating-point arithmetic,
(-0,+0)
, the result is (-â,Ï)
and FE_DIVBYZERO is raised(+0,+0)
, the result is (-â,+0)
and FE_DIVBYZERO is raised(x,+â)
(for any finite x), the result is (+â,Ï/2)
(x,NaN)
(for any finite x), the result is (NaN,NaN)
and FE_INVALID may be raised(-â,y)
(for any finite positive y), the result is (+â,Ï)
(+â,y)
(for any finite positive y), the result is (+â,+0)
(-â,+â)
, the result is (+â,3Ï/4)
(+â,+â)
, the result is (+â,Ï/4)
(屉,NaN)
, the result is (+â,NaN)
(NaN,y)
(for any finite y), the result is (NaN,NaN)
and FE_INVALID may be raised(NaN,+â)
, the result is (+â,NaN)
(NaN,NaN)
, the result is (NaN,NaN)
The natural logarithm of a complex number z with polar coordinate components (r,θ) equals ln r + i(θ+2nÏ), with the principal value ln r + iθ.
The semantics of this function are intended to be consistent with the C function clog.
[edit] Example#include <cmath> #include <complex> #include <iostream> int main() { std::complex<double> z {0.0, 1.0}; // r = 1, θ = pi / 2 std::cout << "2 * log" << z << " = " << 2.0 * std::log(z) << '\n'; std::complex<double> z2 {sqrt(2.0) / 2, sqrt(2.0) / 2}; // r = 1, θ = pi / 4 std::cout << "4 * log" << z2 << " = " << 4.0 * std::log(z2) << '\n'; std::complex<double> z3 {-1.0, 0.0}; // r = 1, θ = pi std::cout << "log" << z3 << " = " << std::log(z3) << '\n'; std::complex<double> z4 {-1.0, -0.0}; // the other side of the cut std::cout << "log" << z4 << " (the other side of the cut) = " << std::log(z4) << '\n'; }
Possible output:
2 * log(0,1) = (0,3.14159) 4 * log(0.707107,0.707107) = (0,3.14159) log(-1,0) = (0,3.14159) log(-1,-0) (the other side of the cut) = (0,-3.14159)[edit] Defect reports
The following behavior-changing defect reports were applied retroactively to previously published C++ standards.
DR Applied to Behavior as published Correct behavior LWG 2597 C++98 specification mishandles signed zero imaginary parts erroneous requirement removed [edit] See alsoRetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4