<QtTypes> - Qt Type Declarations

类型文档

qint8

signed char 的类型别名。在 Qt 支持的所有平台上，该类型均保证为 8 位。

qint16

signed short 的类型别名。在 Qt 支持的所有平台上，该类型保证为 16 位。

qint32

signed int 的类型别名。该类型在 Qt 支持的所有平台上均保证为 32 位。

qint64

long long int 的类型别名。该类型在 Qt 支持的所有平台上均保证为 64 位。

可使用Q_INT64_C() 宏创建该类型的字面量：

qint64 value = Q_INT64_C(932838457459459);

另请参阅 Q_INT64_C()、quint64 以及qlonglong 。

[since 6.6] qint128

在支持该功能的平台上，__int128 的 typedef 定义（如果支持，Qt 会定义宏QT_SUPPORTS_INT128 ）。

可以使用Q_INT128_C() 宏 创建该类型的字面量。

此 typedef 于 Qt 6.6 中引入。

另请参阅 Q_INT128_C()、Q_INT128_MIN 、Q_INT128_MAX 、quint128 以及QT_SUPPORTS_INT128 。

qintptr

用于将指针表示为有符号整数的集成类型（适用于哈希等场景）。

qint32 或 qint64 的 typedef。 在 Qt 支持的所有平台上，该类型的大小均保证与指针相同。在采用 32 位指针的系统上，qintptr 是 qint32 的 typedef；在采用 64 位指针的系统上，qintptr 是 qint64 的 typedef。

请注意，qintptr 是带符号的。若需表示无符号值，请使用 quintptr。

若要使用格式化输出功能（如printf() 、qDebug()、QString::asprintf() 等）打印此类型的值，可使用PRIdQINTPTR 和PRIiQINTPTR 宏作为格式指定符。它们都会将该值以十进制数的形式打印出来。

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

另请参阅 qptrdiff 、qint32 以及qint64 。

qlonglong

long long int （Windows 系统中为__int64 ）的类型别名。这与qint64 相同。

另请参阅 qulonglong 和qint64 。

qptrdiff

用于表示指针差值的整数类型。

qint32 或 qint64 的 typedef。 在 Qt 支持的所有平台上，该类型的大小均保证与指针大小一致。在采用 32 位指针的系统上，quintptr 是 quint32 的 typedef；在采用 64 位指针的系统上，quintptr 是 quint64 的 typedef。

请注意，qptrdiff 是带符号的。若需表示无符号值，请使用 quintptr。

若要使用格式化输出功能（如printf() 、qDebug()、QString::asprintf() 等）打印该类型的值，可使用PRIdQPTRDIFF 和PRIiQPTRDIFF 宏作为格式指定符。它们都会将值以十进制数的形式打印出来。

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

另请参阅 quintptr 、qint32 和qint64 。

qreal

除非 Qt 在配置时启用了-qreal float 选项，否则此处定义double 的typedef。

[alias] qsizetype

一种在所有平台上均提供 Posix 的 `ssize_t ` 的整数类型。

在 Qt 支持的所有平台上，该类型的大小均保证与 `size_t ` 相同。

请注意，qsizetype 是带符号的。若需处理无符号值，请使用size_t 。

若要使用printf() 、qDebug()、QString::asprintf()等格式化输出功能打印该类型的值，可将PRIdQSIZETYPE 和PRIiQSIZETYPE 宏用作格式指定符。它们都会将值以十进制数的形式打印出来。

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

另请参阅 qptrdiff 。

quint8

unsigned char 的 typedef 定义。在 Qt 支持的所有平台上，该类型均保证为 8 位。

quint16

unsigned short 的类型别名。在 Qt 支持的所有平台上，该类型均保证为 16 位。

quint32

unsigned int 的类型别名。在 Qt 支持的所有平台上，该类型均保证为 32 位。

quint64

unsigned long long int 的类型别名。该类型在 Qt 支持的所有平台上均保证为 64 位。

可使用Q_UINT64_C() 宏创建该类型的字面量：

quint64 value = Q_UINT64_C(932838457459459);

另请参见 Q_UINT64_C()、qint64 以及qulonglong 。

[since 6.6] quint128

在支持该功能的平台上，unsigned __int128 的 typedef 定义（若支持，Qt 会定义宏QT_SUPPORTS_INT128 ）。

可以使用Q_UINT128_C() 宏创建此类型的字面量。

此 typedef 于 Qt 6.6 中引入。

另请参阅 Q_UINT128_C()、Q_UINT128_MAX 、qint128 以及QT_SUPPORTS_INT128 。

quintptr

用于将指针表示为无符号整数的类型（适用于哈希等场景）。

quint32 或 quint64 的 typedef。 在 Qt 支持的所有平台上，该类型的大小均保证与指针大小一致。在 32 位指针系统上，quintptr 是 quint32 的 typedef；在 64 位指针系统上，quintptr 是 quint64 的 typedef。

请注意，quintptr 是无符号的。若需处理有符号值，请使用 qptrdiff。

若要使用格式化输出功能（如printf() 、qDebug()、QString::asprintf()等）打印该类型的值，可使用以下宏作为格式指定符：

• PRIuQUINTPTR: 将值以十进制数的形式打印出来。
• PRIoQUINTPTR: 将该值以十进制数的形式打印出来。
• PRIxQUINTPTR: 将值以十六进制数的形式输出，使用小写字母a-f 。
• PRIXQUINTPTR: 将值以十六进制形式输出，使用大写字母A-F 。

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

另请参阅 qptrdiff 、quint32 以及quint64 。

qulonglong

unsigned long long int （Windows 系统中为unsigned __int64 ）的 typedef 定义。这与quint64 相同。

另请参见 quint64 和qlonglong 。

uchar

unsigned char 的便捷 typedef。

uint

unsigned int 的便捷 typedef。

ulong

unsigned long 的便捷 typedef。

ushort

unsigned short 的便捷 typedef。