std::pow(std::complex)

 

C++

編譯器支援

自由（freestanding）與宿主（hosted）

語言

標準庫

標準庫標頭檔案

具名要求

特性測試宏 (C++20)

語言支援庫

概念庫 (C++20)

診斷庫

記憶體管理庫

超程式設計庫 (C++11)

通用工具庫

容器庫

迭代器庫

範圍庫 (C++20)

演算法庫

字串庫

文字處理庫

數值庫

日期和時間庫

輸入/輸出庫

檔案系統庫 (C++17)

併發支援庫 (C++11)

執行控制庫 (C++26)

技術規範

符號索引

外部庫

 

數值庫

常用數學函式
數學特殊函式 (C++17)
數學常數 (C++20)
基本線性代數演算法 (C++26)
資料並行型別 (SIMD) (C++26)
浮點環境 (C++11)
複數
數值陣列 (valarray)
偽隨機數生成
位操作 (C++20)
因子運算
gcd (C++17)	lcm (C++17)
插值
midpoint (C++20)	lerp (C++20)
飽和算術
add_sat (C++26) sub_sat (C++26) saturate_cast (C++26)	mul_sat (C++26) div_sat (C++26)
通用數值運算
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)

 

std::complex

成員函式
complex::complex complex::operator= complex::real complex::imag	complex::operator+=complex::operator-=complex::operator*=complex::operator/=
非成員函式
operator+operator- operator+operator-operator*operator/ operator==operator!= (直到 C++20)   operator<<operator>> get(std::complex) (C++26)	real imag abs arg norm conj proj (C++11) polar operator""ioperator""ifoperator""il (C++14)(C++14)(C++14)
指數函式
log   log10   exp
冪函式
pow   sqrt
三角函式
sin   cos tan asin (C++11) acos (C++11) atan (C++11)
雙曲函式
sinh   cosh tanh asinh (C++11) acosh (C++11) atanh (C++11)
輔助型別
tuple_size<std::complex> (C++26)
tuple_element<std::complex> (C++26)

 

定義於標頭檔案 <complex>
template< class T > std::complex<T> pow( const std::complex<T>& x, int y );	(1)	(C++11 前)
template< class T > std::complex<T> pow( const std::complex<T>& x, const std::complex<T>& y );	(2)
template< class T > std::complex<T> pow( const std::complex<T>& x, const T& y );	(3)
template< class T > std::complex<T> pow( const T& x, const std::complex<T>& y );	(4)
額外過載 (自 C++11 起)
定義於標頭檔案 <complex>
	(A)
template< class T1, class T2 > std::complex</* common-type */>     pow( const std::complex<T1>& x, const std::complex<T2>& y );			(直至 C++23)
template< class T1, class T2 > std::complex<std::common_type_t<T1, T2>>     pow( const std::complex<T1>& x, const std::complex<T2>& y );			(C++23 起)
		(B)
template< class T, class NonComplex > std::complex</* common-type */>     pow( const std::complex<T>& x, const NonComplex& y );				(直至 C++23)
template< class T, class NonComplex > std::complex<std::common_type_t<T, NonComplex>>     pow( const std::complex<T>& x, const NonComplex& y );				(C++23 起)
			(C)
template< class T, class NonComplex > std::complex</* common-type */>     pow( const NonComplex& x, const std::complex<T>& y );					(直至 C++23)
template< class T, class NonComplex > std::complex<std::common_type_t<T, NonComplex>>     pow( const NonComplex& x, const std::complex<T>& y );					(C++23 起)

1-4) 計算複數 x 的複數次冪 y，其中第一個引數沿負實軸有分支割。非複數引數被視為虛部為正零的複數。

A-C) 提供了額外的過載。NonComplex 不是 std::complex 的特化。

(C++11 起)

引數

x	-	底數
y	-	指數

返回值

1-4) 如果沒有發生錯誤，則返回複數冪 xy
。

錯誤和特殊情況的處理方式如同操作由 std::exp(y * std::log(x)) 實現。

std::pow(0, 0) 的結果是實現定義的。

A-C) 同 (2-4)。

註解

過載 (1) 在 C++98 中提供，以匹配 std::pow 的額外過載 (2)。這些過載已透過 LWG 問題 550 的解決方案移除，過載 (1) 已透過 LWG 問題 844 的解決方案移除。

附加的過載不要求完全以 (A-C) 的形式提供。它們只需要足以確保對於其第一個引數 base 和第二個引數 exponent

如果 base 和/或 exponent 的型別為 std::complex<T> 如果 base 和/或 exponent 的型別為 std::complex<long double> 或 long double，則 std::pow(base, exponent) 的效果與 std::pow(std::complex<long double>(base),          std::complex<long double>(exponent)) 相同。 否則，如果 base 和/或 exponent 的型別為 std::complex<double>、double 或整型，則 std::pow(base, exponent) 的效果與 std::pow(std::complex<double>(base),          std::complex<double>(exponent)) 相同。 否則，如果 base 和/或 exponent 的型別為 std::complex<float> 或 float，則 std::pow(base, exponent) 的效果與 std::pow(std::complex<float>(base),          std::complex<float>(exponent)) 相同。

(直至 C++23)

如果一個引數的型別為 std::complex<T1>，而另一個引數的型別為 T2 或 std::complex<T2>，則 std::pow(base, exponent) 的效果與 std::pow(std::complex<std::common_type_t<T1, T2>>(base),          std::complex<std::common_type_t<T1, T2>>(exponent)) 相同。 如果 std::common_type_t<T1, T2> 未定義良好，則程式是病態的。

(C++23 起)

示例

執行此程式碼

#include <complex>
#include <iostream>
 
int main()
{
    std::cout << std::fixed;
 
    std::complex<double> z(1.0, 2.0);
    std::cout << "(1,2)^2 = " << std::pow(z, 2) << '\n';
 
    std::complex<double> z2(-1.0, 0.0); // square root of -1
    std::cout << "-1^0.5 = " << std::pow(z2, 0.5) << '\n';
 
    std::complex<double> z3(-1.0, -0.0); // other side of the cut
    std::cout << "(-1,-0)^0.5 = " << std::pow(z3, 0.5) << '\n';
 
    std::complex<double> i(0.0, 1.0); // i^i = exp(-pi / 2)
    std::cout << "i^i = " << std::pow(i, i) << '\n';
}

輸出

(1,2)^2 = (-3.000000,4.000000)
-1^0.5 = (0.000000,1.000000)
(-1,-0)^0.5 = (0.000000,-1.000000)
i^i = (0.207880,0.000000)

參閱

sqrt(std::complex)	右半平面範圍內的復平方根 (函式模板)
powpowfpowl (C++11)(C++11)	將數字提升到給定冪（\(\small{x^y}\)xy） (函式)
pow(std::valarray)	將函式 std::pow 應用於兩個 valarray 或一個 valarray 和一個值 (函式模板)
C 文件 關於 cpow