<QtTypes> - Qt Type Declarations

El archivo de cabecera <QtTypes> incluye las declaraciones de los tipos fundamentales de Qt. Más información...

Header: #include <QtTypes>

Tipos

Macros

(since 6.2) PRIXQUINTPTR
(since 6.2)
(since 6.2) PRIdQINTPTR
(since 6.2)
(since 6.2) PRIdQPTRDIFF
(since 6.2)
(since 6.2) PRIdQSIZETYPE
(since 6.2) PRIiQINTPTR
(since 6.2) PRIiQPTRDIFF
(since 6.2) PRIiQSIZETYPE
(since 6.2)
(since 6.2) PRIoQUINTPTR
(since 6.2) PRIuQUINTPTR
(since 6.2) PRIxQUINTPTR
(since 6.6) QT_SUPPORTS_INT128
(since 6.6) qint128 Q_INT128_C(literal)
(since 6.6) Q_INT128_MAX
(since 6.6) Q_INT128_MIN
qint64 Q_INT64_C(literal)
(since 6.6) quint128 Q_UINT128_C(literal)
(since 6.6) Q_UINT128_MAX
quint64 Q_UINT64_C(literal)

Descripción detallada

El archivo de cabecera declara varias definiciones de tipos que garantizan un tamaño en bits específico en todas las plataformas compatibles con Qt para diversos tipos básicos; por ejemplo, ` qint8 `, que es un `char` con signo cuyo tamaño está garantizado en 8 bits en todas las plataformas compatibles con Qt. El archivo de cabecera también declara la definición de tipo ` qlonglong ` para ` long long int`.

Se declaran varias definiciones de tipos de conveniencia: ` qreal ` para ` double ` o ` float`, ` uchar ` para ` unsigned char`, ` uint ` para ` unsigned int`, ` ulong ` para ` unsigned long ` y ` ushort ` para ` unsigned short`.

El encabezado también proporciona una serie de macros que permiten imprimir algunos alias de tipos de Qt (qsizetype, qintptr, etc.) mediante una función de salida formateada, como printf() o qDebug(), sin generar advertencias de formato y sin necesidad de realizar una conversión de tipos.

Documentación de tipos

qint8

Definición de tipo para ` signed char`. Se garantiza que este tipo es de 8 bits en todas las plataformas compatibles con Qt.

qint16

Definición de tipo para ` signed short`. Se garantiza que este tipo es de 16 bits en todas las plataformas compatibles con Qt.

qint32

Definición de tipo para ` signed int`. Se garantiza que este tipo es de 32 bits en todas las plataformas compatibles con Qt.

qint64

Definición de tipo para ` long long int`. Se garantiza que este tipo es de 64 bits en todas las plataformas compatibles con Qt.

Los literales de este tipo se pueden crear utilizando la macro ` Q_INT64_C()`:

qint64 value = Q_INT64_C(932838457459459);

Véase también Q_INT64_C(), quint64 y qlonglong.

[since 6.6] qint128

Definición de tipo para ` __int128 ` en plataformas que lo admitan (Qt define la macro ` QT_SUPPORTS_INT128 ` si es así).

Los literales de este tipo se pueden crear utilizando la macro ` Q_INT128_C()`.

Esta definición de tipo se introdujo en Qt 6.6.

Véase también Q_INT128_C(), Q_INT128_MIN, Q_INT128_MAX, quint128 y QT_SUPPORTS_INT128.

qintptr

Tipo integral para representar punteros en un entero con signo (útil para el hash, etc.).

Definición de tipo (typedef) para qint32 o qint64. Se garantiza que este tipo tiene el mismo tamaño que un puntero en todas las plataformas compatibles con Qt. En un sistema con punteros de 32 bits, qintptr es un typedef para qint32; en un sistema con punteros de 64 bits, qintptr es un typedef para qint64.

Ten en cuenta que qintptr es con signo. Utiliza quintptr para valores sin signo.

Para mostrar valores de este tipo utilizando funciones de salida formateada como printf(), qDebug(), QString::asprintf() y similares, puede utilizar las macros PRIdQINTPTR y PRIiQINTPTR como especificadores de formato. Ambas mostrarán el valor como un número en base 10.

qintptr p = 123;
printf("The pointer is %" PRIdQINTPTR "\n", p);

Véase también qptrdiff, qint32 y qint64.

qlonglong

Definición de tipo para « long long int » (__int64 en Windows). Es lo mismo que « qint64 ».

Véase también qulonglong y qint64.

qptrdiff

Tipo integral para representar diferencias entre punteros.

Definición de tipo (typedef) para qint32 o qint64. Se garantiza que este tipo tiene el mismo tamaño que un puntero en todas las plataformas compatibles con Qt. En un sistema con punteros de 32 bits, quintptr es una definición de tipo para quint32; en un sistema con punteros de 64 bits, quintptr es una definición de tipo para quint64.

Ten en cuenta que `qptrdiff` es un tipo con signo. Utiliza `quintptr` para valores sin signo.

Para imprimir valores de este tipo utilizando funciones de salida formateada como printf(), qDebug(), QString::asprintf() y similares, puede utilizar las macros PRIdQPTRDIFF y PRIiQPTRDIFF como especificadores de formato. Ambas imprimirán el valor como un número en base 10.

qptrdiff d = 123;
printf("The difference is %" PRIdQPTRDIFF "\n", d);

Véase también quintptr, qint32 y qint64.

qreal

Definición de tipo para ` double `, salvo que Qt se haya configurado con la opción « -qreal float ».

[alias] qsizetype

Tipo integral que proporciona el ` ssize_t ` de POSIX para todas las plataformas.

Se garantiza que este tipo tiene el mismo tamaño que un ` size_t ` en todas las plataformas compatibles con Qt.

Ten en cuenta que `qsizetype` es un tipo con signo. Utiliza ` size_t ` para valores sin signo.

Para imprimir valores de este tipo utilizando funciones de salida formateada como ` printf()`, ` qDebug()`, ` QString::asprintf()` y similares, puede utilizar las macros ` PRIdQSIZETYPE ` y ` PRIiQSIZETYPE ` como especificadores de formato. Ambas imprimirán el valor como un número en base 10.

qsizetype s = 123;
printf("The size is %" PRIdQSIZETYPE "\n", s);

Véase también qptrdiff.

quint8

Definición de tipo para ` unsigned char`. Se garantiza que este tipo tiene 8 bits en todas las plataformas compatibles con Qt.

quint16

Definición de tipo para ` unsigned short`. Se garantiza que este tipo es de 16 bits en todas las plataformas compatibles con Qt.

quint32

Definición de tipo para « unsigned int ». Se garantiza que este tipo es de 32 bits en todas las plataformas compatibles con Qt.

quint64

Definición de tipo para ` unsigned long long int`. Se garantiza que este tipo es de 64 bits en todas las plataformas compatibles con Qt.

Los literales de este tipo se pueden crear utilizando la macro Q_UINT64_C():

quint64 value = Q_UINT64_C(932838457459459);

Véase también Q_UINT64_C(), qint64 y qulonglong.

[since 6.6] quint128

Definición de tipo para « unsigned __int128 » en las plataformas que lo admiten (Qt define la macro « QT_SUPPORTS_INT128 » si es así).

Los literales de este tipo se pueden crear utilizando la macro Q_UINT128_C().

Esta definición de tipo se introdujo en Qt 6.6.

Véase también Q_UINT128_C(), Q_UINT128_MAX, qint128 y QT_SUPPORTS_INT128.

quintptr

Tipo integral para representar punteros en un entero sin signo (útil para el hash, etc.).

Definición de tipo (typedef) para quint32 o quint64. Se garantiza que este tipo tiene el mismo tamaño que un puntero en todas las plataformas compatibles con Qt. En un sistema con punteros de 32 bits, `quintptr` es un `typedef` para `quint32`; en un sistema con punteros de 64 bits, `quintptr` es un `typedef` para `quint64`.

Ten en cuenta que quintptr no tiene signo. Utiliza qptrdiff para valores con signo.

Para imprimir valores de este tipo utilizando funciones de salida formateada como printf(), qDebug(), QString::asprintf() y similares, puede utilizar las siguientes macros como especificadores de formato:

  • PRIuQUINTPTR: imprime el valor como un número en base 10.
  • PRIoQUINTPTR: imprime el valor como un número en base 8.
  • PRIxQUINTPTR: muestra el valor como un número en base 16, utilizando letras minúsculas a-f.
  • PRIXQUINTPTR: muestra el valor como un número en base 16, utilizando letras mayúsculas A-F.
quintptr p = 123u;
printf("The pointer value is 0x%" PRIXQUINTPTR "\n", p);

Véase también qptrdiff, quint32 y quint64.

qulonglong

Definición de tipo para ` unsigned long long int ` (unsigned __int64 en Windows). Es lo mismo que ` quint64`.

Véase también quint64 y qlonglong.

uchar

Definición de tipo de conveniencia para ` unsigned char`.

uint

Definición de tipo de conveniencia para ` unsigned int`.

ulong

Definición de tipo de conveniencia para ` unsigned long`.

ushort

Definición de tipo de conveniencia para « unsigned short ».

Documentación de macros

[since 6.2] PRIdQINTPTR

[since 6.2] PRIiQINTPTR

Consulta qintptr.

Estas macros se introdujeron en Qt 6.2.

[since 6.2] PRIdQPTRDIFF

[since 6.2] PRIiQPTRDIFF

Véase qptrdiff.

Estas macros se introdujeron en Qt 6.2.

[since 6.2] PRIdQSIZETYPE

[since 6.2] PRIiQSIZETYPE

Véase qsizetype.

Estas macros se introdujeron en Qt 6.2.

[since 6.2] PRIoQUINTPTR

[since 6.2] PRIuQUINTPTR

[since 6.2] PRIxQUINTPTR

[since 6.2] PRIXQUINTPTR

Véase «quintptr».

Estas macros se introdujeron en Qt 6.2.

[since 6.6] QT_SUPPORTS_INT128

Qt define esta macro, así como los tipos « qint128 » y « quint128 », si la plataforma admite tipos enteros de 128 bits.

Esta macro se introdujo en Qt 6.6.

Véase también qint128, quint128, Q_INT128_C(), Q_UINT128_C(), Q_INT128_MIN, Q_INT128_MAX y Q_UINT128_MAX.

[since 6.6] qint128 Q_INT128_C(literal)

Envuelve el entero con signo de 128 bits literal de forma independiente de la plataforma.

Nota: A diferencia de ` Q_INT64_C()`, esta macro solo está disponible en C++, no en C. Esto se debe a que los compiladores no proporcionan estos literales como valores predefinidos y C no admite literales definidos por el usuario.

Esta macro se introdujo en Qt 6.6.

Véase también qint128, Q_UINT128_C(), Q_INT128_MIN, Q_INT128_MAX, Q_INT64_C() y QT_SUPPORTS_INT128.

[since 6.6] Q_INT128_MAX

Esta macro se expande a una constante en tiempo de compilación que representa el valor máximo representable en un ` qint128`.

Esta macro está disponible tanto en el modo C++ como en el modo C.

Esta macro se introdujo en Qt 6.6.

Véase también Q_INT128_MIN, Q_UINT128_MAX, qint128, Q_INT128_C y QT_SUPPORTS_INT128.

[since 6.6] Q_INT128_MIN

Esta macro se expande a una constante en tiempo de compilación que representa el valor mínimo representable en un ` qint128`.

Esta macro está disponible tanto en el modo C++ como en el modo C.

Esta macro se introdujo en Qt 6.6.

Véase también Q_INT128_MAX, qint128, Q_INT128_C y QT_SUPPORTS_INT128.

qint64 Q_INT64_C(literal)

Envuelve el entero con signo de 64 bits literal de forma independiente de la plataforma.

Ejemplo:

qint64 value = Q_INT64_C(932838457459459);

Véase también qint64, Q_UINT64_C() y Q_INT128_C().

[since 6.6] quint128 Q_UINT128_C(literal)

Envuelve el entero sin signo de 128 bits literal de forma independiente de la plataforma.

Nota: A diferencia de Q_UINT64_C(), esta macro solo está disponible en C++, no en C. Esto se debe a que los compiladores no proporcionan estos literales como valores predefinidos y C no admite literales definidos por el usuario.

Esta macro se introdujo en Qt 6.6.

Véase también quint128, Q_INT128_C(), Q_UINT128_MAX, Q_UINT64_C() y QT_SUPPORTS_INT128.

[since 6.6] Q_UINT128_MAX

Esta macro se expande a una constante en tiempo de compilación que representa el valor máximo que puede representarse en un ` quint128`.

Esta macro está disponible tanto en el modo C++ como en el modo C.

El valor mínimo de ` quint128 ` es 0 (cero), por lo que no es necesario ni se proporciona un ` Q_UINT128_MIN `.

Esta macro se introdujo en Qt 6.6.

Véase también Q_INT128_MAX, quint128, Q_UINT128_C y QT_SUPPORTS_INT128.

quint64 Q_UINT64_C(literal)

Envuelve el entero sin signo de 64 bits literal de forma independiente de la plataforma.

Ejemplo:

quint64 value = Q_UINT64_C(932838457459459);

Véase también quint64, Q_INT64_C() y Q_UINT128_C().

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