File: thread_executor.hpp

package info (click to toggle)
python-pyclustering 0.10.1.2-2
  • links: PTS, VCS
  • area: main
  • in suites: bookworm, forky, sid, trixie
  • size: 11,128 kB
  • sloc: cpp: 38,888; python: 24,311; sh: 384; makefile: 105
file content (114 lines) | stat: -rwxr-xr-x 2,264 bytes parent folder | download | duplicates (2)
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
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
/*!

@authors Andrei Novikov (pyclustering@yandex.ru)
@date 2014-2020
@copyright BSD-3-Clause

*/


#pragma once


#include <condition_variable>
#include <thread>

#include <pyclustering/parallel/task.hpp>


namespace pyclustering {

namespace parallel {


/*!

@class      thread_executor thread_executor.hpp pyclustering/parallel/thread_executor.hpp

@brief      Task executor for the thread pool.
@details    Task executor is responsible for executing task in separate thread and for notification the thread pool about task readiness.

@see thread_pool

*/
class thread_executor {
public:
    /*!
    
    @brief  Defines function to get next task for execution from the thread pool.
    @details The signature of the getter function should have following signature void(task::ptr &)`.
    
    */
    using task_getter   = std::function<void(task::ptr &)>;

    /*!

    @brief  Defines shared pointer of the thread executor.

    */
    using ptr           = std::shared_ptr<thread_executor>;

private:
    bool                    m_stop            = true;
    task_getter             m_getter          = nullptr;
    std::thread             m_executor;

public:
    /*!

    @brief  Default constructor of the thread executor.

    */
    thread_executor() = default;

    /*!

    @brief  Constructor of the thread executor with the task getting function.

    @param[in] p_getter: function with signatire `void(task::ptr &)` that is used to get next task to execute.

    */
    explicit thread_executor(const task_getter & p_getter);

    /*!

    @brief  Default copy constructor of the thread executor.

    */
    thread_executor(const thread_executor & p_other) = delete;

    /*!

    @brief  Default move constructor of the thread executor.

    */
    thread_executor(thread_executor && p_other) = delete;

    /*!

    @brief  Default destructor of the thread executor.

    */
    ~thread_executor() = default;

public:
    /*!

    @brief  Terminates thread executor: stops current task and join thread of the executor.

    */
    void stop();

private:
    /*!

    @brief  Run thread executor.

    */
    void run();
};


}

}