<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 的平台上（如果是这种情况，Qt XML 定义了QT_SUPPORTS_INT128 这个宏）。

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

该类型定义在 Qt 6.6 中引入。

另请参阅 Q_INT128_C(),Q_INT128_MIN,Q_INT128_MAX,quint128, 和QT_SUPPORTS_INT128 。

qintptr

用有符号整数表示指针的整数类型（用于散列等）。

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

请注意，qintptr 是有符号的。对于无符号值，请使用 quintptr。

为了使用格式化输出工具（如printf(),qDebug(),QString::asprintf() 等）打印这种类型的值，可以使用PRIdQINTPTR 和PRIiQINTPTR 宏作为格式指定器。它们都会将数值打印为基数为 10 的数字。

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。在 Qt 支持的所有平台上，该类型保证与指针大小相同。在使用 32 位指针的系统上，quintptr 是 quint32 的类型定义；在使用 64 位指针的系统上，quintptr 是 quint64 的类型定义。

请注意，qptrdiff 是有符号的。对于无符号值，请使用 quintptr。

为了使用格式化输出工具（如printf(),qDebug(),QString::asprintf() 等）打印这种类型的值，可以使用PRIdQPTRDIFF 和PRIiQPTRDIFF 宏作为格式指定器。它们都会将数值打印为基数为 10 的数字。

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

另请参阅 quintptr,qint32, 和qint64 。

qreal

用于double 的类型定义，除非 Qt XML 配置了-qreal float 选项。

[alias] qsizetype

为所有平台提供 Posix'ssize_t 的积分类型。

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

请注意，qsizetype 是有符号的。对于无符号值，请使用size_t 。

为了使用格式化输出工具（如printf(),qDebug(),QString::asprintf() 等）打印这种类型的值，可以使用PRIdQSIZETYPE 和PRIiQSIZETYPE 宏作为格式指定器。它们都将以 10 为基数打印数值。

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

另请参见 qptrdiff 。

quint8

用于unsigned char 的类型定义。在 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 的平台上（如果是这种情况，Qt XML 定义了QT_SUPPORTS_INT128 这个宏）。

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

该类型定义在 Qt 6.6 中引入。

另请参阅 Q_UINT128_C(),Q_UINT128_MAX,qint128, 和QT_SUPPORTS_INT128 。

quintptr

以无符号整数表示指针的整数类型（用于散列等）。

类型定义为 quint32 或 quint64。在 Qt 支持的所有平台上，该类型保证与指针大小相同。在使用 32 位指针的系统上，quintptr 是 quint32 的类型定义；在使用 64 位指针的系统上，quintptr 是 quint64 的类型定义。

请注意，quintptr 是无符号的。对于有符号值，请使用 qptrdiff。

为了使用格式化输出工具（如printf(),qDebug(),QString::asprintf() 等）打印这种类型的值，可以使用以下宏作为格式指定符：

• PRIuQUINTPTR以 10 为基数打印数值。
• PRIoQUINTPTR以 8 为基数打印数值。
• PRIxQUINTPTR：使用小写字母a-f 将数值打印为基数 16 的数字。
• PRIXQUINTPTR：使用大写字母A-F 将数值打印为基数 16 的数字。

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

另请参阅 qptrdiff,quint32, 和quint64 。

qulonglong

unsigned long long int 的类型定义（Windows 上为unsigned __int64 ）。这与quint64 相同。

另请参见 quint64 和qlonglong 。

uchar

unsigned char 的便捷类型定义。

uint

unsigned int 的便捷类型定义。

ulong

unsigned long 的便捷类型定义。

ushort

unsigned short 的便利类型定义。