<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] quint64 qNextPowerOfTwo(quint64 value)

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

[constexpr] quint32 qNextPowerOfTwo(qint32 value)

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

[constexpr] quint64 qNextPowerOfTwo(qint64 value)

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

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

返回x 的y 次幂。也就是说，x 是底数，y 是指数。

另请参阅 qSqrt()。

[constexpr] double qRadiansToDegrees(double radians)

该函数将双精度格拉德角（radians ）转换为度。

示例：

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 转换为度。

该函数在 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()。