PTLib
Version 2.14.3
|
Define some templates to simplify the declaration of simple PThread
descendants with one or two paramaters.
More...
#include <thread.h>
Public Types | |
typedef void(* | FnType )() |
![]() | |
enum | Priority { LowestPriority, LowPriority, NormalPriority, HighPriority, HighestPriority, NumPriorities } |
Codes for thread priorities. More... | |
enum | AutoDeleteFlag { AutoDeleteThread, NoAutoDeleteThread } |
Codes for thread autodelete flag. More... | |
Public Member Functions | |
PThreadMain (FnType function, bool autoDel=false) | |
virtual void | Main () |
User override function for the main execution routine of the thread. More... | |
![]() | |
bool | IsAutoDelete () const |
int | PXBlockOnChildTerminate (int pid, const PTimeInterval &timeout) |
int | PXBlockOnIO (int handle, int type, const PTimeInterval &timeout) |
void | PXAbortBlock () const |
void | PrintOn (ostream &strm) const |
Standard stream print function. More... | |
PThread (PINDEX stack, AutoDeleteFlag deletion=AutoDeleteThread, Priority priorityLevel=NormalPriority, const PString &threadName=PString::Empty()) | |
Create a new thread instance. More... | |
~PThread () | |
Destroy the thread, this simply calls the Terminate() function with all its restrictions and penalties. More... | |
virtual void | Restart () |
Restart a terminated thread using the same stack priority etc that was current when the thread terminated. More... | |
virtual void | Terminate () |
Terminate the thread. More... | |
virtual PBoolean | IsTerminated () const |
Determine if the thread has been terminated or ran to completion. More... | |
void | WaitForTermination () const |
Block and wait for the thread to terminate. More... | |
PBoolean | WaitForTermination (const PTimeInterval &maxWait) const |
Block and wait for the thread to terminate. More... | |
virtual void | Suspend (PBoolean susp=true) |
Suspend or resume the thread. More... | |
virtual void | Resume () |
Resume thread execution, this is identical to Suspend(false) . More... | |
virtual PBoolean | IsSuspended () const |
Determine if the thread is currently suspended. More... | |
virtual void | SetPriority (Priority priorityLevel) |
Set the priority of the thread relative to other threads in the current process. More... | |
virtual Priority | GetPriority () const |
Get the current priority of the thread in the current process. More... | |
virtual void | SetAutoDelete (AutoDeleteFlag deletion=AutoDeleteThread) |
Set the flag indicating thread object is to be automatically deleted when the thread ends. More... | |
void | SetNoAutoDelete () |
Reet the flag indicating thread object is to be automatically deleted when the thread ends. More... | |
virtual PString | GetThreadName () const |
Get the name of the thread. More... | |
virtual void | SetThreadName (const PString &name) |
Change the name of the thread. More... | |
virtual PThreadIdentifier | GetThreadId () const |
Get operating system specific thread identifier for this thread. More... | |
bool | GetTimes (Times ×) |
Get the thread execution times. More... | |
![]() | |
unsigned | GetTraceContextIdentifier () const |
Get PTRACE context identifier. More... | |
void | SetTraceContextIdentifier (unsigned id) |
void | GetTraceContextIdentifier (PObject &obj) |
void | GetTraceContextIdentifier (PObject *obj) |
void | SetTraceContextIdentifier (const PObject &obj) |
void | SetTraceContextIdentifier (const PObject *obj) |
virtual | ~PObject () |
virtual PObject * | Clone () const |
Create a copy of the class on the heap. More... | |
template<class CLS > | |
CLS * | CloneAs () const |
As for Clone() but converts to specified type. More... | |
virtual PINDEX | HashFunction () const |
This function yields a hash value required by the PDictionary class. More... | |
virtual const char * | GetClass (unsigned ancestor=0) const |
Get the current dynamic type of the object instance. More... | |
PBoolean | IsClass (const char *cls) const |
virtual PBoolean | InternalIsDescendant (const char *clsName) const |
Determine if the dynamic type of the current instance is a descendent of the specified class. More... | |
__inline const PObject * | PTraceObjectInstance () const |
virtual Comparison | Compare (const PObject &obj) const |
Compare the two objects and return their relative rank. More... | |
virtual Comparison | CompareObjectMemoryDirect (const PObject &obj) const |
Determine the byte wise comparison of two objects. More... | |
bool | operator== (const PObject &obj) const |
Compare the two objects. More... | |
bool | operator!= (const PObject &obj) const |
Compare the two objects. More... | |
bool | operator< (const PObject &obj) const |
Compare the two objects. More... | |
bool | operator> (const PObject &obj) const |
Compare the two objects. More... | |
bool | operator<= (const PObject &obj) const |
Compare the two objects. More... | |
bool | operator>= (const PObject &obj) const |
Compare the two objects. More... | |
virtual void | ReadFrom (istream &strm) |
Input the contents of the object from the stream. More... | |
Protected Attributes | |
FnType | m_function |
![]() | |
enum PThread::Type | m_type |
PINDEX | m_originalStackSize |
PString | m_threadName |
PMutex | m_threadNameMutex |
PThreadIdentifier | m_threadId |
LocalStorageList | m_localStorage |
![]() | |
unsigned | m_traceContextIdentifier |
Additional Inherited Members | |
![]() | |
static void | Sleep (const PTimeInterval &delay) |
Suspend the current thread for the specified amount of time. More... | |
static PThreadIdentifier | GetCurrentThreadId () |
static PThread * | Current () |
Get the currently running thread object instance. More... | |
static void | Yield () |
Yield to another thread without blocking. More... | |
static PThread * | Create (const PNotifier ¬ifier, INT parameter=0, AutoDeleteFlag deletion=AutoDeleteThread, Priority priorityLevel=NormalPriority, const PString &threadName=PString::Empty(), PINDEX stackSize=0) |
Create a simple thread executing the specified notifier. More... | |
static PThread * | Create (const PNotifier ¬ifier, const PString &threadName) |
![]() | |
static const char * | Class () |
Get the name of the class as a C string. More... | |
static __inline const PObject * | PTraceObjectInstance (const char *) |
static __inline const PObject * | PTraceObjectInstance (const PObject *obj) |
static Comparison | InternalCompareObjectMemoryDirect (const PObject *obj1, const PObject *obj2, PINDEX size) |
Internal function caled from CompareObjectMemoryDirect() More... | |
![]() | |
enum | Type { e_IsAutoDelete, e_IsManualDelete, e_IsProcess, e_IsExternal } |
typedef std::list< const LocalStorageBase * > | LocalStorageList |
![]() | |
PObject () | |
Constructor for PObject, made protected so cannot ever create one on its own. More... | |
![]() |
Define some templates to simplify the declaration of simple PThread
descendants with one or two paramaters.
typedef void(* PThreadMain::FnType)() |
|
inline |
References PThread::Resume().
|
inlinevirtual |
User override function for the main execution routine of the thread.
A descendent class must provide the code that will be executed in the thread within this function.
Note that the correct way for a thread to terminate is to return from this function.
Implements PThread.
|
protected |