Qt 实战（7）元对象系统 | 7.2、MOC（Meta-Object Compiler 元对象编译器）

前言：

在Qt框架中，MOC（Meta-Object Compiler）是一个至关重要的工具，它负责处理Qt特有的元对象系统（Meta-Object System）的相关代码。MOC是一个预处理器，它扫描包含Q_OBJECT宏的C++源文件，生成额外的C++代码，这些代码包含了元对象系统的实现细节，如信号、槽的连接机制、动态属性等。下面，我们将详细探讨Qt MOC的工作原理、使用方式以及它在Qt开发中的作用。

一、MOC

1、MOC的作用

它主要用于处理C++源文件中的非标准C++代码。Qt 程序在交由标准编译器编译之前，先要使用MOC分析 C++ 源文件。如果它发现在一个头文件中包含了宏 Q_OBJECT，则会生成另外一个 C++ 源文件，这个源文件中包含了 Q_OBJECT 宏的实现代码。

新生成的moc_xxx.cpp文件同样将进入编译系统，最终被链接到二进制代码中去。因此可以知道，这个新的文件不是替换掉旧的文件，而是与原文件一起参与编译。另外，moc 的执行是在预处理器之前。因为预处理器执行之后，Q_OBJECT 宏就不存在了。

2、MOC的工作原理

• 扫描源文件：MOC首先扫描包含Q_OBJECT宏的C++源文件。这个宏是启用元对象系统特性的关键，它告诉MOC这个类需要被特殊处理。
• 生成元对象代码：对于每个包含Q_OBJECT宏的类，MOC会生成一个额外的C++源文件。这个源文件包含了该类的元对象定义，包括信号、槽、属性、枚举等的元数据。
• 编译和链接：生成的元对象代码文件会被编译成目标代码，并最终链接到最终的可执行文件或库中。这样，当Qt应用程序运行时，它就可以利用这些元数据来实现信号与槽的连接、动态属性访问等功能。

3、MOC的使用方式

在Qt项目中，你通常不需要直接调用MOC。Qt的构建系统（如qmake或CMake的Qt集成）会自动处理MOC的调用。当你使用qmake构建项目时，它会检查你的源文件，找出包含Q_OBJECT宏的类，并自动为它们调用MOC。同样，如果你在使用CMake并启用了Qt的集成，CMake也会为你处理MOC的调用。

然而，在某些情况下，你可能需要手动调用MOC（例如，在复杂的构建环境中或当你需要直接控制构建过程时）。在这种情况下，你可以使用MOC命令行工具来直接处理源文件。MOC命令行工具的基本用法如下：

moc [options] <header-file>

4、MOC生成的文件结构

下面是通过MOC 工具生成的文件的结构，如下：

/****************************************************************************
** Meta object code from reading C++ file 'dialog.h'
**
** Created by: The Qt Meta Object Compiler version 67 (Qt 5.6.3)
**
** WARNING! All changes made in this file will be lost!
*****************************************************************************/

#include "../../example/dialog.h"
#include <QtCore/qbytearray.h>
#include <QtCore/qmetatype.h>
#if !defined(Q_MOC_OUTPUT_REVISION)
#error "The header file 'dialog.h' doesn't include <QObject>."
#elif Q_MOC_OUTPUT_REVISION != 67
#error "This file was generated using the moc from 5.6.3. It"
#error "cannot be used with the include files from this version of Qt."
#error "(The moc has changed too much.)"
#endif

QT_BEGIN_MOC_NAMESPACE
struct qt_meta_stringdata_Dialog_t {
    QByteArrayData data[6];
    char stringdata0[72];
};
#define QT_MOC_LITERAL(idx, ofs, len) \
    Q_STATIC_BYTE_ARRAY_DATA_HEADER_INITIALIZER_WITH_OFFSET(len, \
    qptrdiff(offsetof(qt_meta_stringdata_Dialog_t, stringdata0) + ofs \
        - idx * sizeof(QByteArrayData)) \
    )
static const qt_meta_stringdata_Dialog_t qt_meta_stringdata_Dialog = {
    {
QT_MOC_LITERAL(0, 0, 6), // "Dialog"
QT_MOC_LITERAL(1, 7, 12), // "OkBtnclicked"
QT_MOC_LITERAL(2, 20, 0), // ""
QT_MOC_LITERAL(3, 21, 16), // "CancelBtnclicked"
QT_MOC_LITERAL(4, 38, 14), // "OnOkBtnClicked"
QT_MOC_LITERAL(5, 53, 18) // "OnCancelBtnClicked"

    },
    "Dialog\0OkBtnclicked\0\0CancelBtnclicked\0"
    "OnOkBtnClicked\0OnCancelBtnClicked"
};
#undef QT_MOC_LITERAL

static const uint qt_meta_data_Dialog[] = {

 // content:
       7,       // revision
       0,       // classname
       0,    0, // classinfo
       4,   14, // methods
       0,    0, // properties
       0,    0, // enums/sets
       0,    0, // constructors
       0,       // flags
       2,       // signalCount

 // signals: name, argc, parameters, tag, flags
       1,    0,   34,    2, 0x06 /* Public */,
       3,    0,   35,    2, 0x06 /* Public */,

 // slots: name, argc, parameters, tag, flags
       4,    0,   36,    2, 0x0a /* Public */,
       5,    0,   37,    2, 0x0a /* Public */,

 // signals: parameters
    QMetaType::Void,
    QMetaType::Void,

 // slots: parameters
    QMetaType::Void,
    QMetaType::Void,

       0        // eod
};

void Dialog::qt_static_metacall(QObject *_o, QMetaObject::Call _c, int _id, void **_a)
{
    if (_c == QMetaObject::InvokeMetaMethod) {
        Dialog *_t = static_cast<Dialog *>(_o);
        Q_UNUSED(_t)
        switch (_id) {
        case 0: _t->OkBtnclicked(); break;
        case 1: _t->CancelBtnclicked(); break;
        case 2: _t->OnOkBtnClicked(); break;
        case 3: _t->OnCancelBtnClicked(); break;
        default: ;
        }
    } else if (_c == QMetaObject::IndexOfMethod) {
        int *result = reinterpret_cast<int *>(_a[0]);
        void **func = reinterpret_cast<void **>(_a[1]);
        {
            typedef void (Dialog::*_t)();
            if (*reinterpret_cast<_t *>(func) == static_cast<_t>(&Dialog::OkBtnclicked)) {
                *result = 0;
                return;
            }
        }
        {
            typedef void (Dialog::*_t)();
            if (*reinterpret_cast<_t *>(func) == static_cast<_t>(&Dialog::CancelBtnclicked)) {
                *result = 1;
                return;
            }
        }
    }
    Q_UNUSED(_a);
}

const QMetaObject Dialog::staticMetaObject = {
    { &QDialog::staticMetaObject, qt_meta_stringdata_Dialog.data,
      qt_meta_data_Dialog,  qt_static_metacall, Q_NULLPTR, Q_NULLPTR}
};


const QMetaObject *Dialog::metaObject() const
{
    return QObject::d_ptr->metaObject ? QObject::d_ptr->dynamicMetaObject() : &staticMetaObject;
}

void *Dialog::qt_metacast(const char *_clname)
{
    if (!_clname) return Q_NULLPTR;
    if (!strcmp(_clname, qt_meta_stringdata_Dialog.stringdata0))
        return static_cast<void*>(const_cast< Dialog*>(this));
    return QDialog::qt_metacast(_clname);
}

int Dialog::qt_metacall(QMetaObject::Call _c, int _id, void **_a)
{
    _id = QDialog::qt_metacall(_c, _id, _a);
    if (_id < 0)
        return _id;
    if (_c == QMetaObject::InvokeMetaMethod) {
        if (_id < 4)
            qt_static_metacall(this, _c, _id, _a);
        _id -= 4;
    } else if (_c == QMetaObject::RegisterMethodArgumentMetaType) {
        if (_id < 4)
            *reinterpret_cast<int*>(_a[0]) = -1;
        _id -= 4;
    }
    return _id;
}

// SIGNAL 0
void Dialog::OkBtnclicked()
{
    QMetaObject::activate(this, &staticMetaObject, 0, Q_NULLPTR);
}

// SIGNAL 1
void Dialog::CancelBtnclicked()
{
    QMetaObject::activate(this, &staticMetaObject, 1, Q_NULLPTR);
}
QT_END_MOC_NAMESPACE

参考文档 ：https://blog.csdn.net/Albert_weiku/article/details/132017908