OpenCPN Partial API docs
Loading...
Searching...
No Matches
thread_ctrl.h
Go to the documentation of this file.
1/***************************************************************************
2 * Copyright (C) 2024 Alec Leamas *
3 * *
4 * This program is free software; you can redistribute it and/or modify *
5 * it under the terms of the GNU General Public License as published by *
6 * the Free Software Foundation; either version 2 of the License, or *
7 * (at your option) any later version. *
8 * *
9 * This program is distributed in the hope that it will be useful, *
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of *
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
12 * GNU General Public License for more details. *
13 * *
14 * You should have received a copy of the GNU General Public License *
15 * along with this program; if not, write to the *
16 * Free Software Foundation, Inc., *
17 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. *
18 **************************************************************************/
19
25#ifndef THREAD_CTRL_H__
26#define THREAD_CTRL_H__
27
28#include <condition_variable>
29#include <mutex>
30
33public:
34 ThreadCtrl() : m_keep_going(1) {}
35
37 bool IsRunning() const { return KeepGoing(); }
38
40 virtual void RequestStop();
41
43 void WaitUntilStopped();
44
49 bool WaitUntilStopped(std::chrono::duration<int> timeout);
50
57 bool WaitUntilStopped(std::chrono::duration<int> timeout,
58 std::chrono::milliseconds& elapsed);
59
60protected:
62 bool KeepGoing() const;
63
65 void SignalExit();
66
67private:
68 mutable std::mutex m_mutex;
69 std::condition_variable m_cv;
70 int m_keep_going;
71};
72
73#endif // THREAD_CTRL_H__
Thread mixin providing a "stop thread"/"wait until stopped" interface.
Definition thread_ctrl.h:32
void WaitUntilStopped()
Block until thread invokes SignalExit().
bool IsRunning() const
Return true if thread is running.
Definition thread_ctrl.h:37
void SignalExit()
Signal that thread has exited.
bool KeepGoing() const
If true continue thread operation, else exit and invoke SignalExit()
virtual void RequestStop()
Request that thread stops operation.