深入理解Qt——事件循环

本文将对如下问题进行释疑：

为何Qt应用要在main()函数中以QCoreApplication app(argc, argv)开始，并以return app.exec()结束？
同为循环，为何while(true)会导致CPU满载？而Qt的事件循环不会。
为何通过QEventLoop::exec()阻塞程序执行，可以避免程序卡死？
QCoreApplication::postEvent()与QCoreApplication::sendEvent()为何会有不阻塞和阻塞的差别？
QCoreApplication::processEvents()与QCoreApplication::sendPostedEvents()有何差别？

主事件循环

通常情况下，Qt应用程序的main()函数都会近似以下形式：

int main(int argc, char *argv[])
    QCoreApplication app(argc, argv);
    return app.exec();
}

在QCoreApplication app(argc, argv)这一步，主要是创建并初始化了一个QCoreApplication对象。最主要的是设置一些线程相关的数据（QThreadData），比如事件调度器（QAbstractEventDispatcher）等。
而app.exec()则是为了启动一个事件循环来分发事件。如果没有事件循环或事件循环没有启动，则对象永远不会接收到事件。
由QCoreApplication启动的事件循环也叫作主事件循环。

在省略掉大部分代码后，我们可以清晰地看到QCoreApplication::exec()如何启动一个事件循环：

int QCoreApplication::exec()
    QEventLoop eventLoop;
    int returnCode = eventLoop.exec();
    return returnCode;
}

事件循环

如下代码可见QEventLoop::exec()是通过循环不断地调用QEventLoop::processEvents()来分发事件队列中的事件。

int QEventLoop::exec(ProcessEventsFlags flags = AllEvents))
    Q_D(QEventLoop);
    while (!d->exit.loadAcquire())
        processEvents(flags | WaitForMoreEvents | EventLoopExec);
    return d->returnCode.load();
}

而最终完成事件分发的是事件调度器。通过下面的代码我们可以看出，事件调度器存在于各自线程相关数据中。也就是说每个线程都可以有、并且只使用自己专属的事件调度器。

bool QEventLoop::processEvents(ProcessEventsFlags flags)
    Q_D(QEventLoop);
    if (!d->threadData->hasEventDispatcher())
        return false;
    return d->threadData->eventDispatcher.load()->processEvents(flags);
}

到这里我们已经能够看出，为何在通过QEventLoop::exec()阻塞程序执行，程序却不会卡死了。因为QEventLoop::exec()开启了一个新的事件循环来分发事件，而且相同线程上的所有事件循环采用同一个事件调度器。

事件调度器

事件调度器就比较依赖于各个平台的实现了，各平台上的事件调度器实现都不尽相同。我们以QEventDispatcherUNIX为例进行分析。

bool QEventDispatcherUNIX::processEvents(QEventLoop::ProcessEventsFlags flags)
    Q_D(QEventDispatcherUNIX);
    QCoreApplicationPrivate::sendPostedEvents(0, 0, d->threadData);
    timespec *tm = nullptr;
    d->pollfds.append(d->threadPipe.prepare());
    int nevents = 0;
    switch (qt_safe_poll(d->pollfds.data(), d->pollfds.size(), tm)) {
    return (nevents > 0);
void QCoreApplicationPrivate::sendPostedEvents(QObject *receiver, int event_type,
                                               QThreadData *data)
    while (i < data->postEventList.size()) {
        const QPostEvent &pe = data->postEventList.at(i);
        QEvent *e = pe.event;
        QObject * r = pe.receiver;
        QCoreApplication::sendEvent(r, e);
}

QCoreApplicationPrivate::sendPostedEvents(0, 0, d->threadData)会派发当前线程事件队列中所有的事件。那么当事件分发完毕后是否就立即进入下一个事件队列派发周期了呢？
事实并非如此。在QEventDispatcherUNIX中，其成员d（QEventDispatcherUNIXPrivate）的成员threadPipe（QThreadPipe）通过eventfd()系统调用获取了一个文件描述符，并在QEventDispatcherUNIX::processEvents()中通过qt_safe_poll()等待其数据可读（POLLIN）。在此过程中，线程进入内核态等待事件发生（反正poll()调用怎么实现的咱也不知道，总之它就是不(那么)占CPU资源），自然不会占用CPU资源。
实际上qt_safe_poll()还监控了通过QSocketNotifier等监控的文件描述符的状态。当这些文件描述符指定的事件发生时，也会退出内核态进入下一次事件循环。

清空事件队列

通过上面的分析并综合下述代码，我们知道QCoreApplication::sendPostedEvents()会清空事件队列并立即返回。

void QCoreApplication::sendPostedEvents(QObject *receiver, int event_type)
    QThreadData *data = QThreadData::current();
    QCoreApplicationPrivate::sendPostedEvents(receiver, event_type, data);
}

而QCoreApplication::processEvents()相较于QCoreApplication::sendPostedEvents()相当于多了等待事件发生这一步。也就是说它在清空事件队列后不会立即返回。

void QCoreApplication::processEvents(QEventLoop::ProcessEventsFlags flags)
    QThreadData *data = QThreadData::current();
    if (!data->hasEventDispatcher())
        return;
    data->eventDispatcher.load()->processEvents(flags);
}

投递事件

上面说到，QEventDispatcherUNIX::processEvents()会等待事件发生，从而退出内核态进入下一次事件循环。如下所示：

void QCoreApplication::postEvent(QObject *receiver, QEvent *event, int priority)
    QThreadData * volatile * pdata = &receiver->d_func()->threadData;
    QThreadData *data = *pdata;
    data->postEventList.addEvent(QPostEvent(receiver, event, priority));
    QAbstractEventDispatcher* dispatcher = data->eventDispatcher.loadAcquire();
    if (dispatcher)
        dispatcher->wakeUp();
}

当通过QCoreApplication::postEvent()投递一个事件的时候，会将其加入到事件队列中，并唤醒事件调度器。具体来说，是向eventfd()系统调用获取的文件描述符写入数据，使其状态为数据可读（POLLIN）。

void QEventDispatcherUNIX::wakeUp()
    Q_D(QEventDispatcherUNIX);
    d->threadPipe.wakeUp();
void QThreadPipe::wakeUp()
    if (wakeUps.testAndSetAcquire(0, 1)) {
#ifndef QT_NO_EVENTFD
        if (fds[1] == -1) {
            // eventfd
            eventfd_t value = 1;
            int ret;
            EINTR_LOOP(ret, eventfd_write(fds[0], value));
            return;
#endif
        char c = 0;
        qt_safe_write(fds[1], &c, 1);
}

发送事件

网上大多数教程把postEvent()、sendEvent()都叫发送事件，并分出了不阻塞和阻塞两种差别。事实上postEvent()、sendEvent()是Qt事件循环中两个不同的阶段。如果简化掉一切中间流程，可以认为QCoreApplication::sendEvent()是在直接调用接受者的QObject::event()方法（QGuiApplication及QApplication实现不尽相同）。

inline bool QCoreApplication::sendEvent(QObject *receiver, QEvent *event)
    if (event)
        event->spont = false;
    return notifyInternal2(receiver, event);
bool QCoreApplication::notifyInternal2(QObject *receiver, QEvent *event)
    bool selfRequired = QCoreApplicationPrivate::threadRequiresCoreApplication();
    if (!selfRequired)
        return doNotify(receiver, event);
    return self->notify(receiver, event);
bool QCoreApplication::notify(QObject *receiver, QEvent *event)
    return doNotify(receiver, event);
static bool doNotify(QObject *receiver, QEvent *event)
    return receiver->isWidgetType() ? false : QCoreApplicationPrivate::notify_helper(receiver, event);