En esta página

qfloat16 Class

Ofrece compatibilidad con números de coma flotante de 16 bits. Más información...

Encabezado: #include <QFloat16>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core

qfloat16 Comparaciones

CategoríaTipos comparablesDescripción
parcialqfloat16
parcialfloat, double, long double, qint8, quint8, qint16, quint16, qint32, quint32, long, unsigned long, qint64 y quint64.
partialqint128 y quint128.La comparación con tipos enteros de 128 bits solo se admite si Qt proporciona estos tipos.

Funciones públicas

(since 6.1) qfloat16(Qt::Initialization)
bool isNormal() const
(since 6.12) qfloat16 &operator++()
(since 6.12) qfloat16 operator++(int)
(since 6.12) qfloat16 &operator--()
(since 6.12) qfloat16 operator--(int)
(since 6.11) qfloat16 copysign(qfloat16 x, qfloat16 sign)
void qFloatFromFloat16(float *out, const qfloat16 *in, qsizetype len)
void qFloatToFloat16(qfloat16 *out, const float *in, qsizetype len)
int qFpClassify(qfloat16 val)
bool qFuzzyCompare(qfloat16 p1, qfloat16 p2)
(since 6.5.3) size_t qHash(qfloat16 key, size_t seed = 0)
bool qIsFinite(qfloat16 f)
bool qIsInf(qfloat16 f)
bool qIsNaN(qfloat16 f)
qint64 qRound64(qfloat16 value)
int qRound(qfloat16 value)
(since 6.11) bool signbit(qfloat16 x)
(since 6.12) qfloat16 operator+(qfloat16 a)
QDataStream &operator<<(QDataStream &ds, qfloat16 f)
QDataStream &operator>>(QDataStream &ds, qfloat16 &f)

Descripción detallada

La clase qfloat16 ofrece soporte para datos de punto flotante de media precisión (16 bits). Cumple plenamente con la norma IEEE 754 como tipo de almacenamiento. Esto implica que cualquier operación aritmética sobre una instanci qfloat16 da como resultado que el valor se convierta primero a un float. Esta conversión de y h float se realiza mediante hardware siempre que sea posible, pero en procesadores que no admiten de forma nativa la media precisión, la conversión se lleva a cabo mediante una secuencia de operaciones de tabla de consulta.

qfloat16 debe tratarse como si fuera un tipo POD (plain old data). Por consiguiente, ninguna de las operaciones admitidas requiere una explicación más detallada que la de indicar que admite todos los operadores aritméticos propios de los tipos de punto flotante.

Nota: En x86 y x86-64, para obtener conversiones aceleradas por hardware, debes compilar con F16C o AVX2 habilitados, o utilizar qFloatToFloat16() y qFloatFromFloat16(), que detectarán F16C en tiempo de ejecución.

Documentación de las funciones de miembro

[explicit noexcept, since 6.1] qfloat16::qfloat16(Qt::Initialization)

Crea un qfloat16 sin inicializar el valor.

Esta función se introdujo en Qt 6.1.

[constexpr noexcept] bool qfloat16::isNormal() const

Devuelve « true » si este valor de « qfloat16 » es finito y está en forma normal.

Véase también qFpClassify().

[noexcept, since 6.12] qfloat16 &qfloat16::operator++()

Aumenta este valor en 1 y devuelve una referencia a dicho valor.

Esta función se introdujo en Qt 6.12.

[noexcept, since 6.12] qfloat16 qfloat16::operator++(int)

Incrementa este valor en 1 y devuelve el valor anterior.

Esta función se introdujo en Qt 6.12.

[noexcept, since 6.12] qfloat16 &qfloat16::operator--()

Disminuye previamente este valor en 1 y devuelve una referencia a dicho valor.

Esta función se introdujo en Qt 6.12.

[noexcept, since 6.12] qfloat16 qfloat16::operator--(int)

Disminuye este valor en 1 y devuelve el valor anterior.

Esta función se introdujo en Qt 6.12.

Elementos no miembros relacionados

[noexcept, since 6.11] qfloat16 copysign(qfloat16 x, qfloat16 sign)

Devuelve un qfloat16 con el signo de sign, pero el resto de su valor se toma de x. Equivale a la función std::copysign() para qfloat16.

Esta función se introdujo en Qt 6.11.

Véase también signbit().

[noexcept] void qFloatFromFloat16(float *out, const qfloat16 *in, qsizetype len)

Convierte los valores `qfloat16` de ` len ` ( in ) a `float` y los almacena en ` out`. Tanto ` in ` como ` out ` deben tener entradas asignadas en ` len `.

Esta función es más rápida que convertir los valores uno por uno y realiza una detección F16C en tiempo de ejecución en hardware x86 y x86-64.

[noexcept] void qFloatToFloat16(qfloat16 *out, const float *in, qsizetype len)

Convierte los valores flotantes de « len » de « in » a «qfloat16» y los almacena en « out ». Tanto « in » como « out » deben tener entradas asignadas en « len ».

Esta función es más rápida que convertir los valores uno por uno y realiza una detección de F16C en tiempo de ejecución en hardware x86 y x86-64.

[noexcept] int qFpClassify(qfloat16 val)

Devuelve la clase de punto flotante de val.

[noexcept] bool qFuzzyCompare(qfloat16 p1, qfloat16 p2)

Compara los valores de coma flotante p1 y p2 y devuelve true si se consideran iguales; en caso contrario, devuelve false.

Los dos números se comparan de forma relativa, de modo que cuanto más pequeños son los números, mayor es la precisión.

[noexcept, since 6.5.3] size_t qHash(qfloat16 key, size_t seed = 0)

Devuelve el valor hash de ` key`, utilizando ` seed ` como semilla para el cálculo.

Nota: En las versiones de Qt anteriores a la 6.5, esta operación se realizaba mediante la sobrecarga de `qHash(float)`. En las versiones de Qt 6.5.0 a 6.5.2, esta funcionalidad presentaba diversos fallos. A partir de las versiones 6.5.3 y 6.6 de Qt, esta sobrecarga restablece el comportamiento de Qt 6.4.

Esta función se introdujo en Qt 6.5.3.

[noexcept] bool qIsFinite(qfloat16 f)

Devuelve «true» si el número « qfloat16 » f es un número finito.

[noexcept] bool qIsInf(qfloat16 f)

Devuelve «true» si el valor de « qfloat16 » ( f ) es equivalente a infinito.

[noexcept] bool qIsNaN(qfloat16 f)

Devuelve «true» si el valor « qfloat16 » f no es un número (NaN).

qint64 qRound64(qfloat16 value)

Redondea el valor de ` value ` al entero de 64 bits más cercano.

int qRound(qfloat16 value)

Redondea el número « value » al entero más cercano.

[noexcept, since 6.11] bool signbit(qfloat16 x)

Devuelve «true» si qfloat16 x es negativo; en caso contrario, devuelve «false». Ten en cuenta que esta función devuelve «true» para los valores cero negativo, infinito negativo y NaN negativo.

Esta función se introdujo en Qt 6.11.

Véase también copysign().

[constexpr noexcept, since 6.12] qfloat16 operator+(qfloat16 a)

Devuelve a sin modificaciones.

Esta función se introdujo en Qt 6.12.

QDataStream &operator<<(QDataStream &ds, qfloat16 f)

Escribe un número de coma flotante, f, en el flujo ds utilizando el formato estándar IEEE 754. Devuelve una referencia al flujo.

Nota: En las versiones de Qt anteriores a la 6.3, esta era una función miembro de QDataStream.

QDataStream &operator>>(QDataStream &ds, qfloat16 &f)

Lee un número de coma flotante del flujo ds y lo almacena en f, utilizando el formato estándar IEEE 754. Devuelve una referencia al flujo.

Nota: En las versiones de Qt anteriores a la 6.3, se trataba de una función miembro de QDataStream.

© 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.