1 // 2 // Copyright (c) 2008-2017 the Urho3D project. 3 // 4 // Permission is hereby granted, free of charge, to any person obtaining a copy 5 // of this software and associated documentation files (the "Software"), to deal 6 // in the Software without restriction, including without limitation the rights 7 // to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 8 // copies of the Software, and to permit persons to whom the Software is 9 // furnished to do so, subject to the following conditions: 10 // 11 // The above copyright notice and this permission notice shall be included in 12 // all copies or substantial portions of the Software. 13 // 14 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 15 // IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 16 // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 17 // AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 18 // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 19 // OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN 20 // THE SOFTWARE. 21 // 22 23 #pragma once 24 25 #ifdef URHO3D_IS_BUILDING 26 #include "Urho3D.h" 27 #else 28 #include <Urho3D/Urho3D.h> 29 #endif 30 31 #ifndef _WIN32 32 #include <pthread.h> 33 typedef pthread_t ThreadID; 34 #else 35 typedef unsigned ThreadID; 36 #endif 37 38 namespace Urho3D 39 { 40 41 /// Operating system thread. 42 class URHO3D_API Thread 43 { 44 public: 45 /// Construct. Does not start the thread yet. 46 Thread(); 47 /// Destruct. If running, stop and wait for thread to finish. 48 virtual ~Thread(); 49 50 /// The function to run in the thread. 51 virtual void ThreadFunction() = 0; 52 53 /// Start running the thread. Return true if successful, or false if already running or if can not create the thread. 54 bool Run(); 55 /// Set the running flag to false and wait for the thread to finish. 56 void Stop(); 57 /// Set thread priority. The thread must have been started first. 58 void SetPriority(int priority); 59 60 /// Return whether thread exists. IsStarted()61 bool IsStarted() const { return handle_ != 0; } 62 63 /// Set the current thread as the main thread. 64 static void SetMainThread(); 65 /// Return the current thread's ID. 66 static ThreadID GetCurrentThreadID(); 67 /// Return whether is executing in the main thread. 68 static bool IsMainThread(); 69 70 protected: 71 /// Thread handle. 72 void* handle_; 73 /// Running flag. 74 volatile bool shouldRun_; 75 76 /// Main thread's thread ID. 77 static ThreadID mainThreadID; 78 }; 79 80 } 81