<QtMath> - Generic Math Functions

El archivo de cabecera <QtMath> proporciona diversas funciones matemáticas. Más información...

Header: #include <QtMath>

Funciones

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)

Descripción detallada

Estas funciones son, en parte, definiciones de conveniencia para operaciones matemáticas básicas que no están disponibles en C ni en las bibliotecas de plantillas estándar.

El archivo de cabecera también garantiza que se definan algunas constantes especificadas en POSIX, pero que no están presentes en los estándares de C++ (por lo que no aparecen en <math.h> en algunas plataformas):

ConstanteDescripción
M_ELa base de los logaritmos naturales, e = exp(1)
M_LOG2EEl logaritmo en base dos de e
M_LOG10EEl logaritmo en base diez de e
M_LN2El logaritmo natural de dos
M_LN10El logaritmo natural de diez
M_PILa relación entre la circunferencia y el diámetro de un círculo, π
M_PI_2La mitad de M_PI, π / 2
M_PI_4Un cuarto de π, π / 4
M_1_PILa inversa de M_PI, 1 / π
M_2_PIEl doble de la inversa de M_PI, 2 / π
M_2_SQRTPIDos dividido entre la raíz cuadrada de pi, 2 / √π
M_SQRT2La raíz cuadrada de dos, √2
M_SQRT1_2La raíz cuadrada de la mitad, 1 / √2

Documentación de la función

template <typename T> auto qAcos(T v)

Devuelve el arcocoseno de v como un ángulo en radianes. El arcocoseno es la operación inversa del coseno.

Véanse también qAtan(), qAsin() y qCos().

template <typename T> auto qAsin(T v)

Devuelve el arcoseno de v como un ángulo en radianes. El arcoseno es la operación inversa del seno.

Véase también qSin(), qAtan() y qAcos().

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

Devuelve la arctangente de un punto especificado por las coordenadas y y x. Esta función devolverá el ángulo (argumento) de ese punto.

Véanse también qAtan() y qHypot().

template <typename T> auto qAtan(T v)

Devuelve la arcotangente de v como un ángulo en radianes. La arcotangente es la operación inversa de la tangente.

Véanse también qTan(), qAcos() y qAsin().

template <typename T> int qCeil(T v)

Devuelve el techo del valor v.

El techo es el entero más pequeño que no sea menor que v. Por ejemplo, si v es 41,2, entonces el techo es 42.

Véase también qFloor().

template <typename T> auto qCos(T v)

Devuelve el coseno de un ángulo v en radianes.

Véase también qSin() y qTan().

[constexpr] double qDegreesToRadians(double degrees)

Esta función convierte el valor « degrees » en grados (doble precisión) a radianes.

Ejemplo:

double degrees = 180.0;
double radians = qDegreesToRadians(degrees);

Véase también qRadiansToDegrees().

[constexpr] float qDegreesToRadians(float degrees)

Esta función convierte el valor « degrees » en «float» a radianes.

Ejemplo:

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

Véase también qRadiansToDegrees().

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

Esta función convierte el valor de « degrees » en «double» a radianes.

Esta función se introdujo en Qt 6.0.

Véase también qRadiansToDegrees().

template <typename T> auto qExp(T v)

Devuelve la función exponencial de e elevado a v.

Véase también qLn().

template <typename T> auto qFabs(T v)

Devuelve el valor absoluto de ` v`.

template <typename T> int qFloor(T v)

Devuelve el valor entero menor del valor v.

La parte entera inferior es el entero más grande que no sea mayor que v. Por ejemplo, si v es 41,2, entonces la parte entera inferior es 41.

Véase también qCeil().

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

Devuelve la distancia desde el origen en un número arbitrario de dimensiones

Funciona igual que las formas de dos y tres argumentos, compatibles con std::hypot(), pero con tantos parámetros numéricos como se desee pasarle. Utiliza first y cada uno de los valores de rest como coordenadas, realizando un cálculo equivalente a elevar cada uno al cuadrado, sumarlos y devolver la raíz cuadrada, salvo que se evitan en la medida de lo posible el desbordamiento por debajo y por encima del rango.

Esta función se introdujo en Qt 6.1.

Véase también qSqrt().

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

Devuelve la distancia de un punto (x, y) al origen (0, 0).

Se trata de qSqrt(x * x + y * y), optimizado. En concreto, permite evitar el desbordamiento por bajo y el desbordamiento por alto.

Acepta cualquier combinación de tipos numéricos y devuelve el mismo tipo de coma flotante que std::hypot(). Si alguno de los parámetros es infinito, el resultado también lo es; de lo contrario, si alguno es un NaN, el resultado también lo es.

Se trata de una función sobrecargada.

Esta función se introdujo en Qt 6.1.

Véase también qSqrt() y qAtan2().

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

Devuelve la distancia de un punto (x, y, z) al origen (0, 0, 0).

Se trata de qSqrt(x * x + y * y + z * z), optimizada cuando sea posible. En concreto, se pueden evitar el desbordamiento por debajo y por encima del rango.

Acepta cualquier combinación de tipos numéricos y devuelve el mismo tipo de punto flotante que std::hypot(). Si algún parámetro es infinito, el resultado también lo es; de lo contrario, si alguno es NaN, el resultado también lo es.

Se trata de una función sobrecargada.

Esta función se introdujo en Qt 6.1.

Véase también ` qSqrt()`.

template <typename T> auto qLn(T v)

Devuelve el logaritmo natural de v. El logaritmo natural tiene base e.

Véase también qExp().

[constexpr] quint32 qNextPowerOfTwo(quint32 value)

Esta función devuelve la potencia de dos más cercana que sea mayor qu value. Para 0, devuelve 1, y para valores mayores o iguales a 2^31, el resultado no está definido.

[constexpr] quint64 qNextPowerOfTwo(quint64 value)

Esta función devuelve la potencia de dos más cercana que sea mayor que value. Para 0, devuelve 1, y para valores mayores o iguales a 2^63, el resultado no está definido.

[constexpr] quint32 qNextPowerOfTwo(qint32 value)

Esta función devuelve la potencia de dos más cercana que sea mayor que value. Para valores negativos, el resultado es indefinido.

Se trata de una función sobrecargada.

[constexpr] quint64 qNextPowerOfTwo(qint64 value)

Esta función devuelve la potencia de dos más cercana que sea mayor que value. Para valores negativos, el resultado es indefinido.

Se trata de una función sobrecargada.

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

Devuelve el valor de x elevado a la potencia de y. Es decir, x es la base y y es el exponente.

Véase también qSqrt().

[constexpr] double qRadiansToDegrees(double radians)

Esta función convierte el valor de « radians » en grados, expresados en formato «double».

Ejemplo:

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

Véase también qDegreesToRadians().

[constexpr] float qRadiansToDegrees(float radians)

Esta función convierte el valor « radians » en «float» a grados.

Ejemplo:

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

Véase también qDegreesToRadians().

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

Esta función convierte la « radians » (en formato «double») en grados.

Esta función se introdujo en Qt 6.0.

Véase también qDegreesToRadians().

template <typename T> auto qSin(T v)

Devuelve el seno del ángulo v en radianes.

Véase también qCos() y qTan().

template <typename T> auto qSqrt(T v)

Devuelve la raíz cuadrada de v. Esta función devuelve un NaN si v es un número negativo.

Véase también qPow() y qHypot().

template <typename T> auto qTan(T v)

Devuelve la tangente de un ángulo v en radianes.

Véase también qSin() y 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.