<QtTypes> - Qt Type Declarations

Type Documentation

qint8

Typedef for signed char. This type is guaranteed to be 8-bit on all platforms supported by Qt.

qint16

Typedef for signed short. This type is guaranteed to be 16-bit on all platforms supported by Qt.

qint32

Typedef for signed int. This type is guaranteed to be 32-bit on all platforms supported by Qt.

qint64

Typedef for long long int. This type is guaranteed to be 64-bit on all platforms supported by Qt.

Literals of this type can be created using the Q_INT64_C() macro:

 qint64 value = Q_INT64_C(932838457459459);

See also Q_INT64_C(), quint64, and qlonglong.

[since 6.6] qint128

Typedef for __int128 on platforms that support it (Qt defines the macro QT_SUPPORTS_INT128 if this is the case).

Literals of this type can be created using the Q_INT128_C() macro.

This typedef was introduced in Qt 6.6.

See also Q_INT128_C(), Q_INT128_MIN, Q_INT128_MAX, quint128, and QT_SUPPORTS_INT128.

qintptr

Integral type for representing pointers in a signed integer (useful for hashing, etc.).

Typedef for either qint32 or qint64. This type is guaranteed to be the same size as a pointer on all platforms supported by Qt. On a system with 32-bit pointers, qintptr is a typedef for qint32; on a system with 64-bit pointers, qintptr is a typedef for qint64.

Note that qintptr is signed. Use quintptr for unsigned values.

In order to print values of this type by using formatted-output facilities such as printf(), qDebug(), QString::asprintf() and so on, you can use the PRIdQINTPTR and PRIiQINTPTR macros as format specifiers. They will both print the value as a base 10 number.

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

See also qptrdiff, qint32, and qint64.

qlonglong

Typedef for long long int (__int64 on Windows). This is the same as qint64.

See also qulonglong and qint64.

qptrdiff

Integral type for representing pointer differences.

Typedef for either qint32 or qint64. This type is guaranteed to be the same size as a pointer on all platforms supported by Qt. On a system with 32-bit pointers, quintptr is a typedef for quint32; on a system with 64-bit pointers, quintptr is a typedef for quint64.

Note that qptrdiff is signed. Use quintptr for unsigned values.

In order to print values of this type by using formatted-output facilities such as printf(), qDebug(), QString::asprintf() and so on, you can use the PRIdQPTRDIFF and PRIiQPTRDIFF macros as format specifiers. They will both print the value as a base 10 number.

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

See also quintptr, qint32, and qint64.

qreal

Typedef for double unless Qt is configured with the -qreal float option.

[alias] qsizetype

Integral type providing Posix' ssize_t for all platforms.

This type is guaranteed to be the same size as a size_t on all platforms supported by Qt.

Note that qsizetype is signed. Use size_t for unsigned values.

In order to print values of this type by using formatted-output facilities such as printf(), qDebug(), QString::asprintf() and so on, you can use the PRIdQSIZETYPE and PRIiQSIZETYPE macros as format specifiers. They will both print the value as a base 10 number.

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

See also qptrdiff.

quint8

Typedef for unsigned char. This type is guaranteed to be 8-bit on all platforms supported by Qt.

quint16

Typedef for unsigned short. This type is guaranteed to be 16-bit on all platforms supported by Qt.

quint32

Typedef for unsigned int. This type is guaranteed to be 32-bit on all platforms supported by Qt.

quint64

Typedef for unsigned long long int. This type is guaranteed to be 64-bit on all platforms supported by Qt.

Literals of this type can be created using the Q_UINT64_C() macro:

 quint64 value = Q_UINT64_C(932838457459459);

See also Q_UINT64_C(), qint64, and qulonglong.

[since 6.6] quint128

Typedef for unsigned __int128 on platforms that support it (Qt defines the macro QT_SUPPORTS_INT128 if this is the case).

Literals of this type can be created using the Q_UINT128_C() macro.

This typedef was introduced in Qt 6.6.

See also Q_UINT128_C(), Q_UINT128_MAX, qint128, and QT_SUPPORTS_INT128.

quintptr

Integral type for representing pointers in an unsigned integer (useful for hashing, etc.).

Typedef for either quint32 or quint64. This type is guaranteed to be the same size as a pointer on all platforms supported by Qt. On a system with 32-bit pointers, quintptr is a typedef for quint32; on a system with 64-bit pointers, quintptr is a typedef for quint64.

Note that quintptr is unsigned. Use qptrdiff for signed values.

In order to print values of this type by using formatted-output facilities such as printf(), qDebug(), QString::asprintf() and so on, you can use the following macros as format specifiers:

• PRIuQUINTPTR: prints the value as a base 10 number.
• PRIoQUINTPTR: prints the value as a base 8 number.
• PRIxQUINTPTR: prints the value as a base 16 number, using lowercase a-f letters.
• PRIXQUINTPTR: prints the value as a base 16 number, using uppercase A-F letters.

 quintptr p = 123u;
 printf("The pointer value is 0x%" PRIXQUINTPTR "\n", p);

See also qptrdiff, quint32, and quint64.

qulonglong

Typedef for unsigned long long int (unsigned __int64 on Windows). This is the same as quint64.

See also quint64 and qlonglong.

uchar

Convenience typedef for unsigned char.

uint

Convenience typedef for unsigned int.

ulong

Convenience typedef for unsigned long.

ushort

Convenience typedef for unsigned short.

 qint64 value = Q_INT64_C(932838457459459);

 quint64 value = Q_UINT64_C(932838457459459);