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

阳光穿透心脏的1/2处 2023-07-03 12:05 121阅读 0赞

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

## 全局变量、数据类型定义 ##

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

typedef signed char qint8;

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

<table>  表 1 Qt 中的数据类型定义  
 <tbody> 
  <tr> 
   <th>Qt 数据类型</th> 
   <th>等效定义</th> 
   <th>字节数</th> 
  </tr> 
  <tr> 
   <td>qint8</td> 
   <td>signed char</td> 
   <td>1</td> 
  </tr> 
  <tr> 
   <td>qint16</td> 
   <td>signed short</td> 
   <td>2</td> 
  </tr> 
  <tr> 
   <td>qint32</td> 
   <td>signed int</td> 
   <td>4</td> 
  </tr> 
  <tr> 
   <td>qint64</td> 
   <td>long long int</td> 
   <td>8</td> 
  </tr> 
  <tr> 
   <td>qlonglong</td> 
   <td>long long int</td> 
   <td>8</td> 
  </tr> 
  <tr> 
   <td>quint8</td> 
   <td>unsigned char</td> 
   <td>1</td> 
  </tr> 
  <tr> 
   <td>quint16</td> 
   <td>unsigned short</td> 
   <td>2</td> 
  </tr> 
  <tr> 
   <td>quint32</td> 
   <td>unsigned int</td> 
   <td>4</td> 
  </tr> 
  <tr> 
   <td>quint64</td> 
   <td>unsigned long long int</td> 
   <td>8</td> 
  </tr> 
  <tr> 
   <td>qulonglong</td> 
   <td>unsigned long long int</td> 
   <td>8</td> 
  </tr> 
  <tr> 
   <td>uchar</td> 
   <td>unsigned char</td> 
   <td>1</td> 
  </tr> 
  <tr> 
   <td>ushort</td> 
   <td>unsigned short</td> 
   <td>2</td> 
  </tr> 
  <tr> 
   <td>uint</td> 
   <td>unsigned int</td> 
   <td>4</td> 
  </tr> 
  <tr> 
   <td>ulong</td> 
   <td>unsigned long</td> 
   <td>8</td> 
  </tr> 
  <tr> 
   <td>qreal</td> 
   <td>double</td> 
   <td>8</td> 
  </tr> 
  <tr> 
   <td>qfloat16</td> 
   <td>&nbsp;</td> 
   <td>2</td> 
  </tr> 
 </tbody> 
</table>

其中 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 类型参数的版本）。

<table>  表 2 &lt;QtGlobal&gt;中常用的全局函数定义  
 <tbody> 
  <tr> 
   <th>函数</th> 
   <th>功能</th> 
  </tr> 
  <tr> 
   <td>T qAbs(const T &amp;value)</td> 
   <td>返回变量 value 的绝对值</td> 
  </tr> 
  <tr> 
   <td>const T &amp;qBound(const T &amp;min, const T&amp;value, const T &amp;max)</td> 
   <td>返回 value 限定在 min 至 max 范围之内的値</td> 
  </tr> 
  <tr> 
   <td>bool qFuzzyComparc(doublc p1, double p2)</td> 
   <td>若 p1 和 p2 近似相等，返回 true</td> 
  </tr> 
  <tr> 
   <td>bool qFuzzyIsNulI(double d)</td> 
   <td>如果参数 d 约等于 0，返回 true</td> 
  </tr> 
  <tr> 
   <td>double qInf(()</td> 
   <td>返回无穷大的数</td> 
  </tr> 
  <tr> 
   <td>bool qIsFinite(double d)&nbsp;</td> 
   <td>若 d 是一个有限的数，返回 true</td> 
  </tr> 
  <tr> 
   <td>bool qIsInf(double d)&nbsp;</td> 
   <td>若 d 是一个无限大的数，返回 true</td> 
  </tr> 
  <tr> 
   <td>bool qIsNaN(double d)</td> 
   <td>若 d 不是一个数，返回 true</td> 
  </tr> 
  <tr> 
   <td>constT&amp;qMax(const T&amp;value1, const T&amp;value2)</td> 
   <td>返回 value1 和 value2 中较大的值</td> 
  </tr> 
  <tr> 
   <td>const T &amp;qMin(const T&amp;value1, const T&amp;value2)</td> 
   <td>返回 value1 和 value2 中较小的值</td> 
  </tr> 
  <tr> 
   <td>qint64 qRound64(double value)&nbsp;</td> 
   <td>将 value 近似为最接近的 qint64 整数</td> 
  </tr> 
  <tr> 
   <td>int qRound(double value)</td> 
   <td>将 value 近似为最接近的 int 整数</td> 
  </tr> 
  <tr> 
   <td>int qrand()</td> 
   <td>标准&nbsp;<a href="http://c.biancheng.net/cplus/" rel="nofollow">C++</a>&nbsp;中 rand() 函数的线程安全型版本，返回 0 至 RAND_MAX 之间的伪随机数</td> 
  </tr> 
  <tr> 
   <td>void qsrand(uint seed)</td> 
   <td>标准 C++ 中 srand() 函数的线程安全型版本，使用种子 seed 对伪随机数字序列初始化</td> 
  </tr> 
 </tbody> 
</table>

还有一些基础的数学运算函数在 <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 (QT_VERSION >= QT_VERSION_CHECK(5, 0, 0))
        #include <QtWidgets>
        #else
        #include <QtGui>
        #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 窗体显示信息。

[Qt]: http://c.biancheng.net/qt/