Qt全局变量、函数和宏定义详解

<QtGlobal> 头文件包含了 Qt 类库的一些全局定义，包括基本数据类型、函数和宏，一般的 Qt 类的头文件都会包含该文件，所以不用显式包含这个头文件也可以使用其中的定义。

全局变量定义

为了确保在各个平台上各数据类型都有统一确定的长度，Qt 为各种常见数据类型定义了类型符号，如 qint8 就是 signed char 的类型定义，即：

<QtGlobal>中定义的数据类型见表 1。 

其中 qreal 缺省是 8 字节 double 类型浮点数，如果 Qt 使用 -qreal float 选项进行配置，就是 4 字节 float 类型的浮点数。

qfloat16 是 Qt 5.9.0 中新增的一个类，用于表示 16 位的浮点数，要使用 qfloat16，需要包含头文件 <QFloat16>。

全局函数定义

<QtGlobal> 头文件包含一些常用函数的定义，这些函数多以模板类型作为参数，返回相应的模板类型，模板类型可以用任何其他类型替换。若是以 double 或 float 类型数作为参数的，一般有两个参数版本的同名函数，如qFuzzyIsNull(double d) 和 qFuzzyIsNull(float f)。

表 2 是 <QtGlobal> 中常用的全局函数定义，列出了函数的输入和输出参数（若存在 double 和 float 两种参数版本，只列出 double 类型参数的版本）。

还有一些基础的数学运算函数在 <QtMath> 头文件中定义，比如三角运算函数、弧度与角度之间的转换函数等。

全局宏定义

<QtGlobal>中文件中定义了很多宏，以下一些是比较常用的：

• 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 窗体显示信息。