<QtMath> - Generic Math Functions

<QtMath> 헤더 파일은 다양한 수학 함수를 제공합니다. 더 보기...

Header: #include <QtMath>

함수

auto qAcos(T v)
auto qAsin(T v)
auto qAtan2(T1 y, T2 x)
auto qAtan(T v)
int qCeil(T v)
auto qCos(T v)
double qDegreesToRadians(double degrees)
float qDegreesToRadians(float degrees)
(since 6.0) long double qDegreesToRadians(long double degrees)
auto qExp(T v)
auto qFabs(T v)
int qFloor(T v)
(since 6.1) auto qHypot(F first, Fs... rest)
(since 6.1) auto qHypot(Tx x, Ty y)
(since 6.1) auto qHypot(Tx x, Ty y, Tz z)
auto qLn(T v)
quint32 qNextPowerOfTwo(quint32 value)
quint64 qNextPowerOfTwo(quint64 value)
quint32 qNextPowerOfTwo(qint32 value)
quint64 qNextPowerOfTwo(qint64 value)
auto qPow(T1 x, T2 y)
double qRadiansToDegrees(double radians)
float qRadiansToDegrees(float radians)
(since 6.0) long double qRadiansToDegrees(long double radians)
auto qSin(T v)
auto qSqrt(T v)
auto qTan(T v)

상세 설명

이 함수들은 C나 표준 템플릿 라이브러리(STL)에서 제공되지 않는 기본적인 수학 연산을 위한 편의 정의입니다.

또한 이 헤더 파일은 POSIX에서 지정되었으나 C++ 표준에는 포함되지 않아(따라서 일부 플랫폼의 <math.h>에는 없는) 일부 상수들이 정의되도록 보장합니다:

상수설명
M_E자연 로그의 밑, e = exp(1)
M_LOG2Ee의 2진 로그
M_LOG10Ee의 10진 로그
M_LN22의 자연 로그
M_LN1010의 자연 로그
M_PI원의 둘레와 지름의 비율, π
M_PI_2M_PI의 절반, π / 2
M_PI_4M_PI의 1/4, π / 4
M_1_PIM_PI의 역수, 1 / π
M_2_PIM_PI의 역수의 두 배, 2 / π
M_2_SQRTPI2를 π의 제곱근으로 나눈 값, 2 / √π
M_SQRT22의 제곱근, √2
M_SQRT1_22의 제곱근의 절반, 1 / √2

함수 설명서

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)

이 함수는 float 형식의 각도( degrees )를 라디안으로 변환합니다.

예시:

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

qRadiansToDegrees()함수도 참조하십시오 .

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

이 함수는 double 형식의 각도( degrees )를 라디안으로 변환합니다.

이 함수는 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 의 하한값을 반환합니다.

바닥값(floor)은 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 )를 도(degrees)로 변환합니다.

예시:

double radians = M_PI;
double degrees = qRadiansToDegrees(radians);

qDegreesToRadians()함수도 참조하십시오 .

[constexpr] float qRadiansToDegrees(float radians)

이 함수는 float 형식의 각도( radians )를 도(degrees)로 변환합니다.

예시:

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

qDegreesToRadians()함수도 참조하십시오 .

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

이 함수는 더블(double) 형식의 각도( radians )를 도(degrees) 단위로 변환합니다.

이 함수는 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()도 참조하십시오 .

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.