头文件包含了 Qt 类库的一些全局定义,包括基本数据类型、函数和宏,一般的 Qt 类的头文件都会包含该文件,所以不用显式包含这个头文件也可以使用其中的定义。
全局变量定义
为了确保在各个平台上各数据类型都有统一确定的长度,Qt 为各种常见数据类型定义了类型符号,如 qint8 就是 signed char 的类型定义,即:
typedef signed char qint8;
中定义的数据类型见表 1。
Qt 数据类型 | 等效定义 | 字节数 |
---|---|---|
qint8 | signed char | 1 |
qint16 | signed short | 2 |
qint32 | signed int | 4 |
qint64 | long long int | 8 |
qlonglong | long long int | 8 |
quint8 | unsigned char | 1 |
quint16 | unsigned short | 2 |
quint32 | unsigned int | 4 |
quint64 | unsigned long long int | 8 |
qulonglong | unsigned long long int | 8 |
uchar | unsigned char | 1 |
ushort | unsigned short | 2 |
uint | unsigned int | 4 |
ulong | unsigned long | 8 |
qreal | double | 8 |
qfloat16 | 2 |
其中 qreal 缺省是 8 字节 double 类型浮点数,如果 Qt 使用 -qreal float
选项进行配置,就是 4 字节 float 类型的浮点数。
qfloat16 是 Qt 5.9.0 中新增的一个类,用于表示 16 位的浮点数,要使用 qfloat16,需要包含头文件 。
全局函数定义
头文件包含一些常用函数的定义,这些函数多以模板类型作为参数,返回相应的模板类型,模板类型可以用任何其他类型替换。若是以 double 或 float 类型数作为参数的,一般有两个参数版本的同名函数,如qFuzzyIsNull(double d) 和 qFuzzyIsNull(float f)。
表 2 是 中常用的全局函数定义,列出了函数的输入和输出参数(若存在 double 和 float 两种参数版本,只列出 double 类型参数的版本)。
函数 | 功能 |
---|---|
T qAbs(const T &value) | 返回变量 value 的绝对值 |
const T &qBound(const T &min, const T&value, const T &max) | 返回 value 限定在 min 至 max 范围之内的値 |
bool qFuzzyComparc(doublc p1, double p2) | 若 p1 和 p2 近似相等,返回 true |
bool qFuzzyIsNulI(double d) | 如果参数 d 约等于 0,返回 true |
double qInf(() | 返回无穷大的数 |
bool qIsFinite(double d) | 若 d 是一个有限的数,返回 true |
bool qIsInf(double d) | 若 d 是一个无限大的数,返回 true |
bool qIsNaN(double d) | 若 d 不是一个数,返回 true |
constT&qMax(const T&value1, const T&value2) | 返回 value1 和 value2 中较大的值 |
const T &qMin(const T&value1, const T&value2) | 返回 value1 和 value2 中较小的值 |
qint64 qRound64(double value) | 将 value 近似为最接近的 qint64 整数 |
int qRound(double value) | 将 value 近似为最接近的 int 整数 |
int qrand() | 标准 C++ 中 rand() 函数的线程安全型版本,返回 0 至 RAND_MAX 之间的伪随机数 |
void qsrand(uint seed) | 标准 C++ 中 srand() 函数的线程安全型版本,使用种子 seed 对伪随机数字序列初始化 |
还有一些基础的数学运算函数在 头文件中定义,比如三角运算函数、弧度与角度之间的转换函数等。
全局宏定义
中文件中定义了很多宏,以下一些是比较常用的:
-
QT_VERSION:这个宏展开为数值形式 0xMMNNPP (MM = major, NN = minor, PP = patch) 表示 Qt 编译器版本,例如 Qt 编译器版本为 Qt 5.9.1,则 QT_VERSION 为 0x050901。这个宏常用于条件编译设置,根据 Qt 版本不同,编译不同的代码段。
#if QT_VERSION >= 0x040100 QIcon icon = style()->standardIcon(QStyle::SP_TrashIcon); #else QPixmap pixmap = style()->standardPixmap(QStyle::SP_TrashIcon); Qlcon icon(pixmap); #endif
-
QT_VERSION_CHECK:这个宏展开为 Qt 版本号的一个整数表示,例如:
#if (QT_VERSION >= QT_VERSION_CHECK(5, 0, 0)) #include <QtWidgets> #else #include <QtGui> #endif
-
QT_VERSION_STR:这个宏展开为 Qt 版本号的字符串,如“5.9.0”。
-
Q_BYTE_ORDER、Q_BIG_ENDIAN 和 Q_LITTLE_ENDIAN:Q_BYTE_ORDER 表示系统内存中数据的字节序,Q_BIG_ENDIAN 表示大端字节序,Q_LITTLE_ ENDIAN 表示小端字节序。在需要判断系统字节序时会用到,例如:
#if Q_BYTE_ORDER == Q_LITTLE_ENDIAN ... #endif
-
Q_DECL_IMPORT 和 Q_DECL_EXPORT:在使用或设计共享库时,用于导入或导出库的内容,后续章节有其使用实例。
-
Q_DECL_OVERRIDE:在类定义中,用于重载一个虚函数,例如在某个类中重载虚函数 paintEvem(),可以定义如下:
void paintEvent(QPaintEvent*) Q_DECL_OVERRIDE;
使用 Q_DECL_OVERRIDE 宏后,如果重载的虚函数没有进行任何重载操作,编译器将会报错。
-
Q_DECL_FINAL:这个宏将一个虚函数定义为最终级别,不能再被重载,或定义一个类不能再被继承,示例如下:
Class QRect Q_DECL_FINAL { // QRect 不能再被继承 // ... };
-
Q_UNUSED(name):这个宏用于在函数中定义不在函数体里使用的参数,示例如下:
void MainWindow::on_imageSaved(int id, const QString &fileName) { Q_UNUSED(id); LabInfo->setText ("图片保存为:"+ fileName); }
在这个函数里,id 参数没有使用。如果不用 QJJNUSED(id) 定义,编译器会出现参数未使用的警告。
-
foreach(variable, container):foreach 用于容器类的遍历,例如:
foreach (const QString &codecName, recorder->supportedAudioCodecs()) ui->comboCodec->addItem(codecName);
-
forever:forever用于构造一个无限循环,例如:
forever { ... }
-
qDebug(const char * message,…):在debugger窗体显示信息,如果编译器设置了 Qt_NO_DEBUG_OUTPUT,则不作任何输出,例如:
qDebug(“Items in list: %d”, myList.size());
类似的宏还有 qWarning、qCritical、qFatal、qInfo 等,也是用于在 debugger 窗体显示信息。