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
39 virtual ~ThreadCtrl() = default;
40
42 bool IsRunning() const { return KeepGoing(); }
43
45 virtual void RequestStop();
46
48 void WaitUntilStopped();
49
54 bool WaitUntilStopped(std::chrono::duration<int> timeout);
55
62 bool WaitUntilStopped(std::chrono::duration<int> timeout,
63 std::chrono::milliseconds& elapsed);
64
65protected:
67 bool KeepGoing() const;
68
70 void SignalExit();
71
72private:
73 mutable std::mutex m_mutex;
74 std::condition_variable m_cv;
75 int m_keep_going;
76};
77
78#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:42
void SignalExit()
Signal that thread has exited.
virtual ~ThreadCtrl()=default
Destroy the Thread Ctrl object.
bool KeepGoing() const
If true continue thread operation, else exit and invoke SignalExit()
virtual void RequestStop()
Request that thread stops operation.