<QtMath> - 通用数学函数

函数文档

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] float qDegreesToRadians(float degrees)

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

示例

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

另请参阅qRadiansToDegrees。

[constexpr] double qDegreesToRadians(double degrees)

此函数将双精度浮点数degrees转换为弧度。

示例

double degrees = 180.0
double radians = qDegreesToRadians(degrees)

另请参阅qRadiansToDegrees。

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

此函数将双精度浮点数degrees转换为弧度。

此函数是在Qt 6.0中引入的。

另请参阅qRadiansToDegrees。

template <typename T> auto qExp(T v)

返回e的指数函数，其幂为 v.

另请参阅qLn().

返回 v的绝对值。

返回值 v的整数部分。

整数部分是小于或等于 v的最大整数。例如，如果 v是41.2，则整数部分是41。

另请参阅qCeil().

[since 6.1]

这是一个重载函数。

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

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

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

该函数在Qt 6.1中引入。

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

[since 6.1]

这是一个重载函数。

返回（x，y，z）从原点（0，0，0）的距离。

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

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

该函数在Qt 6.1中引入。

另请参阅qSqrt().

[since 6.1]

返回原点在任意多个维度上的距离

这与两个参数和三个参数的形式类似，由std::hypot()支持，但你可以传递给它多少数字参数就使用多少。使用 first以及 rest中的每一个作为坐标，执行类似于对每个坐标进行平方、求和并返回平方根的计算，只是尽量避免下溢和溢出。

该函数在Qt 6.1中引入。

另请参阅qSqrt().

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

另请参阅qExp().

[constexpr] quint32 qNextPowerOfTwo(quint32 value)

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

[ constexpr ] quint32 qNextPowerOfTwo(qint32 value)

这是一个重载函数。

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

[ constexpr ] quint64 qNextPowerOfTwo(quint64 value)

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

[ constexpr ] quint64 qNextPowerOfTwo(qint64 value)

这是一个重载函数。

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

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

返回 x 的 y 次幂的值。即 x 是底数，y 是指数。

另请参阅qSqrt().

[ constexpr ] float qRadiansToDegrees(float radians)

此函数将 radians 中的浮点数值转换为度。

示例

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

另请参阅qDegreesToRadians().

[ constexpr ] double qRadiansToDegrees(double radians)

此函数将 radians 中的双精度数值转换为度。

示例

double radians = M_PI
double degrees = qRadiansToDegrees(radians)

另请参阅qDegreesToRadians().

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

此函数将 radians 中的双精度数值转换为度。

此函数是在Qt 6.0中引入的。

另请参阅qDegreesToRadians().

模板 <typename T> auto qSin(T v)

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

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

模板 <typename T> auto qSqrt(T v)

返回 v 的平方根。当 v 为负数时，此函数返回 NaN。

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

模板 <typename T> auto qTan(T v)

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

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