summaryrefslogtreecommitdiffstats
path: root/tests/auto/shared/waitforsignal.h
blob: 9b2daf7af03c5033df955227517de5773927c5f7 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
/****************************************************************************
**
** Copyright (C) 2017 The Qt Company Ltd.
** Contact: https://www.qt.io/licensing/
**
** This file is part of the QtWebEngine module of the Qt Toolkit.
**
** $QT_BEGIN_LICENSE:GPL-EXCEPT$
** Commercial License Usage
** Licensees holding valid commercial Qt licenses may use this file in
** accordance with the commercial license agreement provided with the
** Software or, alternatively, in accordance with the terms contained in
** a written agreement between you and The Qt Company. For licensing terms
** and conditions see https://www.qt.io/terms-conditions. For further
** information use the contact form at https://www.qt.io/contact-us.
**
** GNU General Public License Usage
** Alternatively, this file may be used under the terms of the GNU
** General Public License version 3 as published by the Free Software
** Foundation with exceptions as appearing in the file LICENSE.GPL3-EXCEPT
** included in the packaging of this file. Please review the following
** information to ensure the GNU General Public License requirements will
** be met: https://www.gnu.org/licenses/gpl-3.0.html.
**
** $QT_END_LICENSE$
**
****************************************************************************/
#ifndef WAITFORSIGNAL_H
#define WAITFORSIGNAL_H

#include <QObject>
#include <QTestEventLoop>

#include <utility>

// Implementation details of waitForSignal.
namespace {
    // Wraps a functor to set a flag and exit from event loop if called.
    template <class SignalHandler>
    struct waitForSignal_SignalHandlerWrapper {
        waitForSignal_SignalHandlerWrapper(SignalHandler &&sh)
            : signalHandler(std::forward<SignalHandler>(sh)) {}

        template <class... Args>
        void operator()(Args && ... args) {
            signalHandler(std::forward<Args>(args)...);
            hasBeenCalled = true;
            loop.exitLoop();
        }

        SignalHandler &&signalHandler;
        QTestEventLoop loop;
        bool hasBeenCalled = false;
    };

    // No-op functor.
    struct waitForSignal_DefaultSignalHandler {
        template <class... Args>
        void operator()(Args && ...) {}
    };
} // namespace

// Wait for a signal to be emitted.
//
// The given functor is called with the signal arguments allowing the arguments
// to be modified before returning from the signal handler (unlike QSignalSpy).
template <class Sender, class Signal, class SignalHandler>
bool waitForSignal(Sender &&sender, Signal &&signal, SignalHandler &&signalHandler, int timeout = 15000)
{
    waitForSignal_SignalHandlerWrapper<SignalHandler> signalHandlerWrapper(
        std::forward<SignalHandler>(signalHandler));
    auto connection = QObject::connect(
        std::forward<Sender>(sender),
        std::forward<Signal>(signal),
        std::ref(signalHandlerWrapper));
    signalHandlerWrapper.loop.enterLoopMSecs(timeout);
    QObject::disconnect(connection);
    return signalHandlerWrapper.hasBeenCalled;
}

template <class Sender, class Signal>
bool waitForSignal(Sender &&sender, Signal &&signal, int timeout = 15000)
{
    return waitForSignal(std::forward<Sender>(sender),
                         std::forward<Signal>(signal),
                         waitForSignal_DefaultSignalHandler(),
                         timeout);
}

#endif // !WAITFORSIGNAL_H