本模块提供了一些适用于复数的数学函数。 本模块中的函数接受整数、浮点数或复数作为参数。 它们也接受任意具有 __complex__() 或 __float__() 方法的 Python 对象：这些方法分别用于将对象转换为复数或浮点数，然后再将函数应用于转换后的结果。

备注

对于涉及分支切割的函数，我们会有确定如何在切割本身上定义这些函数的问题。 根据 Kahan 的论文 "Branch cuts for complex elementary functions"，以及 C99 的附录 G 和之后的 C 标准，我们使用零符号来区别分支切割的一侧和另一侧：对于沿实轴（一部分）的分支切割我们要看虚部的符号，而对于沿虚轴的分支切割我们则要看实部的符号。

例如，cmath.sqrt() 函数有一个沿着负实轴的分支切割。 参数 complex(-2.0, -0.0) 会被当作位于切支切割的 下方 来处理，因而将给出一个负虚轴上的结果。

但是参数 complex(-2.0, 0.0) 则会被当作是位于支割线的上方来处理:

Python 复数 z 是使用 直角 或 笛卡尔 坐标在内部存储的。 这完全取决于其 实部 z.real 及其 虚部 z.imag 的值。

极坐标 提供了另一种复数的表示方法。在极坐标中，一个复数 z 由模量 r 和相位角 phi 来定义。模量 r 是从 z 到坐标原点的距离，而相位角 phi 是以弧度为单位的，逆时针的，从正X轴到连接原点和 z 的线段间夹角的角度。

下面的函数可用于原生直角坐标与极坐标的相互转换。

将 x 的相位 (或称 x 的 参数) 作为一个浮点数返回。 phase(x) 等价于 math.atan2(x.imag, x.real)。 结果将位于 [-π, π] 范围内，且此操作的支割线将位于负实轴上。 结果的符号将与 x.imag 的符号相同，即使 x.imag 的值为零:

备注

一个复数 x 的模数（绝对值）可以通过内置函数 abs() 计算。没有单独的 cmath 模块函数用于这个操作。

在极坐标中返回 x 的表达方式。返回一个数对 (r, phi)，r 是 x 的模数，phi 是 x 的相位角。 polar(x) 相当于 (abs(x), phase(x))。

使用极坐标形式 r 和 phi 返回复数 x 的值。 相当于 complex(r * math.cos(phi), r * math.sin(phi))。

返回 e 的 x 次方，e 是自然对数的底数。

返回 x 的以 base 为底的对数。 如果没有指定 base，则返回 x 的自然对数。 存在一条支割线，即沿着负实轴从 0 到 -∞。

返回底数为 10 的 x 的对数。它具有与 log() 相同的支割线。

返回 x 的平方根。 它具有与 log() 相同的支割线。

返回 x 的反余弦。 存在两条支割线：一条沿着实轴从 1 到 ∞。 另一条沿着实轴从 -1 向左延伸到 -∞。

返回 x 的反正弦。它与 acos() 有相同的支割线。

返回 x 的反正切。 存在两条支割线：一条沿着虚轴从 1j 延伸到 ∞j。 另一条沿着虚轴从 -1j 延伸到 -∞j。

返回 x 的余弦。

返回 x 的正弦。

返回 x 的正切。

返回 x 的反双曲余弦。 存在一条支割线，沿着实轴从 1 向左延伸到 -∞。

返回 x 的反双曲正弦。 存在两条支割线：一条沿着虚轴从 1j 延伸到 ∞j。 另一条沿着虚轴从 -1j 延伸到 -∞j。

返回 x 反双曲正切。 存在两条支割线：一条沿着实轴从 1 延伸到 ∞。 另一条沿着实轴从 -1 延伸到 -∞。

返回 x 的双曲余弦值。

返回 x 的双曲正弦值。

返回 x 的双曲正切值。

如果 x 的实部和虚部都是有限的，则返回 True，否则返回 False。

Added in version 3.2.

如果 x 的实部或者虚部是无穷大的，则返回 True，否则返回 False。

如果 x 的实部或者虚部是 NaN，则返回 True ，否则返回 False。

若 a 和 b 的值比较接近则返回 True，否则返回 False。

根据给定的绝对和相对容差确定两个值是否被认为是接近的。

rel_tol 是相对容差 —— 它是 a 和 b 之间允许的最大差值，相对于 a 或 b 的较大绝对值。例如，要设置5％的容差，请传递 rel_tol=0.05 。默认容差为 1e-09，确保两个值在大约9位十进制数字内相同。 rel_tol 必须大于零。

abs_tol 是最小绝对容差 —— 对于接近零的比较很有用。 abs_tol 必须至少为零。

如果没有错误发生，结果将是： abs(a-b)