<QtMath> - Generic Math Functions

函数文档

template <typename T> auto qAcos(T v)

以弧度为单位返回v 的余弦值。余弦是余弦的逆运算。

另请参阅 qAtan()、qAsin() 和qCos()。

template <typename T> auto qAsin(T v)

以弧度为单位返回v 的弧正值。弧正弦是正弦的逆运算。

另请参阅 qSin()、qAtan() 和qAcos()。

template <typename T1, typename T2> auto qAtan2(T1 y, T2 x)

返回由坐标y 和x 指定的点的反正切值。此函数将返回该点的角度（参数）。

另请参见 qAtan() 和qHypot()。

template <typename T> auto qAtan(T v)

以弧度为单位返回v 的反正切值。反正切是正切的逆运算。

另请参阅 qTan()、qAcos() 和qAsin()。

template <typename T> int qCeil(T v)

返回值v 的上限。

上限是不小于v 的最小整数。例如，如果v 是 41.2，那么上限就是 42。

另请参阅 qFloor() 。

template <typename T> auto qCos(T v)

以弧度为单位返回角度v 的余弦值。

另请参阅 qSin() 和qTan()。

[constexpr] double qDegreesToRadians(double degrees)

该函数将degrees 的双倍值转换为弧度值。

举例说明：

double degrees = 180.0
double radians = qDegreesToRadians(degrees)

另请参见 qRadiansToDegrees().

[constexpr] float qDegreesToRadians(float degrees)

该函数将degrees 的浮点数转换为弧度。

示例：

float degrees = 180.0f
float radians = qDegreesToRadians(degrees)

另请参见 qRadiansToDegrees().

[constexpr, since 6.0] long double qDegreesToRadians(long double degrees)

该函数将degrees 中的 double 转换为弧度。

此函数在 Qt 6.0 中引入。

另请参见 qRadiansToDegrees()。

template <typename T> auto qExp(T v)

返回e 到v 的幂的指数函数。

另请参见 qLn().

template <typename T> auto qFabs(T v)

返回v 的绝对值。

template <typename T> int qFloor(T v)

返回值v 的下限。

下限是不大于v 的最大整数。例如，如果v 是 41.2，那么下限就是 41。

另请参阅 qCeil() 。

[since 6.1] template <typename F, typename... Fs> auto qHypot(F first, Fs... rest)

返回任意维数的原点距离

这与 std::hypot() 支持的二参数和三参数形式相同，但可以传递任意多的数字参数。使用first 和每个rest 作为坐标，执行相当于将每个坐标平方、求和并返回平方根的计算，但要尽量避免下溢和溢出。

此函数在 Qt 6.1 中引入。

另请参见 qSqrt()。

[since 6.1] template <typename Tx, typename Ty> auto qHypot(Tx x, Ty y)

这是一个重载函数。

返回点 (x,y) 与原点（0, 0）的距离。

这是qSqrt(x * x + y * y)，经过优化。特别是可以避免下溢和溢出。

接受任何混合数字类型，返回与 std::hypot() 相同的浮点类型。如果任一参数为无限，结果也是无限；否则，如果任一参数为 NaN，结果也是 NaN。

此函数在 Qt 6.1 中引入。

另请参阅 qSqrt() 和qAtan2()。

[since 6.1] template <typename Tx, typename Ty, typename Tz> auto qHypot(Tx x, Ty y, Tz z)

这是一个重载函数。

返回点 (x, y, z) 与原点 (0, 0, 0) 的距离。

返回值为qSqrt(x * x + y * y + z * z)，并在支持的情况下进行了优化。特别是可以避免下溢和溢出。

接受任何混合数字类型，返回与 std::hypot() 相同的浮点类型。如果任何参数是无限的，结果也是无限的；否则，如果任何参数是 NaN，结果也是 NaN。

此函数在 Qt 6.1 中引入。

另请参见 qSqrt()。

template <typename T> auto qLn(T v)

返回v 的自然对数。自然对数以 e 为底。

另请参见 qExp().

[constexpr] quint32 qNextPowerOfTwo(quint32 value)

该函数返回最接近的大于value 的 2 的幂。对于 0，它返回 1；对于大于或等于 2^31 的值，结果未定义。

[constexpr] quint32 qNextPowerOfTwo(qint32 value)

这是一个重载函数。

该函数返回最接近的大于value 的 2 的幂次。对于负值，结果未定义。

[constexpr] quint64 qNextPowerOfTwo(qint64 value)

这是一个重载函数。

该函数返回最接近的大于value 的 2 的幂次。对于负值，结果未定义。

[constexpr] quint64 qNextPowerOfTwo(quint64 value)

该函数返回最接近的大于value 的 2 的幂次。对于 0，它返回 1；对于大于或等于 2^63 的值，结果未定义。

template <typename T1, typename T2> auto qPow(T1 x, T2 y)

返回x 的值乘以y 的幂。也就是说，x 是基数，y 是指数。

另请参阅 qSqrt() 。

[constexpr] double qRadiansToDegrees(double radians)

此函数将radians 的 double 转换为度。

示例：

double radians = M_PI
double degrees = qRadiansToDegrees(radians)

另请参见 qDegreesToRadians().

[constexpr] float qRadiansToDegrees(float radians)

该函数将radians 的浮点数转换成度数。

示例：

float radians = float(M_PI)
float degrees = qRadiansToDegrees(radians)

另请参见 qDegreesToRadians().

[constexpr, since 6.0] long double qRadiansToDegrees(long double radians)

该函数将radians 中的 double 转换为度。

此函数在 Qt 6.0 中引入。

另请参阅 qDegreesToRadians()。

template <typename T> auto qSin(T v)

以弧度为单位返回角度v 的正弦值。

另请参阅 qCos() 和qTan()。

template <typename T> auto qSqrt(T v)

返回v 的平方根。如果v 是负数，函数将返回 NaN。

另请参阅 qPow() 和qHypot()。

template <typename T> auto qTan(T v)

以弧度为单位返回角度v 的正切值。

另请参阅 qSin() 和qCos()。